Files
SlabUploader/.audit/2026-09-18-migration-todos.md
T
Ty 84d7681c6f docs(phase2): coverage gate, migration TODOs, session handoff
- add tools/check_coverage.py and .audit/coverage ledger (schema + settings pilot)
- add coverage gap worklist and source-doc migration TODOs
- add session handoff; redirect stale resume points in AGENTS.md, docs/README.md, reconciliation record
- add rows: CAPTURE-41, CAPTURE-141, METADATA-66, PUBLISH-31, SETTINGS-51
2026-09-18 12:54:08 -07:00

2.4 KiB
Raw Blame History

Migration TODOs — source docs

  • Date: 2026-09-18
  • Branch: docs/clean-main
  • Purpose: edits deferred until Phase 2 step 3, when the capability and contract docs are migrated into docs/capabilities/ and docs/contracts/, made branch-neutral, and converted to cite requirement IDs.
  • Rule: these docs are not edited now. REQUIREMENTS.md is the only normative text and is already correct for everything below.

CAPTURE.md

  1. Line 16, "Length of the slab is aligned with the long side of the picture" — ruled dead. Remove.
  2. Lines 128–129, the kind=inventory role label — discarded. The "first inventory photo is the measurement reference" half is CAPTURE-115; keep it as a citation, drop the label.
  3. Line 140, editor/storefront alpha presentation — discarded.
  4. The sensitivity mapping (line 69) and display/source-pixels rule (lines 58–62) are now CAPTURE-41 and CAPTURE-141; cite them instead of restating.
  5. Line 82 busy mark ("more than a fraction of a second"; as-built is 300 ms) — ruled a nit, not a requirement. Leave as design prose or drop.

CREATE.md

  1. Grade cardinality: change "1 or more" to 1 in all three places (attributes table, ready set, data shape). Ruling: Grade is exactly one.
  2. fig-* cardinality: change "1 or more / required" to optional in the tags table and the ready set. Ruling: tags optional; the Figure attribute is at least one.
  3. Ready-set images: change "at least one inventory PNG" to two (clean calibration plus its dimension-overlay copy). Ruling: REVIEW-5 is the PoR.
  4. Remove "cap at 5 images" from the create sequence.
  5. Remove "user typed widths/sqft/bdft wins"; the calculated fields are read-only.
  6. Fix the Call 2 line so the model writes the title/description and the deterministic template is the fallback, not the assembler.

CONTENT-WOO.md

  1. Em dash in the title template and example → hyphen.
  2. "Templates (always on)" and "templates inject those numbers after the prose comes back" → template is the fallback only; the model writes when Call 2 runs.
  3. fig-* "1+ required" and the ready set including fig-* tags → tags optional.
  4. "≤5 inventory photos" → no cap; drop the "only kind=inventory" clause.
  5. The empty attributes element shape is the known deferred decision; keep the placeholder.

PHOTOS.md

No changes. Overlay legibility and arrow/text drawing detail were ruled design, not requirements.