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) <noreply@anthropic.com>
This commit is contained in:
+1
-1
@@ -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).
|
||||
|
||||
|
||||
+2
-2
@@ -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
|
||||
|
||||
@@ -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. |
|
||||
|
||||
@@ -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]
|
||||
|
||||
Reference in New Issue
Block a user