Verification

Pre-Change Verification

Check Status

Triage scan completed — files needing refactoring identified

[ ]

STD-016 reviewed for compliance criteria

[ ]

Build passes before starting

[ ]

Git clean before starting

[ ]

Per-File Verification

After refactoring each file:

Check Status

No monolithic code blocks (>30 lines with multiple unrelated commands)

[ ]

No commands in table cells

[ ]

Every code block has a .Title label

[ ]

Every code block has a language hint ([source,bash], [source,powershell], etc.)

[ ]

Content is unchanged (same commands, same output)

[ ]

Build clean

[ ]

Final Verification

# No monolithic blocks remaining (blocks > 30 lines with mixed commands)
find docs/modules/ROOT/{partials,examples}/codex/ -name "*.adoc" \
  -exec awk '/^\[source,/{n=0; block=1} block{n++} /^----$/ && block{if(n>30) print FILENAME": "n" lines"; block=0}' {} \;
# Review output — some long blocks are legitimate (full scripts)

# No commands in table cells
grep -rn '| `[a-z].*`$' docs/modules/ROOT/{partials,examples}/codex/ --include="*.adoc" | head -20
# Expected: metadata only, no executable commands

# Build clean
make 2>&1 | grep -E "WARN|ERROR"