rule-authoring
Maintain project-owned Codebase Rules after `hi init` or `hi update`. Use only from those post-command handoffs.
SKILL.mdskills/agnostic/docs/rule-authoring/SKILL.md
GitHubRule Authoring
Use with $writing-for-agents.
- Read or create
.agents/rules/index.md. - Keep one stable invariant per scope-grouped rule file. Require current Code Evidence or a linked accepted architecture decision.
- Index each rule by stable id, scope, path trigger, task trigger, optional tags, and file. Tags aid discovery; the other triggers decide activation.
- Keep scoped
AGENTS.mdfiles to scope, exact skill routing, and one exhaustive Rule Registry pointer. - Evaluate every activated rule as
pass,fail, ornot-applicablewith evidence in the current handoff or work log.
Rule files contain: id, authority, one positive requirement, activation triggers, verification, and exceptions.
For an existing repository, follow migration.md. Completion means the index is exhaustive, every pointer resolves, and project-owned rules remain preserved.