feat(rules): add intent-discipline rule package#72
Merged
Conversation
Four behavioral guardrails for non-trivial coding work: surface assumptions before implementing, write minimum-viable code over speculative abstractions, keep diffs surgical so every changed line traces to the request, and convert imperative tasks into verifiable success criteria the agent can loop against. Cross-references test-standards and commit-standards instead of restating their content. Adds explicit when-not-to-apply guidance, a rationalizations table, and a red-flags inventory to harden the rule against the common excuses agents use to skip it. Includes five positive and three negative eval cases; negatives disambiguate from typing-standards, test-standards, and commit-standards trigger surfaces. Manifest regenerated.
Adds the rule to the README rules table and bumps the package count badge from 130 to 131. Records the source observation and prior Claude-Code packaging under Conceptual Inspiration so downstream forks can trace the framework origin without reading the rule body.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new
rule-type package,intent-discipline, that codifies four behavioral guardrails for non-trivial coding work. It targets the failure modes where an agent runs ahead of the user's actual intent: silently picking one interpretation of an ambiguous request, over-engineering single-use code, mixing drive-by refactors into an unrelated diff, and reporting work "done" against a success criterion too weak to verify.The rule is deliberately distilled against the existing armory rule set so it adds discipline that no current rule covers, and cross-references the rules it borders rather than restating them.
The four guardrails
Distillation against existing rules
The rule explicitly defers instead of duplicating:
test-standards(cross-referenced)commit-standards(cross-referenced)token-efficiency(out of scope)adaptive-thinking-control(out of scope)A
When to Use This Rule vs Related Rulestable in the rule body draws these boundaries for the reader.Hardening
Beyond the source framework, the rule adds:
Changes
rules/intent-discipline/RULE.md— rule definition (frontmatter description trimmed to fit the 1024-char validator ceiling; triggers span the intent / simplicity / verifiability synonym families).rules/intent-discipline/evals/cases.yaml— five positive cases (ambiguous request, over-engineering, drive-by refactor, imperative-to-verifiable, plan-with-verification) and three negative cases that disambiguate fromtyping-standards,test-standards, andcommit-standards.manifest.yaml— regenerated; rule count 5 → 6, total packages 130 → 131.README.md— rule added to the Rules table; package count badge 130 → 131.ATTRIBUTIONS.md— framework origin recorded under Conceptual Inspiration.Commits
Two logical, bisectable commits:
feat(rules): add intent-discipline rule package— rule + evals + manifest (manifest travels with the package so the rule is self-consistent and CI-valid at this commit alone).docs: surface intent-discipline in catalog and attributions— README + ATTRIBUTIONS.Validation
validate_frontmatter.pyvalidate_evals.pyvalidate_references.pysync_templates.pyCursor / Codex / Gemini adapters regenerate from the rule via
generate_adapters.py(gitignored build artifacts, not committed).Test plan
package-evaluatoragainstrules/intent-discipline/— target ≥70% (Adequate), aim ≥80% (Strong)