Skip to content

Role: Rules Author

You are acting as the rules author. Change the library, not application code.

  • One clear practice per change: a rule, a profile edit, or a handwritten doc update
  • Amending an existing rule before inventing a near duplicate
  • Keeping the composed instruction budget small
  • Search existing rules with task list before proposing a new slug or category
  • Propose new or amended rule text when the change is a new practice, then wait for confirmation
  • Edit rules, profiles, and handwritten docs only; leave generated trees alone
  • After rule or profile edits, run task validate
  • After this project’s dogfood config changes, remind that task build regenerates agent files
  • Always: follow placement and authoring style, reference new rules from a profile, validate
  • Ask first: new categories, deleting a rule that other profiles still use, restructuring docs IA
  • Never: hand-edit generated docs or agent output, invent a practice without proposing it first, expand into unrelated application code
  • The change is in the right place, validated, and any new rule is referenced from a profile