Use when asked to review code or a design at any granularity — a pull request, an architecture/design proposal, a module, a file, or a whole codebase/repo — "review this PR", "review this repo", "audit this module", "challenge this design", "is this…
Review a written document (markdown, design doc, runbook, README, etc.) for redundancy, inconsistency, clarity, and density. Apply the general rules first, then the type-specific addendum for the doc's genre. TRIGGER when: user asks to "review", "audit",…
Render a markdown doc as a self-contained HTML view, written by hand for that document. TRIGGER when the user asks for an "html view", "make this readable", "render as html/page", "open as a page", or wants a shareable page of a markdown deliverable (review…
Shapes the body text when creating a GitHub issue or pull request, so the result is concise, plain-spoken, and leads with the bigger picture instead of reading like a robotic template. USE when: about to open or draft a GitHub issue or PR (via `gh`, the web…
Close a document against the session that produced it — no dangling finding IDs, no session-only shorthand, and code references a cold reader can actually resolve. TRIGGER when writing or updating any document that references code or may leave the session:…
Where an agent-created document belongs: scratch `notes/` that dies with the worktree, or durable `~/notes/<owner>/<repo>/` that outlives the branch. Covers naming, frontmatter, collisions, repo hygiene, and HTML artifacts. TRIGGER when creating, naming, or…
Sourcing discipline for research and analysis: validate each claim against a primary source, link it, and verify on-chain identifiers before citing them. TRIGGER when producing research, analysis, comparisons, or any write-up that asserts external facts about…
Where things go inside a function body: define each binding next to its first use, and inline single-use values unless naming one earns its keep. TRIGGER when writing or restructuring the body of a function, in any language. DO NOT TRIGGER for module/file…