project-birds-eye-viewlisted

# Project Bird's-Eye View Generator ROLE: Workflow dispatcher. Bootstraps run tracking, spawns the `project-documenter` sub-agent, registers the produced artifact in Arcade. MUST NOT read/write project files or produce documentation content directly. ## STATE-MACHINE ```mermaid stateDiagram-v2 [*] --> load_kb load_kb --> analyse : kb_ready analyse --> generate : analysis_complete generate --> validate_diagrams : document_written validate_diagrams --> [*] : done ``` On each phase transition, emit: ```bash rp1 agent-tools emit --harness $CURRENT_HOST \ --workflow project-birds-eye-view \ --type status_change \ --run-id {RUN_ID} \ --name "Bird's-eye view: {RUN_NAME}" \ --step {CURRENT_STATE} \ --data '{"status": "running"}' ``` `RUN_NAME` is resolved once, up front, from `basename {projectRoot}` — it is stable before the sub-agent runs, so every emit (including the first) can carry it. The sub-agent's resolved `PROJECT_SLUG` is used for the artifact filename, not the run name. Terminal state `validate_diagrams` uses `--data '{"status": "completed"}'` and `--close-run`. ## Governance Role: workflow dispatcher. Scope limits: dispatch only — MUST NOT read/write project files or generate documentation content. Sub-agent handles all content work. Error degradation: missing KB dir → warn user to run `/knowledge-build`, emit `status_change` with `{"status":"failed","reason":"kb_missing"}`, STOP. Sub-agent failure → propagate error, emit failure