docs: clean up root markdown files and synchronize with v4.4.0 standards
- Relocate legacy implementation_plan.md to docs/contracts/nats-backplane/implementation_plan.md - Synchronize root documentation (README, README.ko, BOOTSTRAP, BOOTSTRAP.ko, AGENTS, MESSAGING, IMPROVEMENTS) to latest v4.4.0 standards - Consolidate IMPROVEMENTS.md to single source of truth (5 open / 31 completed tasks 1:1 matching section headers) - Archive unanimous PASS review reports from Claude, Grok, Codex, and OpenCode along with Plan Rev.2
This commit is contained in:
1 parent
07cae71667
commit
f98b9582c7
13 files changed
+450
-112
No files matched your search
@@ -45,12 +45,12 @@ All orchestration functionalities are structured under the `.agents/skills/` dir
|
||||
* **`multi-agent-mux-resume`**: Restores stopped sessions by resolving workspace UUIDs from disk or cache, and invokes the underlying agent using session-resume parameters (e.g., `claude -r <uuid>`, `agy --conversation <uuid>`, `hermes --resume <uuid>`, `grok --resume <uuid>`, `opencode --session <uuid>`, or `codex resume <uuid>`).
|
||||
* **`multi-agent-mux-status`**: Queries the running states of all active sessions, detecting PID mismatches, command signatures, and drifts between actual herdr instances and the registry database.
|
||||
* **`multi-agent-mux-monitor`**: A long-running reconcile worker that dynamically monitors herdr sessions and synchronizes states to `.mam/agent-sessions.yaml`.
|
||||
* **`multi-agent-mux-delegate-job`**: The core asynchronous task distribution module containing:
|
||||
* **`multi-agent-mux-delegate-job`**: The core asynchronous task distribution module (core implementation in `.agents/skills/lib_py/delegation/`; `scripts/*.py` serves as compatibility shims):
|
||||
* `registry.py`: Atomically registers and claims jobs using file advisory locks (`fcntl`).
|
||||
* `job_subscriber.py`: Connects to the MQTT backplane, captures live events, and appends them to audit trails.
|
||||
* `publish_event.py`: Emits execution status transitions and error details from workspace scripts.
|
||||
* `mqtt_common.py`: Manages connection policies, authentication, and HMAC signing.
|
||||
* **`multi-agent-mux-loop`**: Autonomous planning-execution-review orchestration loop across Planner, Creator, and Reviewers until unanimous consensus.
|
||||
* **`multi-agent-mux-loop`**: Autonomous planning-execution-review orchestration loop across Planner, Creator, and Reviewers until unanimous consensus (driven by Python loop runtime in `lib_py.loop`, eager-import immutable runtime, strict verdict parser).
|
||||
* **`multi-agent-mux-orc-onboard`**: Helper to register and isolate orchestrator session UUIDs to prevent sub-agent discovery capture.
|
||||
|
||||
---
|
||||
@@ -164,6 +164,10 @@ To ensure communication integrity across public MQTT brokers, the backplane inte
|
||||
│ ├── MULTI_AGENT_RULES.ko.md # Agent roles, snapshottings, and execution charter (Korean)
|
||||
│ └── skills/ # Core orchestration shell wrappers & libraries
|
||||
│ ├── lib.sh # Shared orchestration library
|
||||
│ ├── lib_py/ # Python core orchestration engine
|
||||
│ │ ├── agents/ # Multi-agent CLI lifecycle adapters
|
||||
│ │ ├── delegation/ # Asynchronous delegation & CAS state engine
|
||||
│ │ └── loop/ # Autonomous planning-execution-review loop runtime
|
||||
│ ├── multi-agent-mux-create/
|
||||
│ ├── multi-agent-mux-stop/
|
||||
│ ├── multi-agent-mux-resume/
|
||||
@@ -171,7 +175,7 @@ To ensure communication integrity across public MQTT brokers, the backplane inte
|
||||
│ ├── multi-agent-mux-monitor/
|
||||
│ ├── multi-agent-mux-delegate-job/
|
||||
│ │ ├── requirements.txt # Python dependency declaration
|
||||
│ │ └── scripts/ # Core backplane implementation (Python)
|
||||
│ │ └── scripts/ # Wire-compatibility shims (Python)
|
||||
│ ├── multi-agent-mux-loop/
|
||||
│ └── multi-agent-mux-orc-onboard/
|
||||
├── .mam/ # Multi-Agent Mux metadata (git-ignored)
|
||||
@@ -185,9 +189,21 @@ To ensure communication integrity across public MQTT brokers, the backplane inte
|
||||
│ ├── install.sh # Remote/Network installer script
|
||||
│ ├── update.sh # Updater script
|
||||
│ └── remove.sh # Uninstaller script
|
||||
├── docs/ # Specifications, guides, and architectural contracts
|
||||
│ ├── contracts/ # Issue/backplane contracts and migration roadmaps
|
||||
│ ├── MAM_WEB_PTY_BRIDGE_PLAN.md # Web PTY terminal bridge design plan
|
||||
│ ├── NEW_AGENT_INTEGRATION_GUIDE.md # Guide for integrating new AI coding agents
|
||||
│ └── OPENCODE_OLLAMA_GUIDE.md # OpenCode interpreter + Ollama integration guide
|
||||
├── nats-docker/ # Private NATS broker deployment submodule
|
||||
├── tests/ # Comprehensive test suite (32 modules)
|
||||
├── AGENTS.md # Behavioral guidelines and orchestrator scope guards
|
||||
├── BOOTSTRAP.ko.md # Installation and verification guide (Korean)
|
||||
├── BOOTSTRAP.md # Detailed installation and verification guide
|
||||
├── MESSAGING.md # MQTT wire protocol specification
|
||||
└── README.md # Project introduction and overview (this file)
|
||||
├── IMPROVEMENTS.md # Backlog tracking issues and completed architectural tasks
|
||||
├── MESSAGING.md # MQTT wire protocol specification and internals
|
||||
├── README.ko.md # Project introduction and overview (Korean)
|
||||
├── README.md # Project introduction and overview (this file)
|
||||
└── VERSIONS.md # Release notes and 4-way lockstep version ledger
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in new issue
Block a user