design-md-consolidation 4.1: fix Project-ecosystem stale agents/ path; expand Docs bullet to name roadmap.md + specs/ + plans/

This commit is contained in:
2026-05-10 13:04:03 +02:00
parent 9185014022
commit 96270ced35
+10 -4
View File
@@ -39,10 +39,16 @@ evolving in lockstep with the language:
`merge-prose`, etc., preferably with `--json` for machine consumption.
- **Examples** (`examples/`): canonical `.ail.json` programs. They are
specification anchors, not demos — the E2E suite hangs off them.
- **Agents** (`agents/`): specialised sub-prompts (implementer,
architect, tester, debugger) that form the project's own LLM tooling.
They are a versioned part of the repo. See `agents/README.md`.
- **Docs** (`docs/`): DESIGN.md (what and why), JOURNAL.md (history).
- **Skills** (`skills/`): specialised disciplines
(`brainstorm`, `plan`, `implement`, `audit`, `debug`,
`fieldtest`) plus the agent rosters they dispatch
(`skills/<name>/agents/`). They form the project's own
development methodology and are versioned with the codebase.
See `skills/README.md`.
- **Docs** (`docs/`): `DESIGN.md` (canonical state),
`JOURNAL.md` (chronological decisions log),
`roadmap.md` (forward queue), `specs/` (per-milestone design
specs), `plans/` (per-iteration implementation plans).
- **Tests**: unit tests per crate plus E2E in `crates/ail/tests/e2e.rs`. Every
new compiler path needs a test, otherwise the feature does not count as done.