Files
boshu2__agentops/docs/reference
Bo 2ee168902e W4 specialists wave: converter destructive path closed, authority grants stripped, honest effects (#1003)
## Summary

Wave W4 of the skill-overhaul reboot
(`age-skill-overhaul-reboot-sjv7v.5`) — seven candidate-producing
specialists, every checklist item verified against the live tree;
heavyweights reproduced before fixing.

- **converter** [P0] — `convert.sh` could `rm -rf` a caller-supplied
output dir and destroy the source package (reproduced). Now refuses when
the canonicalized output equals, contains, or is contained by the
source, or is/contains the repo root — symlinks resolved, root
special-cased. Behavioral self-test (8 assertions) proves each refusal
happens before any deletion, with source survival checked by content
digest. Default output moved to `.agents/projections/converter/`.
- **scaffold** — deleted the commit/continuation authority grants from
`generic-templates.md`; validator now sweeps `references/**` for the
full grant vocabulary (proven failing on six restored variants).
- **refactor** — feature file stripped of commit + auto-revert
authority; revert contradiction resolved; `modify_source_files`
declared.
- **doc** — `--create-issues` tracker authority and Next-Steps
work-creation removed; artifact dir into the closed set. The
`[disputed]` vacuous-validator claim was verified false and rejected.
- **skill-builder** — build-report write declared and relocated;
`context_rel` added — **strict frontmatter is now 49/49 with zero
warnings corpus-wide**. The five-Python-files ratchet claim was verified
stale (files don't exist; live ones grandfathered).
- **test** — validator replaced with load-bearing checks (fails on
removed sections); `produces` reconciled everywhere incl. the feature
file; effects now include `modify_source_files` (TDD mode edits
production code).
- **workflow-builder** — `write_workflow_script` declared.

Ledger (30 fixed / 3 rejected-stale / 15 deferred-with-reason):
`docs/audits/2026-07-28-skill-overhaul-reboot/wave-reports/w4.md`.

## Validation

- Converter self-test 8/8 (descendant, repo-ancestor,
symlink-into-source cases; digest-based survival); in-scope validators
PASS
- Strict frontmatter 49/49 zero warnings; regen clean; 23/23 bats;
scenario-linkage PASS; python ratchet no-growth; shellcheck clean
- Cross-family review, two rounds (ceiling): round 1 five findings all
fixed (bidirectional guard, self-test hardening, sweep completeness,
feature reconciliation, effects); round 2's one residual (`within()`
breaking for parent=/) fixed and witnessed

Tracker: `age-skill-overhaul-reboot-sjv7v.5`
2026-07-28 15:44:42 +00:00
..