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:
Godopu committed 2026-09-08 08:02:37 +09:00
1 parent 07cae71667
commit f98b9582c7
13 files changed
+450 -112

No files matched your search

+21 -5
View File
@@ -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
```
---