Stop making the contract the first thing the skill reads

Contribution Date
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 Author
Bassam Ismail
Files count
0
Patches count
1