docs: AGENTS.md -- MANDATORY treatment for structurally-enforced rules #62

Merged
joshtronic merged 2 commits from docs/mandatory-rules-loud into master 2026-05-21 20:37:19 +00:00
Owner

Same pattern as the PR_BODY.md fix: rules that are NOT suggestions
should not read like suggestions. Strengthened the load-bearing
ones with MANDATORY + NOT OPTIONAL framing, plus the actual
consequence ("harness HARD-BLOCKS", "harness REFUSES to push and
BLOCKS the issue") so the rule connects to the real effect.

Targeted:

  • Scope cap (~400 lines): harness hard-blocks larger
  • Tests + lint before exit: branch state IS the PR state
  • /security-review: shipping leaked-secret/injection bugs
  • Never commit to main/master/qa: harness refuses push
  • Don't push/fetch directly: harness owns remote ops, racing breaks
  • CI workflows off-limits: harness refuses push + blocks issue

Left as soft preferences (still bold but not MANDATORY):

  • One issue, one outcome
  • Treat issue body as authoritative
  • No in-tick clarifying questions (no human present anyway)

PR_BODY.md section intentionally left alone -- handled by the
separate fix/pr-body-mandatory PR. The two branches don't conflict.

Going all-caps everywhere would dilute the signal. The point of
MANDATORY is to identify the rules with structural consequences,
not to yell at every preference.

Same pattern as the PR_BODY.md fix: rules that are NOT suggestions should not read like suggestions. Strengthened the load-bearing ones with MANDATORY + NOT OPTIONAL framing, plus the actual consequence ("harness HARD-BLOCKS", "harness REFUSES to push and BLOCKS the issue") so the rule connects to the real effect. Targeted: - Scope cap (~400 lines): harness hard-blocks larger - Tests + lint before exit: branch state IS the PR state - /security-review: shipping leaked-secret/injection bugs - Never commit to main/master/qa: harness refuses push - Don't push/fetch directly: harness owns remote ops, racing breaks - CI workflows off-limits: harness refuses push + blocks issue Left as soft preferences (still bold but not MANDATORY): - One issue, one outcome - Treat issue body as authoritative - No in-tick clarifying questions (no human present anyway) PR_BODY.md section intentionally left alone -- handled by the separate fix/pr-body-mandatory PR. The two branches don't conflict. Going all-caps everywhere would dilute the signal. The point of MANDATORY is to identify the rules with structural consequences, not to yell at every preference.
docs: AGENTS.md -- MANDATORY treatment for structurally-enforced rules
All checks were successful
Lint / check-sync (push) Successful in 4s
Lint / check-sync (pull_request) Successful in 5s
1105cba9f7
Same pattern as the PR_BODY.md fix: rules that are NOT suggestions
should not read like suggestions. Strengthened the load-bearing
ones with MANDATORY + NOT OPTIONAL framing, plus the actual
consequence ("harness HARD-BLOCKS", "harness REFUSES to push and
BLOCKS the issue") so the rule connects to the real effect.

Targeted:
- Scope cap (~400 lines): harness hard-blocks larger
- Tests + lint before exit: branch state IS the PR state
- /security-review: shipping leaked-secret/injection bugs
- Never commit to main/master/qa: harness refuses push
- Don't push/fetch directly: harness owns remote ops, racing breaks
- CI workflows off-limits: harness refuses push + blocks issue

Left as soft preferences (still bold but not MANDATORY):
- One issue, one outcome
- Treat issue body as authoritative
- No in-tick clarifying questions (no human present anyway)

PR_BODY.md section intentionally left alone -- handled by the
separate fix/pr-body-mandatory PR. The two branches don't conflict.

Going all-caps everywhere would dilute the signal. The point of
MANDATORY is to identify the rules with structural consequences,
not to yell at every preference.
Merge remote-tracking branch 'origin/master' into docs/mandatory-rules-loud
All checks were successful
Lint / check-sync (push) Successful in 4s
Lint / check-sync (pull_request) Successful in 4s
3afc02123c
# Conflicts:
#	AGENTS.md
joshtronic deleted branch docs/mandatory-rules-loud 2026-05-21 20:37:19 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
joshtronic/igor!62
No description provided.