Skip to content

Comments

chore - add context rule design guide and precedence reminder#111

Merged
dpuglielli merged 4 commits intomainfrom
chore/context-rule-design-guide
Dec 27, 2025
Merged

chore - add context rule design guide and precedence reminder#111
dpuglielli merged 4 commits intomainfrom
chore/context-rule-design-guide

Conversation

@dpuglielli
Copy link
Collaborator

@dpuglielli dpuglielli commented Dec 27, 2025

Summary

  • Add context rule design guide explaining how to write effective rules
  • Add precedence reminder on every user prompt (project rules > CLAUDE.md > plugin > defaults)
  • Update all rules to conform to design standard (trigger, priority, action, verify, consequence)
  • Mark informational rules with type: reference
  • Bump plugin versions: mantra 0.3.2, memento 0.3.3, onus 0.2.5

Changes

  • mantra/context/rule-design.md - companion doc with detailed guidance
  • mantra/rules/rule-design.md - compact rule for rule authors
  • shared/index.js - precedence reminder in UserPromptSubmit hook
  • Updated actionable rules: behavior.md, test.md, sessions.md, git.md
  • Marked as reference: context-format.md, format-guide.md, work-items.md

Test plan

  • All plugin tests pass (mantra, memento, onus)
  • Verify precedence reminder appears in hook output
  • Review rule-design.md for completeness

- add mantra/context/rule-design.md (companion doc)
- add mantra/rules/rule-design.md (compact rule)
- add precedence reminder to shared UserPromptSubmit hook
- bump mantra 0.3.2, memento 0.3.3, onus 0.2.5
- add trigger, priority, action, verify, consequence to actionable rules
- mark informational rules with type: reference
- document rule types (actionable vs reference) in rule-design.md
- updated: behavior.md, test.md, sessions.md, git.md
- marked reference: context-format.md, format-guide.md, work-items.md
- use direct address ("You MUST prioritize")
- use numbered list for clear order
- clarify "override your default behavior"
- update test to expect precedence reminder in additionalContext
@dpuglielli dpuglielli merged commit 7d2bf5d into main Dec 27, 2025
2 checks passed
@dpuglielli dpuglielli deleted the chore/context-rule-design-guide branch January 17, 2026 23:15
dpuglielli added a commit that referenced this pull request Jan 17, 2026
* chore - add context rule design guide and precedence reminder

- add mantra/context/rule-design.md (companion doc)
- add mantra/rules/rule-design.md (compact rule)
- add precedence reminder to shared UserPromptSubmit hook
- bump mantra 0.3.2, memento 0.3.3, onus 0.2.5

* chore - update rules to conform to design standard

- add trigger, priority, action, verify, consequence to actionable rules
- mark informational rules with type: reference
- document rule types (actionable vs reference) in rule-design.md
- updated: behavior.md, test.md, sessions.md, git.md
- marked reference: context-format.md, format-guide.md, work-items.md

* chore - clarify precedence reminder wording

- use direct address ("You MUST prioritize")
- use numbered list for clear order
- clarify "override your default behavior"

* chore - fix shared test for precedence reminder

- update test to expect precedence reminder in additionalContext
dpuglielli added a commit that referenced this pull request Jan 18, 2026
* chore - add context rule design guide and precedence reminder

- add mantra/context/rule-design.md (companion doc)
- add mantra/rules/rule-design.md (compact rule)
- add precedence reminder to shared UserPromptSubmit hook
- bump mantra 0.3.2, memento 0.3.3, onus 0.2.5

* chore - update rules to conform to design standard

- add trigger, priority, action, verify, consequence to actionable rules
- mark informational rules with type: reference
- document rule types (actionable vs reference) in rule-design.md
- updated: behavior.md, test.md, sessions.md, git.md
- marked reference: context-format.md, format-guide.md, work-items.md

* chore - clarify precedence reminder wording

- use direct address ("You MUST prioritize")
- use numbered list for clear order
- clarify "override your default behavior"

* chore - fix shared test for precedence reminder

- update test to expect precedence reminder in additionalContext
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant