From e90c1cbf2acb92d4db88f30f925a01986f5cf065 Mon Sep 17 00:00:00 2001 From: Brummel Date: Mon, 1 Jun 2026 13:46:03 +0200 Subject: [PATCH] docs: default design_ledger path to docs/design/INDEX.md Align the design_ledger profile-slot default and its illustrative references with the docs/ layout used by the other path slots. Historical specs/plans are left untouched as cycle records. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/design.md | 2 +- docs/migration.md | 4 ++-- docs/profile-schema.md | 2 +- templates/project-profile.yml | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/design.md b/docs/design.md index c742fb8..0744398 100644 --- a/docs/design.md +++ b/docs/design.md @@ -12,7 +12,7 @@ in a per-project profile). The litmus test: would a sentence in a SKILL or agent body still make sense in a Python web project, a Rust CLI, and a TypeScript library? If yes, plugin. If it mentions `cargo`, -`crates/`, `design/INDEX.md`, `Form A`, or any project-specific +`crates/`, `docs/design/INDEX.md`, `Form A`, or any project-specific identifier, it goes to the profile (as a slot) or to the project's `CLAUDE.md` (as sittenkodex). diff --git a/docs/migration.md b/docs/migration.md index 3abded4..163103a 100644 --- a/docs/migration.md +++ b/docs/migration.md @@ -73,7 +73,7 @@ the structural binding. ## Migration checklist per skill 1. Strip project-specific paths (`docs/specs`, `docs/plans`, - `design/INDEX.md`, `crates/`, `bench/`). + `docs/design/INDEX.md`, `crates/`, `bench/`). 2. Strip project-specific commands (`cargo build`, `bench/check.py`). 3. Replace literals with profile-slot references in prose. @@ -91,7 +91,7 @@ the structural binding. 1. Drop the `ailang-` prefix from the `name:` frontmatter field. The skill path is the disambiguator. 2. Replace hardcoded standing-reading paths - (`design/INDEX.md`, etc.) with a reference to the profile's + (`docs/design/INDEX.md`, etc.) with a reference to the profile's `standing_reading` section. 3. Replace project-specific Iron Law clauses with the universal discipline constants; project-specific clauses go to the diff --git a/docs/profile-schema.md b/docs/profile-schema.md index 26797c3..34e40ae 100644 --- a/docs/profile-schema.md +++ b/docs/profile-schema.md @@ -12,7 +12,7 @@ lowercase snake_case. Lists are YAML sequences. | `spec_dir` | string | `docs/specs` | Where the brainstorm skill writes specs. | | `plan_dir` | string | `docs/plans` | Where the planner skill writes plans. | | `glossary` | string | (unset) | Canonical-nomenclature file (optional). If set, it is standing reading for every role — no separate `standing_reading.always` entry is needed; unset is a documented no-op. See `glossary-convention.md`. | -| `design_ledger` | string | `design/INDEX.md` | Canonical specification index (optional — projects without a design ledger can omit). | +| `design_ledger` | string | `docs/design/INDEX.md` | Canonical specification index (optional — projects without a design ledger can omit). | | `design_contracts` | string | `design/contracts` | Directory of prose-authoritative contracts (optional). | | `design_models` | string | `design/models` | Directory of onboarding whitepapers (optional). | | `code_roots` | list | `[src]` | Code directories the architect / quality reviewer walk. | diff --git a/templates/project-profile.yml b/templates/project-profile.yml index 38ad208..2b4f8ae 100644 --- a/templates/project-profile.yml +++ b/templates/project-profile.yml @@ -9,7 +9,7 @@ paths: plan_dir: docs/plans # glossary: docs/glossary.md # optional — if set, read as # standing reading by every role - # design_ledger: design/INDEX.md # optional + # design_ledger: docs/design/INDEX.md # optional # design_contracts: design/contracts # optional # design_models: design/models # optional code_roots: [src]