Ty
84d7681c6f
- 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
49 lines
2.4 KiB
Markdown
49 lines
2.4 KiB
Markdown
# 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.
|