write-a-requirement-leaf

Writes backtick-numbered requirement leaves with collapsed detail blocks in requirements.md.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/missingbulb/GoogleCalendarEventCreator --skill write-a-requirement-leaf-missingbulb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-requirement-leaf
Source: https://github.com/missingbulb/GoogleCalendarEventCreator/tree/main/.claudinite/shared/packs/executable-requirements/skills/write-a-requirement-leaf
Command: npx skills add https://github.com/missingbulb/GoogleCalendarEventCreator --skill write-a-requirement-leaf-missingbulb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Executable specifications become unreadable when requirement lines mix scannable summaries with long rationale and acceptance notes, making the numbered spine hard for owners to review. ## Core Features & Use Cases - Leaf Line Format: Defines the backtick-wrapped dotted number convention (e.g. 4.2) where each leaf reads as a single scannable one-liner. - Collapsed Detail Blocks: Places rationale, acceptance notes, edge cases, and owner-verification recipes inside a <details> block hidden under the line. - Kind Routing: Routes each leaf to a verification kind — surface snapshot, behavior, logic, saga, per-project extractor/support/server, or a heavy e2e singleton — based on what can honestly observe the assertion. - Use Case: When adding a new requirement to requirements.md for a Chrome extension popup state, write the one-liner leaf and assign it a surface snapshot kind with a committed golden image. ## Quick Start Add a new requirement leaf to dev/requirements/requirements.md following the write-a-requirement-leaf conventions.

Frequently Asked Questions about write-a-requirement-leaf

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

FAQPage Schema
How do I write a requirement line in an executable spec?

Start the line with a backtick-wrapped dotted number like `4.2`, optionally after a list dash, and keep it a single scannable one-liner. Put all expanded detail — rationale, acceptance notes, edge cases — inside a collapsed <details> block beneath the line.

What is a requirement leaf in requirements.md?

A leaf is a requirement id with no finer-numbered child beneath it. Each leaf carries its own verification case, routed to a kind such as surface snapshot, behavior, logic, or saga.

How do I choose between snapshot, behavior, and logic test kinds?

Prefer the kind whose expected result is a visual the owner checks by sight, such as a surface snapshot or saga storyboard. Reserve behavior and logic kinds for assertions an image cannot capture, like a gesture's outgoing request or a pure product rule.

When should a requirement use an e2e singleton case?

Use a heavy e2e singleton only for the assertion that the product loads in the real environment. It runs as one case in its own lane and is never part of the default test loop.

Can multiple requirement leaves share one golden snapshot?

No, each surface snapshot leaf gets its own committed golden image even when several leaves render the same state. The one-to-one bijection between leaves and goldens stays strict.