Verification

Verification

Per-Tool Checklist

For each tool refactored:

  • Old page removed or redirected

  • New {tool}/index.adoc exists with xref table

  • Each concern has its own page (thin include shell)

  • Each concern has its own partial (STD-016 content)

  • Examples extracted to examples/codex/{tool}/

  • Nav updated with per-concern entries

  • All xrefs to old path updated across the repo

  • Build: zero errors, zero warnings

Build Verification

# After each tool
rm -f /tmp/build.txt && make > /tmp/build.txt 2>&1 && cat /tmp/build.txt
# MUST show: zero errors, zero warnings, Site built

xref Audit

# Before moving a tool — find all references to the old path
grep -rn 'codex/text/grep' docs/modules/ROOT/ | grep -v '.git'

# After moving — verify no stale references remain
grep -rn 'codex/text/grep' docs/modules/ROOT/ | grep -v '.git'
# Expected: 0 matches

Content Preservation

# Count source blocks before and after
# Before (from git):
git show HEAD~1:docs/modules/ROOT/partials/codex/text/grep-quick-reference.adoc | grep -c '^\[source,'

# After (split across new partials):
grep -c '^\[source,' docs/modules/ROOT/partials/codex/grep/*.adoc | awk -F: '{sum+=$2} END{print sum}'

# After count must be >= before count

Phase 1 Completion Criteria

Tool Status

grep

[ ] Not started

awk

[ ] Not started

sed

[ ] Not started

find

[ ] Not started

jq

[ ] Not started

All five promoted tools refactored, build clean, nav updated, no stale xrefs.