jawz/NixOS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

sync-docs
Some checks failed
MCP Tests / mcp-tests (push) Failing after 6s
Details

Browse Source
This commit is contained in:
Danilo Reyes
2026-02-01 11:31:48 -06:00
parent a29aa773fc
commit f0d28b4a1e
4 changed files with 83 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
specs/001-ai-docs/research.md
View File

@@ -19,3 +19,8 @@
- **Decision**: Anchor discoverability through `docs/constitution.md` with links to `docs/reference/index.md` and `docs/playbooks/`; record any conflict resolutions in `specs/001-ai-docs/research.md` with date and source references.
- **Rationale**: Keeps navigation within two steps for AI and centralizes historical decisions for reconciliation.
- **Alternatives considered**: (a) Distribute links per playbook only (rejected: harder to enforce two-step navigation); (b) Log conflicts in ad-hoc comments (rejected: loses traceability for AI tools).
## Decision 5 (2026-02-01): MCP docs sync alignment
- **Decision**: Treat the constitution as authoritative, update MCP docs to include explicit tool anchors, and align the tool catalog anchors to actual markdown headings; scope sync checks to MCP tool headings in `docs/reference/mcp-server.md`.
- **Rationale**: Prevents false drift from unrelated docs while ensuring tool anchors remain accurate and navigable.
- **Alternatives considered**: (a) Force every doc to map to a tool (rejected: inflates catalog and adds noise); (b) Keep loose anchors without validation (rejected: undermines navigation and sync intent).