From 96270ced35df1db947c170b880b9249d4f8c7b40 Mon Sep 17 00:00:00 2001 From: Brummel Date: Sun, 10 May 2026 13:04:03 +0200 Subject: [PATCH] design-md-consolidation 4.1: fix Project-ecosystem stale agents/ path; expand Docs bullet to name roadmap.md + specs/ + plans/ --- docs/DESIGN.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/DESIGN.md b/docs/DESIGN.md index d54c5d3..e0feabe 100644 --- a/docs/DESIGN.md +++ b/docs/DESIGN.md @@ -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//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.