docs(structure): single Gates home and honest scaffold targets #56

2026-09-09T19:45:46Z

Ty commented

2026-09-09 19:45:46 +00:00

Why

Docs on main are the product SoT, but the map made agents invent harness trees and fight UX sources. This pass lowers reader load without changing Gate A lock meaning.

Scope

Add docs/checks/check-structure.sh as a re-runnable structure pin.
Move Gate A/B/C meanings into docs/IMPL-PLAN.md only. Thin AGENTS.md §0b to a pointer.
List docs/UX-DESIGN.md as non-normative. Signed docs/UX.md wins on conflict. List deploy/INVENTORY.md in AGENTS §0.
Label frontend/e2e/, backend/tests/, and compose Dockerfiles as Phase 0 deliverable targets until code lands (docs/TEST-SPEC.md, docs/DEPLOYMENT.md, deploy/docker-compose.yml, README.md).
Commit decision trail at .audit/docs-structure-pass.tsv.

Out of scope: product lock text changes, app scaffold, gate-b code, verification skill.

Tradeoffs

Demoted UX-DESIGN instead of deleting or folding 486 lines. Keeps sketches available. Forces agents through signed UX first.

Blast Radius

Agents and humans reading main docs. Safe for locks: harness requires the same AGENTS lock phrases. Risk is incomplete restatement cleanup elsewhere (UAT/TEST-SPEC may still name gates in passing).

Verification

docs/checks/check-structure.sh
# check-structure: PASSED

Red baseline before edits failed ownership, UX demotion, Gates home, and TEST-SPEC honesty checks. Green after the four commits on docs/structure-pass.

## Why Docs on `main` are the product SoT, but the map made agents invent harness trees and fight UX sources. This pass lowers reader load without changing Gate A lock meaning. ## Scope - Add `docs/checks/check-structure.sh` as a re-runnable structure pin. - Move Gate A/B/C meanings into `docs/IMPL-PLAN.md` only. Thin `AGENTS.md` §0b to a pointer. - List `docs/UX-DESIGN.md` as non-normative. Signed `docs/UX.md` wins on conflict. List `deploy/INVENTORY.md` in AGENTS §0. - Label `frontend/e2e/`, `backend/tests/`, and compose Dockerfiles as Phase 0 deliverable targets until code lands (`docs/TEST-SPEC.md`, `docs/DEPLOYMENT.md`, `deploy/docker-compose.yml`, `README.md`). - Commit decision trail at `.audit/docs-structure-pass.tsv`. Out of scope: product lock text changes, app scaffold, gate-b code, verification skill. ## Tradeoffs Demoted UX-DESIGN instead of deleting or folding 486 lines. Keeps sketches available. Forces agents through signed UX first. ## Blast Radius Agents and humans reading `main` docs. Safe for locks: harness requires the same AGENTS lock phrases. Risk is incomplete restatement cleanup elsewhere (UAT/TEST-SPEC may still name gates in passing). ## Verification ``` docs/checks/check-structure.sh # check-structure: PASSED ``` Red baseline before edits failed ownership, UX demotion, Gates home, and TEST-SPEC honesty checks. Green after the four commits on `docs/structure-pass`.

Ty added 4 commits 2026-09-09 19:45:47 +00:00

docs(checks): add structure pin harness bad96f944b

Fails closed until ownership, calendar home, UX demotion, TEST-SPEC honesty,
and Gate A lock phrases hold. Reviewers re-run docs/checks/check-structure.sh.

docs: single Gates home and honest UX ownership 8d65984936

Move Gate A/B/C meanings to IMPL-PLAN. List UX-DESIGN as non-normative with
signed UX.md winning conflicts. List INVENTORY in AGENTS §0.

docs: label Phase 0 scaffold targets on docs-only main f855f91b8b

TEST-SPEC harness paths and compose Dockerfiles are deliverables until code
lands. Cases stay not run. Stops agents inventing alternate test trees.

docs(audit): structure-pass decision trail 32547cad8c

TSV log for the docs/structure-pass figure-it-out run.

grokbot_ty added 1 commit 2026-09-09 19:47:20 +00:00

docs(structure): restore Gate B wording and harden pin 4576df7253

Drop the Gate B parenthetical that was not in the frozen AGENTS table.
Require Phase 0 labels in both compose and DEPLOYMENT, and pin the full
client-authoritative math lock phrase.

grokbot_ty added 1 commit 2026-09-09 19:56:35 +00:00

docs(structure): fix single-home wording nits 2c73e5fa4e

Point UAT at IMPL-PLAN only. Soften AGENTS and IMPL-PLAN so the meanings
table has one home while TEST-SPEC may still map cases to phases.

Ty reviewed 2026-09-09 20:00:22 +00:00

Ty left a comment

Ship verdict (parent agent; local worktree + Gitea MCP).

VERDICT: PASS

docs/checks/check-structure.sh PASSED on 2c73e5f
UAT no longer cites AGENTS §0b
AGENTS/IMPL-PLAN single-home wording softened; TEST-SPEC case map allowed
Product lock bullets in AGENTS §§3–7 unchanged vs main

Note: explore subagents do not receive gitea_mcp_for_ty. Use parent MCP or local git for Gitea PRs.

Ship verdict (parent agent; local worktree + Gitea MCP). VERDICT: PASS - docs/checks/check-structure.sh PASSED on 2c73e5f - UAT no longer cites AGENTS §0b - AGENTS/IMPL-PLAN single-home wording softened; TEST-SPEC case map allowed - Product lock bullets in AGENTS §§3–7 unchanged vs main Note: explore subagents do not receive gitea_mcp_for_ty. Use parent MCP or local git for Gitea PRs.

Ty merged commit 5c1da50174 into main

2026-09-09 20:02:30 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Ty_Tech/SlabUploader#56