Commit History
-
[NOTICKET] docs(knowledge): v3 delta in the workstream docs
Rifqi Hafizuddin +1: Claude Opus 5Completes the doc sync for `172d8dc`, alongside `6a9fb78`. - TODO: new X26 for the v3 reshape; X24 annotated as superseded for the domain branch. Numbered X26 rather than X25 because X25 ("baselines expire") already exists - task ids are cited from other docs and must not be reused. - CALIBRATION: the guarded-field table read `summary | (none - generation cannot be span-checked at all)`. That was a principle, not just a fact, and a future change would reasonably have built on it. It now reads `title, purpose_verbatim`, with the reason the exception disappeared: the branch was asked to LOCATE rather than SUMMARISE, so there is something to check against. - CONTEXT: the review-stage mermaid node "Brief Context" -> "Domain Context", and the per-branch model-tier principle amended - Summary was classed with Rule as reasoning/generation needing a larger tier "because a plausible summary cannot be span-checked". That premise no longer holds. This closes the X26 referenc…58e2002
-
[NOTICKET] docs: reorganise into docs/ and give every doc a status banner
Rifqi Hafizuddin +1: Claude Opus 5The root carried 14 markdown files and no way to tell which were authoritative. That knowledge lived in CLAUDE.md §1 and in Rifqi's head, which works for us and fails for anyone else — and one of the stale ones already has a named failure mode ("The Stale-Doc Believer") for being implemented from. Root now holds four: REPO_STATUS, DEV_PLAN, API_CONTRACT_BE_PYTHON, README. Everything else moves under docs/, by git mv so history follows: docs/knowledge/ context, TODO, calibration, parsing output contract docs/plans/ SPINE_V2_PLAN (approved, W3 deferred), DS_TOOLS_PLAN (proposal) docs/archive/ API_ENDPOINTS_RESTRUCTURE, CODE_REVIEW_2026-07-23, PROJECT_BRD docs/reference/ API_CONTRACT_BE_GOLANG (the Go repo's, a copy that can drift) Every doc gains a one-line status banner under its H1, marked <!-- doc-status -->: LIVE / LIVE PLAN / PROPOSAL / ARCHIVED / REFERENCE. Archived ones name what superseded them — API_ENDPOINTS_RESTRUCTURE now opens with "DO NOT IMPLEMENT FROM…f1342ce