Contribution Date
Contribution Project
Contribution Details
Stop making the contract the first thing the skill reads
The skill opened by telling itself to read contract.md and validation.md before
doing anything. Three quarters of that document restates rules docs_audit.py
already enforces, so the effect was to recite policy at the start and then have
the auditor check the same policy at the end.
The skill now works from the procedure for the situation and treats the auditor
as the authority: scaffold or migrate, run the audit, fix what it reports.
anti-fluff.md stays required reading before drafting prose, because it governs
what may be written and the audit cannot check most of it.
contract.md keeps its content and loses its position. It is opened for a rule the
audit does not check, for the wording to cite in an ADR that deviates, or for the
reason behind a rule being argued with. Deleting the enforced sections would
leave the standard defined only by Python, which cannot be cited in review and
gives no way to tell whether the script enforces the right thing.
Co-Authored-By: Claude Opus 5 (1M context)
Claude-Session: https://claude.ai/code/session_01XmzqahsmAXBn5wJab92jP2
Contribution Issue Link
Files count
0
Patches count
1