servius/sukr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: close API stabilization plan review and fix stale refs

Browse Source 
Close plan review: fix Decisions table 404 naming (content/404.md
→ content/_404.md), check off Verification items, log
collect_items() quadruple-call as technical debt, fill in
Retrospective.

Fix post-changeset staleness: AGENTS.md YAML→TOML reference,
add [nav]/[feed]/[sitemap] config tables to AGENTS.md example,
mark charter workstream 1 complete.
This commit is contained in:
Timothy DeHerrera
2026-02-15 09:47:09 -07:00
parent 7b3373295b
commit 5c3299b774
3 changed files with 43 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/charters/sukr-v1.md
View File

@@ -30,7 +30,7 @@ The measure isn't feature count — it's _absence_. Absence of JS bundles, absen
1. **API Stabilization** — Evaluate which features belong in 1.0 (candidates: taxonomies/tags, i18n, others surfaced during sketching), then lock the public contract: `site.toml` schema, frontmatter fields, template variables, CLI flags, content directory conventions. Includes a dependency health audit (git deps, alpha deps, local patches) since these affect whether the stable surface is reproducibly buildable. The sketch must answer "what's in?" before locking "what's stable?" — and may spawn additional feature workstreams if the answer introduces implementation work
- Spawns: `.sketches/api-stabilization.md` (and potentially feature-specific sketches)
- Status: Not Started
- Status: Complete — see `docs/plans/api-stabilization.md`
2. **Error Quality** — Every error message tells the user what failed, why, and what to do about it. No panics outside `main()`, no opaque messages
- Spawns: `.sketches/error-quality.md`