grimoire-spec

Installation
SKILL.md

Write requirements contracts in .grimoire/spec/, not production code. Preserve every independent outcome; scale detail to risk. A spec retains value after implementation while it explains required behavior, constraints, or acceptance. Small tasks may proceed from clear conversation requirements without a spec; do not make one a universal prerequisite. Standalone invocation does not require refine or its handoff.

Under grimoire-refine, require and follow its supplied knowledge boundary, permissions, and endpoint. Return gaps/results to the coordinator; do not resolve new semantic choices or choose downstream workflows. If the coordination contract is absent, request it rather than guess its location.

Build the contract

  • When saving a requested spec, create .grimoire/spec/ and missing parents unless writes are restricted; no separate initialization approval is needed. Do not require grimoire-init or create unrelated directories or knowledge files; use init only when establishing the CONTEXT/ADR system is requested. A path/type conflict or denied write blocks persistence, not permission to replace existing content.
  • Allocate unused NNNN-title-with-dashes.md names; do not overwrite unrelated specs.
  • Leave Git configuration (including ignore rules) and agent registration unchanged without separate explicit authorization. The existing Git allowlist permits Markdown specs; creating one neither installs that policy nor authorizes staging or committing. Report conflicting ignore rules rather than bypassing them.
  • Read the requirement, available relevant context/domain files, applicable ADRs, and affected repository surfaces. Missing optional knowledge files are not prerequisites. Scan ADR titles/statuses before expanding unrelated history.
  • Surface ADR conflicts. Standalone work may recommend a resolution or keep a non-blocking assumption visible; ask before committing an irreversible, policy-breaking, or scope-changing choice. Coordinated work returns these gaps to refine.
  • Describe necessary integration points and what they exchange or guarantee, including in-process boundaries when correctness or ownership depends on them. Exclude incidental calls and speculative architecture. Read minimum-seams.md when inclusion is unclear.
  • Use spec-template.md for drafting. Include outcomes, the solution, representative input-to-outcome verification, material choices and their sources, and meaningful exclusions. Add further test guidance or future evolution only when justified; omit empty sections without omission boilerplate.
  • Split specs only for genuinely independent lifecycles or approval paths. Make acceptance observable; do not invent thresholds or excluded scope to fill a template.

Write and verify

Present material choices, assumptions, seams, and exclusions. Write reversible drafts within permission; require approval before consequential split/merge, scope change, ADR conflict resolution, or irreversible commitment. Revise affected sections after feedback.

Installs
22
GitHub Stars
3
First Seen
Jul 23, 2026