docs-cli 0.1.1__tar.gz → 1.3.0__tar.gz

docs_cli-1.3.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.egg-info/
+dist/
+build/
+.DS_Store

docs_cli-1.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 art@bitholdersinc.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

docs_cli-1.3.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: docs-cli
+Version: 1.3.0
+Summary: Prescriptive CLI for managing trees of structured Markdown docs.
+Project-URL: Homepage, https://github.com/ArtRichards/docs-cli
+Project-URL: Repository, https://github.com/ArtRichards/docs-cli
+Project-URL: Issues, https://github.com/ArtRichards/docs-cli/issues
+Author-email: Art Richards <art@bitholdersinc.com>
+License: MIT License
+        
+        Copyright (c) 2026 art@bitholdersinc.com
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: cli,documentation,markdown
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# docs-cli
+
+A prescriptive, lightweight CLI (`docs`) for managing trees of structured markdown documentation.
+
+Treats each Markdown file as a small, self-describing record. A short metadata block under the H1 captures the doc's status, role, and relationships; the `docs` CLI uses that metadata to derive an index, archive completed work, validate consistency, and answer queries — without forcing you to maintain cross-references by hand.
+
+## Why
+
+Documentation directories rot. Hand-maintained `INDEX.md` files drift from reality. Descriptions get duplicated and lose sync. Plans pile up alongside completed work with no clear lifecycle.
+
+`docs` makes each file self-describing and treats the index as a derived view. The doc itself is the source of truth; the index is generated.
+
+## Convention at a glance
+
+```markdown
+# Title
+
+Lifecycle: active
+Role: spec
+Project: docs
+Updated: 2026-05-23
+
+Related:
+- pairs-with: convention.md
+- implements: charter.md
+
+## …
+```
+
+- Plain `Label: value` lines under the H1; a bare-label list group (like `Related:`) may follow after a blank line.
+- `Lifecycle` and `Role` come from controlled vocabularies (extensible per-project, additive only).
+- `Related:` is followed by bullets in `<verb>: <path>` form.
+- No YAML frontmatter, no parser dependency, readable in any Markdown viewer.
+
+See [`docs/convention.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/convention.md) for the full spec.
+
+## Commands
+
+```
+docs new <role> <slug> [--project NAME] [--body-from PATH|-]
+                                          Scaffold a doc with the right metadata; --body-from writes the body atomically.
+docs index [DIR] [--exclude PATTERN]      Regenerate INDEX.md from metadata in DIR.
+docs archive <file> [--reason "…"]        Archive: edit Lifecycle, move to archive/<date>/, refresh index.
+docs mv <old> <new>                       Move + rewrite Related: references across the tree.
+docs list [filters] [--json] [--exclude PATTERN]
+                                          Query view of the tree.
+docs check [DIR] [--exclude PATTERN]      Validate metadata, refs, status/location drift.
+docs touch <file>                         Bump Updated: to today.
+docs migrate <dir> [--apply] [--summary] [--only ambiguous] [--exclude PATTERN]
+                                          Adopt a foreign Markdown directory into the convention (dry-run by default).
+docs install-skill [--dest DIR]           Materialise the bundled Claude Code skill onto this host.
+```
+
+See [`docs/cli.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/cli.md) for full surface and exit codes.
+
+## Install
+
+```sh
+pip install docs-cli                      # lands `docs` on PATH
+docs install-skill                        # materialise the bundled Claude Code skill at ~/.claude/skills/docs/
+```
+
+Requires Python 3.11+ (for stdlib `tomllib`). No third-party runtime dependencies.
+
+## Adopting an existing tree
+
+Have a directory of foreign Markdown specs? `docs install-skill` materialises a Claude Code skill that walks an agent through `docs migrate <dir>` → triage → `docs migrate --apply`. See [`docs/m8-adoption-workflow.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/m8-adoption-workflow.md) for the full agent-driveable workflow, the bundled [adoption playbook](https://github.com/ArtRichards/docs-cli/blob/main/src/docs_cli/skill/references/adoption-playbook.md) for the procedural deep-dive, or run `docs migrate <dir>` directly for a dry-run plan.
+
+For development:
+
+```sh
+git clone https://github.com/ArtRichards/docs-cli.git ~/opt/docs-cli
+cd ~/opt/docs-cli
+python3 -m venv .venv
+.venv/bin/pip install -e ".[dev]"
+.venv/bin/python -m pytest -q
+```
+
+## Status
+
+**v1 complete; M8 shipped locally as 1.3.0 (publish DEFERRED to M9 batched 1.3.0).** Milestone history:
+
+- M1 — Parser and `docs index` (shipped 2026-05-20)
+- M2 — Mutating verbs `new`, `archive`, `mv`, `touch` (shipped 2026-05-21)
+- M3 — Validation and query `check`, `list` (shipped 2026-05-22)
+- M4 — Migration helper `docs migrate` (shipped 2026-05-22)
+- M5 — Claude Code skill — drives the verbs automatically when an agent does documentation work in a `docs`-managed tree, with self-contained convention and CLI references bundled alongside (shipped 2026-05-22)
+- M6 — PyPI distribution preparation as `docs-cli`; relocates the CLI to a proper package at `src/docs_cli/`, ships the skill inside the wheel as package data, and adds `docs install-skill` for one-shot host materialisation (closed 2026-05-24 as preparation-only — no publish)
+- M7 — Migration accuracy: `Status:` → `Lifecycle:` controlled-vocab rename, broadened role inference (H1 / section-header / sibling-set / word-boundary / `_M\d+` / non-role-suffix strip), `medium` confidence level, project-name normalisation, per-file mtime archive dates, multi-project hints, `--config-project` override, `[migrate]`-only sidecar (closed 2026-05-25 as 1.2.0 locally; publish DEFERRED to M9)
+- M8 — Adoption workflow agent-driveable: tree-wide `--exclude` + `[exclude]` + `.docsignore`; migrate triage flags (`--summary`, `--only ambiguous`, `--group-by`); default plan footer summary; non-md sibling surfacing; `docs new --body-from` for one-call atomic doc authoring; substantial skill-reference rewrite (adoption playbook + `.docs.toml` template) (closed 2026-05-25 as 1.3.0 locally; publish DEFERRED to M9)
+
+**Publish strategy.** v1.1.0, v1.2.0, and v1.3.0 were never published to PyPI. M9 batches the post-M8 tree into the first PyPI release as 1.3.0 — one publish event covering M6 + M7 + M8 surface together (per operator OQ-C). The on-disk Markdown convention is otherwise stable; the M7 `Lifecycle:` rename is a one-time keyword change with no backward-compat alias.
+
+See [`docs/status.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/status.md) for per-milestone summaries and [`docs/plan.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/plan.md) for the v1.x backlog. The [CHANGELOG](https://github.com/ArtRichards/docs-cli/blob/main/CHANGELOG.md) tracks every release.
+
+## License
+
+MIT — see [LICENSE](https://github.com/ArtRichards/docs-cli/blob/main/LICENSE).

docs_cli-1.3.0/README.md

@@ -0,0 +1,98 @@
+# docs-cli
+
+A prescriptive, lightweight CLI (`docs`) for managing trees of structured markdown documentation.
+
+Treats each Markdown file as a small, self-describing record. A short metadata block under the H1 captures the doc's status, role, and relationships; the `docs` CLI uses that metadata to derive an index, archive completed work, validate consistency, and answer queries — without forcing you to maintain cross-references by hand.
+
+## Why
+
+Documentation directories rot. Hand-maintained `INDEX.md` files drift from reality. Descriptions get duplicated and lose sync. Plans pile up alongside completed work with no clear lifecycle.
+
+`docs` makes each file self-describing and treats the index as a derived view. The doc itself is the source of truth; the index is generated.
+
+## Convention at a glance
+
+```markdown
+# Title
+
+Lifecycle: active
+Role: spec
+Project: docs
+Updated: 2026-05-23
+
+Related:
+- pairs-with: convention.md
+- implements: charter.md
+
+## …
+```
+
+- Plain `Label: value` lines under the H1; a bare-label list group (like `Related:`) may follow after a blank line.
+- `Lifecycle` and `Role` come from controlled vocabularies (extensible per-project, additive only).
+- `Related:` is followed by bullets in `<verb>: <path>` form.
+- No YAML frontmatter, no parser dependency, readable in any Markdown viewer.
+
+See [`docs/convention.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/convention.md) for the full spec.
+
+## Commands
+
+```
+docs new <role> <slug> [--project NAME] [--body-from PATH|-]
+                                          Scaffold a doc with the right metadata; --body-from writes the body atomically.
+docs index [DIR] [--exclude PATTERN]      Regenerate INDEX.md from metadata in DIR.
+docs archive <file> [--reason "…"]        Archive: edit Lifecycle, move to archive/<date>/, refresh index.
+docs mv <old> <new>                       Move + rewrite Related: references across the tree.
+docs list [filters] [--json] [--exclude PATTERN]
+                                          Query view of the tree.
+docs check [DIR] [--exclude PATTERN]      Validate metadata, refs, status/location drift.
+docs touch <file>                         Bump Updated: to today.
+docs migrate <dir> [--apply] [--summary] [--only ambiguous] [--exclude PATTERN]
+                                          Adopt a foreign Markdown directory into the convention (dry-run by default).
+docs install-skill [--dest DIR]           Materialise the bundled Claude Code skill onto this host.
+```
+
+See [`docs/cli.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/cli.md) for full surface and exit codes.
+
+## Install
+
+```sh
+pip install docs-cli                      # lands `docs` on PATH
+docs install-skill                        # materialise the bundled Claude Code skill at ~/.claude/skills/docs/
+```
+
+Requires Python 3.11+ (for stdlib `tomllib`). No third-party runtime dependencies.
+
+## Adopting an existing tree
+
+Have a directory of foreign Markdown specs? `docs install-skill` materialises a Claude Code skill that walks an agent through `docs migrate <dir>` → triage → `docs migrate --apply`. See [`docs/m8-adoption-workflow.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/m8-adoption-workflow.md) for the full agent-driveable workflow, the bundled [adoption playbook](https://github.com/ArtRichards/docs-cli/blob/main/src/docs_cli/skill/references/adoption-playbook.md) for the procedural deep-dive, or run `docs migrate <dir>` directly for a dry-run plan.
+
+For development:
+
+```sh
+git clone https://github.com/ArtRichards/docs-cli.git ~/opt/docs-cli
+cd ~/opt/docs-cli
+python3 -m venv .venv
+.venv/bin/pip install -e ".[dev]"
+.venv/bin/python -m pytest -q
+```
+
+## Status
+
+**v1 complete; M8 shipped locally as 1.3.0 (publish DEFERRED to M9 batched 1.3.0).** Milestone history:
+
+- M1 — Parser and `docs index` (shipped 2026-05-20)
+- M2 — Mutating verbs `new`, `archive`, `mv`, `touch` (shipped 2026-05-21)
+- M3 — Validation and query `check`, `list` (shipped 2026-05-22)
+- M4 — Migration helper `docs migrate` (shipped 2026-05-22)
+- M5 — Claude Code skill — drives the verbs automatically when an agent does documentation work in a `docs`-managed tree, with self-contained convention and CLI references bundled alongside (shipped 2026-05-22)
+- M6 — PyPI distribution preparation as `docs-cli`; relocates the CLI to a proper package at `src/docs_cli/`, ships the skill inside the wheel as package data, and adds `docs install-skill` for one-shot host materialisation (closed 2026-05-24 as preparation-only — no publish)
+- M7 — Migration accuracy: `Status:` → `Lifecycle:` controlled-vocab rename, broadened role inference (H1 / section-header / sibling-set / word-boundary / `_M\d+` / non-role-suffix strip), `medium` confidence level, project-name normalisation, per-file mtime archive dates, multi-project hints, `--config-project` override, `[migrate]`-only sidecar (closed 2026-05-25 as 1.2.0 locally; publish DEFERRED to M9)
+- M8 — Adoption workflow agent-driveable: tree-wide `--exclude` + `[exclude]` + `.docsignore`; migrate triage flags (`--summary`, `--only ambiguous`, `--group-by`); default plan footer summary; non-md sibling surfacing; `docs new --body-from` for one-call atomic doc authoring; substantial skill-reference rewrite (adoption playbook + `.docs.toml` template) (closed 2026-05-25 as 1.3.0 locally; publish DEFERRED to M9)
+
+**Publish strategy.** v1.1.0, v1.2.0, and v1.3.0 were never published to PyPI. M9 batches the post-M8 tree into the first PyPI release as 1.3.0 — one publish event covering M6 + M7 + M8 surface together (per operator OQ-C). The on-disk Markdown convention is otherwise stable; the M7 `Lifecycle:` rename is a one-time keyword change with no backward-compat alias.
+
+See [`docs/status.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/status.md) for per-milestone summaries and [`docs/plan.md`](https://github.com/ArtRichards/docs-cli/blob/main/docs/plan.md) for the v1.x backlog. The [CHANGELOG](https://github.com/ArtRichards/docs-cli/blob/main/CHANGELOG.md) tracks every release.
+
+## License
+
+MIT — see [LICENSE](https://github.com/ArtRichards/docs-cli/blob/main/LICENSE).

docs_cli-1.3.0/docs/.docs.toml

@@ -0,0 +1,16 @@
+# Marks this directory as a docs root managed by `docs`.
+# Without this file, `docs` still runs but with conservative defaults.
+
+[project]
+name = "docs"
+
+[archive]
+dir = "archive"               # subdir name treated as archive subtree
+date_format = "%Y-%m-%d"
+
+[vocabulary]
+# Additions only. Built-in lifecycles and roles are always recognized.
+# add_lifecycles = ["shipped"]
+# add_roles      = ["adr"]
+add_lifecycles = []
+add_roles      = []

docs_cli-1.3.0/docs/INDEX.md

@@ -0,0 +1,71 @@
+# docs — Documentation
+
+This directory is the docs root for the `docs` CLI itself. We eat our own dog food: once the tool is built, running `docs index` here should reproduce the auto-generated section below.
+
+The hand-written preamble (this paragraph, and anything outside the marker block) is preserved by the tool. Only content between `<!-- docs:generated start -->` and `<!-- docs:generated end -->` is rewritten.
+
+<!-- docs:generated start -->
+_Generated 2026-05-25. 29 docs active, 0 archived._
+
+## Project — docs
+
+### Active — Status
+
+- [status.md](status.md) — _status_ — **This is the single source of truth for project progress. Update only this file when milestones complete or phases…. Updated 2026-05-25.
+
+### Active — Charter
+
+- [charter.md](charter.md) — _charter_ — A small, opinionated CLI (`docs`) that manages a tree of Markdown documentation by treating each file as a…. Updated 2026-05-24.
+
+### Active — Plan
+
+- [plan.md](plan.md) — _plan_ — Three milestones to v1, then a migration helper, then a Claude Code skill wrapper. v1.1 picks up with packaging, then…. Updated 2026-05-25.
+
+### Active — Spec
+
+- [cli.md](cli.md) — _spec_ — This spec defines the `docs` command-line surface: subcommands, flags, output formats, and exit codes. The on-disk…. Updated 2026-05-25.
+- [convention.md](convention.md) — _spec_ — This spec defines the on-disk convention that `docs` reads and writes. It is the portable, tool-independent part: any…. Updated 2026-05-25.
+
+### Active — Milestone
+
+- [m7-migration-accuracy.md](m7-migration-accuracy.md) — _milestone_ — - Milestone: M7 (v1.1) - Title: Migration plan accuracy - Surface: extensions to `docs migrate`'s inference…. Updated 2026-05-25.
+- [m8-adoption-workflow.md](m8-adoption-workflow.md) — _milestone_ — - Milestone: M8 (v1.1) - Title: Adoption workflow — agent-driveable - Surface: new CLI flags + verbs (`--exclude`,…. Updated 2026-05-25.
+- [m9-pypi-publish.md](m9-pypi-publish.md) — _milestone_ — > **Stub-drafted 2026-05-24, post M6 scope reframe.** M9 enters > active state once M8 ships. The operative checklist…. Updated 2026-05-25.
+- [m6-pypi-distribution.md](m6-pypi-distribution.md) — _milestone_ — > **Scope reframe 2026-05-24 (operator decision).** M6 is now > **preparation only** — the milestone delivered the…. Updated 2026-05-24.
+- [m5-claude-code-skill.md](m5-claude-code-skill.md) — _milestone_ — - Milestone: M5 - Title: Claude Code skill - Surface: a Claude Code **skill** — a `SKILL.md` artifact (plus, if needed,…. Updated 2026-05-23.
+- [m3-validation-and-query.md](m3-validation-and-query.md) — _milestone_ — - Milestone: M3 - Title: Validation and query (`check`, `list`) - Surface: two new read-only CLI subcommands on the…. Updated 2026-05-22.
+- [m4-migration-helper.md](m4-migration-helper.md) — _milestone_ — - Milestone: M4 - Title: Migration helper (`docs migrate`) - Surface: one new CLI subcommand on the `docs` executable…. Updated 2026-05-22.
+- [m2-mutating-verbs.md](m2-mutating-verbs.md) — _milestone_ — - Milestone: M2 - Title: Mutating verbs (`new`, `archive`, `mv`, `touch`) - Surface: four new CLI subcommands on the…. Updated 2026-05-21.
+- [m1-parser-and-index.md](m1-parser-and-index.md) — _milestone_ — - Milestone: M1 - Title: Parser and `docs index` - Surface: Python module `docs`, CLI subcommand `docs index` - Status:…. Updated 2026-05-20.
+
+### Active — Log
+
+- [m7-migration-accuracy-log.md](m7-migration-accuracy-log.md) — _log_ — - Project: docs - Milestone: M7 — Migration plan accuracy - Started: 2026-05-24 - Progress: **Phase 1 complete; Phase 2…. Updated 2026-05-25.
+- [m8-adoption-workflow-log.md](m8-adoption-workflow-log.md) — _log_ — - Project: docs - Milestone: M8 — Adoption workflow (agent-driveable) - Started: 2026-05-24 - Progress: **All 10 TDD…. Updated 2026-05-25.
+- [m9-pypi-publish-log.md](m9-pypi-publish-log.md) — _log_ — Per-phase log for M9. Entries get appended as the operator walks [release-runbook.md](release-runbook.md) post-M8.. Updated 2026-05-24.
+- [m5-claude-code-skill-log.md](m5-claude-code-skill-log.md) — _log_ — - Project: docs - Milestone: M5 — Claude Code skill - Started: 2026-05-22 - Progress: **M5 complete — shipped…. Updated 2026-05-23.
+- [m6-pypi-distribution-log.md](m6-pypi-distribution-log.md) — _log_ — - Project: docs - Milestone: M6 — PyPI distribution as `docs-cli` - Started: 2026-05-23 - Progress: **Milestone-setup…. Updated 2026-05-23.
+- [m3-validation-and-query-log.md](m3-validation-and-query-log.md) — _log_ — - Project: docs - Milestone: M3 — Validation and query (`check`, `list`) - Started: 2026-05-22 - Progress: Complete —…. Updated 2026-05-22.
+- [m4-migration-helper-log.md](m4-migration-helper-log.md) — _log_ — - Project: docs - Milestone: M4 — Migration helper (`docs migrate`) - Started: 2026-05-22 - Completed: 2026-05-22 -…. Updated 2026-05-22.
+- [m2-mutating-verbs-log.md](m2-mutating-verbs-log.md) — _log_ — - Project: docs - Milestone: M2 — Mutating verbs (`new`, `archive`, `mv`, `touch`) - Started: 2026-05-21 - Progress:…. Updated 2026-05-21.
+- [m1-parser-and-index-log.md](m1-parser-and-index-log.md) — _log_ — - Project: docs - Milestone: M1 — Parser and `docs index` - Started: 2026-05-20 - Shipped: 2026-05-20 - Progress: Phase…. Updated 2026-05-20.
+
+### Active — Decision
+
+- [dual-status-adr.md](dual-status-adr.md) — _decision_ — A doc's lifecycle state could be expressed by:. Updated 2026-05-20.
+- [vocab-adr.md](vocab-adr.md) — _decision_ — The convention requires controlled vocabularies for `Status` and `Role`. Too small a set fails to express common…. Updated 2026-05-20.
+
+### Active — Runbook
+
+- [release-runbook.md](release-runbook.md) — _runbook_ — The operator-driven checklist for shipping `docs-cli` to PyPI. This runbook is **M9's operative artifact** — every…. Updated 2026-05-25.
+
+### Active — Reference
+
+- [architecture.md](architecture.md) — _reference_ — Single Python module at `src/docs_cli/cli.py`, exposed as the `docs` console-script via the `docs_cli.cli:main` entry…. Updated 2026-05-25.
+- [definition-of-ready.md](definition-of-ready.md) — _reference_ — Gate-check before implementation begins. Implementation does not start until every item is green.. Updated 2026-05-22.
+- [test-strategy.md](test-strategy.md) — _reference_ — | Layer | Tool | Scope | |---|---|---| | Unit | pytest | Parser, walker, render, vocab loading. Pure-function focus. |…. Updated 2026-05-20.
+
+## Archived
+
+_None._
+<!-- docs:generated end -->