plan-build-verify-github

Solid

Use this skill for multi-step, spec-driven, or acceptance-gated implementation work in a GitHub repository where specs live as GitHub Issues. Routes work through Plan, Build, and Verify phases, manages the roadmap through issue labels and sub-issues, and triages and grooms the backlog. Also handles migration from file-based specs to GitHub Issues.

AI & Automation 61 stars 6 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
60
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Plan Build Verify (GitHub) Use this skill to route implementation work through a sequential path where **GitHub Issues are the source of truth for specs**: 1. **Plan**: align with the user on intent, constraints, approach, and acceptance criteria, then publish the spec as a GitHub Issue. 2. **Build**: execute an approved spec issue. 3. **Verify**: validate completed work against the issue's acceptance criteria and post evidence to the issue. Two supporting modes manage the roadmap: 4. **Triage**: groom the issue backlog for label hygiene, missing acceptance criteria, staleness, orphaned sub-issues, and readiness. 5. **Migrate**: convert an existing file-based `docs/specs/` bundle into GitHub Issues. Most work should move through Plan → Build → Verify. Default to **Plan** unless the user explicitly directs you to execute an existing issue, verify completed work, groom the backlog, or migrate specs. When the selected phase is **Plan**, do not jump straight to a written spec. Plan starts with context exploration and user alignment. The issue records the agreed direction after the user has responded to the alignment phase and approved or redirected the recommended approach. ## Read the conventions first Before any mode, read `references/github-conventions.md` completely. It defines the repo preflight, label taxonomy, issue body template, status transitions, sub-issue mechanics, temporary body files, and the OKF integration contract. Every other reference file depends on...

Details

Author
gannonh
Repository
gannonh/kata-symphony
Created
5 months ago
Last Updated
3 days ago
Language
Rust
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

plan-dev

Use when the user wants to convert an informal task, feature request, spec, or review doc into a structured implementation plan before any code is written. User's intent is organization and sequencing — phases, dependency ordering, and GitHub issues that make work trackable and reviewable. Invoke for: 'plan this', 'break into phases', 'create issues for', 'decompose this spec', 'turn into tickets', 'what order should I tackle these', 'help me organize this work', 'structure this feature', 'plan-dev'. This is distinct from architecture analysis of existing code, how-to questions, or direct coding requests — the output is a roadmap, not code.

0 Updated today
Tamircohen28
AI & Automation Listed

spec-verify

Verify a completed feature spec by driving the real running app — not just lint/typecheck/build — and checking off every acceptance criterion from its specs/{feature}/ folder one by one. Use this after /spec-implement finishes a spec, when the user says "test this end to end", "verify this feature actually works", "did we actually build this right", or "/spec-verify", and before /spec-ship or opening a PR. This is the spec-aware sibling of the generic /verify and /run skills — /verify checks an arbitrary diff's runtime behavior and /run just launches the app, but this skill specifically reads a spec's requirements.md and task files, builds a master checklist of acceptance criteria, and reports pass/fail per criterion with real evidence (screenshots, API responses, DB state) instead of a vague "looks good." Always invoke this when a specs/{feature}/ folder exists and its implementation just finished, even if the user only says "does this work" or "test it."

1 Updated 2 weeks ago
benjaminthomas
Code & Development Listed

spec

Plan review vs Acceptance Criteria for a single GitHub issue, plus issue comment draft.

1 Updated today
sequant-io