1-plan

Writes falsifiable implementation plans with acceptance criteria to docs/work/<slug>/plan.md before any code exists.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/AiFirstDevelopment/quorum --skill 1-plan-aifirstdevelopment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 1-plan
Source: https://github.com/AiFirstDevelopment/quorum/tree/main/plugins/quorum/skills/1-plan
Command: npx skills add https://github.com/AiFirstDevelopment/quorum --skill 1-plan-aifirstdevelopment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding sessions often produce plausible code with no written record of what was actually requested, making it impossible to verify the result against the original intent. This Skill forces intent, acceptance criteria, and non-goals to be written down in testable terms before any code is written, creating a fixed target the rest of the delivery pipeline can be measured against. ## Core Features & Use Cases - Branch and work-item resolution: Settles which work item a request belongs to, creates or reuses the appropriate git branch, and derives a kebab-case slug that names all downstream artifacts. - Structured plan authoring: Writes docs/work/<slug>/plan.md with verbatim prompt, intent, falsifiable acceptance criteria, non-goals, open questions, numbered verifiable claims, ordered steps, and optional mermaid diagrams. - Approval gate with state recording: Holds an explicit human approval checkpoint, fingerprints requirements via a requirements hash, and records pipeline state so later steps can prove the target never moved. - Use Case: A developer asks for a webhook retry feature. The Skill creates a feature branch, investigates the repository, writes a plan with observable acceptance criteria, and waits for explicit approval before any build step runs. ## Quick Start Ask the AI to plan a change, for example: run /quorum:1-plan with a description of what to build, then review the written plan and approve it.

Frequently Asked Questions about 1-plan

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

FAQPage Schema
How do I write acceptance criteria an AI pipeline can verify?▼

Write acceptance criteria as observable, testable statements in the form "when <situation>, <observable result>" that someone who did not write the code can check by operating the assembled application. Each criterion must describe how it could be observed failing, otherwise it is not falsifiable and must be rewritten.

How do I plan a code change before letting an AI write code?▼

Run the planning step with a description of what to build. It resolves the work branch, investigates the repository, and writes a plan containing intent, acceptance criteria, non-goals, open questions, and ordered steps to docs/work/<slug>/plan.md, then waits for your explicit approval.

Does the planning step write any production code?▼

No, the planning step writes no production code, test code, or dependency changes. Its only git write is creating or switching the work branch; all output is the markdown plan file and a state record.

What happens if I run the plan command with no description?▼

Running it with no argument means a plan already exists for the current slug. The Skill reads the existing plan, shows its intent, acceptance criteria, non-goals, and open questions, and holds the approval gate rather than planning something new.

When should a plan include a mermaid diagram?▼

Include a mermaid diagram when the change involves branching control flow, components communicating across boundaries, lifecycle state transitions, or reshaped persisted data. Omit it for small changes where the diagram would only restate the prose.