templates/skills/core/rulebook/SKILL.md
Spec-driven task management for features and breaking changes with OpenSpec-compatible format
npx skillsauth add hivellm/rulebook Rulebook Task ManagementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use Rulebook's task system for spec-driven development. Create a task BEFORE implementing any feature, breaking change, architecture change, or performance/security work. Skip it for bug fixes, typos, and non-breaking dependency updates.
rulebook task create <task-id> (or rulebook_task via MCP)proposal.md, tasks.md, and spec deltasrulebook task validate <task-id>tasks.md items in orderrulebook task archive <task-id>Prefer the MCP tools (rulebook_task/list/show/validate/archive) when the MCP server is enabled. Never create task directories by hand.
.rulebook/tasks/<task-id>/
├── proposal.md # Why and what changes
├── tasks.md # Checklist only — no explanations
├── design.md # Technical design (optional)
└── specs/<module>/spec.md
proposal.md: ## Why + ## What Changes + ## Impact (affected specs/code, breaking Y/N).
tasks.md: numbered phases with - [ ] 1.1 <simple item> entries only.
Spec deltas (specs/<module>/spec.md):
## ADDED Requirements
### Requirement: <Name>
The system SHALL <do something>.
#### Scenario: <Name>
Given <context>
When <action>
Then <expected result>
Use ## ADDED / ## MODIFIED / ## REMOVED headers; scenarios use 4 hashtags.
See .rulebook/specs/rulebook.md for the full format reference.
research
Author a rulebook task spec interactively — research, draft, ask the user clarifying questions, confirm, then create the tasks in rulebook ready for /rulebook-driver. Use when the user wants to plan/spec a feature before implementing.
development
Behavioral guidelines to reduce common LLM coding mistakes — overcomplication, sloppy refactors, hidden assumptions, weak goals. Use when writing, reviewing, or refactoring code. Auto-applies; invoke explicitly via /karpathy-guidelines or 'follow karpathy discipline'.
research
Create structured analyses with numbered findings, execution plans, and task materialization
tools
Tool: Anthropic Claude Code CLI (`npm install -g @anthropic-ai/claude-code`)