Restructure and update design specs; add messaging update proposal and index file

Author: coordt

README.md

@@ -62,7 +62,7 @@ Foreman uses a YAML configuration file to define repositories, agents, and LLM b
     ```
 
 For detailed configuration options, see [config.example.yaml](config.example.yaml)
-and the [Project Specification](docs/specs/initial/SPEC.md).
+and the [Project Specification](docs/specs/01-agent-harness/SPEC.md).
 
 ## Project Structure
 

docs/specs/initial/SPEC.md docs/specs/01-agent-harness/SPEC.mddocs/specs/initial/SPEC.md renamed to docs/specs/01-agent-harness/SPEC.md

@@ -0,0 +1,6 @@
+# Messaging update
+
+## Problem Statement
+
+The current wire protocol doesn't handle the case where a message is sent to a node that is not connected.
+This leads to missed events with no way to recover.

docs/specs/initial/agent-harness.md docs/specs/01-agent-harness/idea.mddocs/specs/initial/agent-harness.md renamed to docs/specs/01-agent-harness/idea.md

@@ -0,0 +1,25 @@
+# Design Specifications
+
+This directory contains design specifications and architectural proposals for the Foreman project.
+
+## Table of Contents
+
+### [01-agent-harness](./01-agent-harness/SPEC.md)
+
+The core specification for the Foreman project.
+
+- **Objective**: Build a minimal Python harness for always-on AI co-maintainers that handles process lifecycle,
+    credential injection, and message routing.
+- **Key Documents**:
+    - [Specification](./01-agent-harness/SPEC.md): Technical details and requirements.
+    - [Idea](./01-agent-harness/idea.md): Problem statement and recommended direction.
+    - [Plan](./01-agent-harness/plan.md): Implementation roadmap.
+    - [Todo](./01-agent-harness/todo.md): Tracked tasks.
+
+### [02-messaging-update](./02-messaging-update/idea.md)
+
+A proposal for improving the messaging system.
+
+- **Objective**: Address the issue where messages sent to disconnected nodes are lost.
+- **Key Documents**:
+    - [Idea](./02-messaging-update/idea.md): Problem statement regarding the wire protocol and recovery mechanisms.