spec-driven-rule

Guides creation of laws, rules, and patterns in a spec-driven documentation hierarchy.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill spec-driven-rule-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-rule
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/spec-driven-rule
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill spec-driven-rule-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams maintaining spec-driven documentation struggle to keep laws, rules, and patterns consistent: laws leak project paths, rules lose their binding to implementation anchors, and descriptions grow past the context budget. This Skill encodes the structure, section sets, and audit expectations for each documentation layer so edits stay compliant. ## Core Features & Use Cases - Layered authoring guidance: Defines what belongs in a law (docs/constitution/), a rule (.claude/skills/<rule>/SKILL.md), and a pattern (.claude/skills/<rule>-<what>/SKILL.md), including mandatory sections and header formats. - Binding and audit rules: Explains the implementation.md binding table, accepted verdicts for unbound statements, and how npm run check:specs validates the structure. - Description and compression discipline: Provides the 300-character description budget, the load-or-not question, and a worked example of compressing an article while moving detail to pitfalls. - Use Case: When adding a new coding rule under an existing law, load this Skill to get the exact SKILL.md header, the required sections, the binding table format, and the common misses that cause the spec audit to fail. ## Quick Start Ask the assistant to create a new rule under the delivery law in .claude/skills following the spec-driven pattern, including its header, sections, and binding table.

Frequently Asked Questions about spec-driven-rule

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new rule in a spec-driven documentation system?

Create `.claude/skills/<rule>/SKILL.md` with a frontmatter declaring name, kind: rule, the law it binds to, and a description. Include the required sections such as "How the law applies here", and add a binding line in implementation.md for each statement.

What is the difference between a law, a rule, and a pattern?

A law in docs/constitution states what is always true, with no project paths or file names. A rule binds a law to the project with concrete anchors. A pattern holds ready-made code for a rule and is not audited.

When should a rule be split into a pattern?

Split when ready-made code inside a rule has grown large enough to distract from the articles. Move the code into `.claude/skills/<rule>-<what>/SKILL.md` with kind: pattern and reference it from the rule.

Why does the spec audit reject my binding line?

The audit requires each binding to sit inside the implementation.md table, in the same order as the rule's statements, with anchors that resolve to live symbols. Empty bindings need an exact verdict: Не исполняется, Не применимо, or Не проверяется.

What are the limits on a rule or pattern description?

Descriptions are limited to roughly 300 characters because they enter every session's system prompt. They must state which law the rule is under, when to load it, and for patterns when not to load it; overruns require an accepted-debt entry.