Commit 0b35896d4d0d0469ead57bccd3d74cdd2ab4b3b3
1 parent
07a0a27e
graphlemon: auto-commit uncommitted changes for 1f278c16-76a4-4d05-be48-89548a22…
…85fa-main-checkout-drift
Showing
1 changed file
with
24 additions
and
3 deletions
CLAUDE.md
| @@ -60,7 +60,7 @@ both (deliberately: `supervisor/` was added later as PH5 landed, see | @@ -60,7 +60,7 @@ both (deliberately: `supervisor/` was added later as PH5 landed, see | ||
| 60 | `development-plan.md`'s U-036 note): | 60 | `development-plan.md`'s U-036 note): |
| 61 | 61 | ||
| 62 | ```bash | 62 | ```bash |
| 63 | -# graphlemon's own backend/schema/agent-orchestration code (441 tests as of U-043) | 63 | +# graphlemon's own backend/schema/agent-orchestration code (560+ tests as of PH5) |
| 64 | python3 -m unittest discover -s src | 64 | python3 -m unittest discover -s src |
| 65 | 65 | ||
| 66 | # Deploy Supervisor + the isolate/diff/apply library it depends on | 66 | # Deploy Supervisor + the isolate/diff/apply library it depends on |
| @@ -154,11 +154,32 @@ directly; anything worth reusing has already been copied and adapted into this r | @@ -154,11 +154,32 @@ directly; anything worth reusing has already been copied and adapted into this r | ||
| 154 | 154 | ||
| 155 | ## Repo layout | 155 | ## Repo layout |
| 156 | 156 | ||
| 157 | -- `docs/` — architecture doc, SDD (`docs/sdd/`), development plan, self-hosting design docs. See | ||
| 158 | - Status above for how stale the plan/unit-matrix "done" framing is relative to the real code. | 157 | +- `docs/` — architecture doc (`graphlemon_architecture.md`), SDD (`docs/sdd/`, authoritative), |
| 158 | + development plan, and gap-analysis all live at the top level as living/actively-read documents | ||
| 159 | + (see Status above for how stale the plan/unit-matrix "done" framing is relative to the real | ||
| 160 | + code). Point-in-time material is split into three subdirectories by role, not chronology: | ||
| 161 | + `docs/done/` (design/decision docs whose conclusions have been fully absorbed into the SDD — | ||
| 162 | + e.g. the Deploy Supervisor design chain — kept for the reasoning trail, not because they're | ||
| 163 | + still authoritative), `docs/todo/` (requirements/design docs for work not yet implemented — | ||
| 164 | + BRD/PRD-level requirements docs and, once confirmed, SDD-level design docs, same two-stage | ||
| 165 | + split the Planner itself uses), `docs/reference/` (external source material — articles, course | ||
| 166 | + notes — plus graphlemon's own "how does this compare to our architecture" notes on each one). | ||
| 167 | + When adding a new doc, pick by role (has its conclusion shipped into the SDD? → done; still | ||
| 168 | + pending confirmation/implementation? → todo; is it someone else's writing you're archiving? → | ||
| 169 | + reference), not by putting everything loose in `docs/`. | ||
| 159 | - `docs/wireframes/` — static no-build HTML prototypes for the PH3 console views (`v_*.html`), | 170 | - `docs/wireframes/` — static no-build HTML prototypes for the PH3 console views (`v_*.html`), |
| 160 | referenced per-page from `docs/sdd/02-V-界面与交互.md` §2.1-2.13; DOM/class names map 1:1 to | 171 | referenced per-page from `docs/sdd/02-V-界面与交互.md` §2.1-2.13; DOM/class names map 1:1 to |
| 161 | that doc's field lists. | 172 | that doc's field lists. |
| 173 | +- `skills/` — the Skill library (architecture doc §7.3): one directory per skill | ||
| 174 | + (`skills/<name>/SKILL.md` + optional `references/`), migrated/adapted from the Hermes profiles | ||
| 175 | + (§9's role mapping) and referenced by name from each Org Agent's `.claude/agents/*.md` | ||
| 176 | + `skills:` frontmatter list (`src/agent_profile.py::FRONTMATTER`, the canonical source of that | ||
| 177 | + list — edit it there, not by hand-editing the deployed `.claude/agents/*.md`). | ||
| 178 | +- `.claude/workflows/` — auto-generated, not hand-authored: real Dynamic Workflow scripts written | ||
| 179 | + by `src/work_graph_execute.py::write_workflow_script()`/`src/work_graph_orchestrate.py` (one | ||
| 180 | + script per Work Node execution) and by `e2e_pipeline.py`'s PRD-consistency check. Version- | ||
| 181 | + controlled because it's inside the target repo (self-target case: this repo), but treat the | ||
| 182 | + contents as execution artifacts, not source you maintain by hand. | ||
| 162 | - `src/` — graphlemon's own backend: `schema.py` (17-table SQLite schema — the original 01-M 15 | 183 | - `src/` — graphlemon's own backend: `schema.py` (17-table SQLite schema — the original 01-M 15 |
| 163 | entities plus PH5's `deployment`/`deploy_health_signal`), `backend_server.py` (stdlib | 184 | entities plus PH5's `deployment`/`deploy_health_signal`), `backend_server.py` (stdlib |
| 164 | `http.server` HTTP API + WebSocket-ish log/event streaming, no third-party deps), the Org Graph | 185 | `http.server` HTTP API + WebSocket-ish log/event streaming, no third-party deps), the Org Graph |