implement-spec

Solid

Implement an existing spec through committed passes. Use for long or multi-pass specs that need maintenance checkpoints to periodically clean code, handoffs, priorities, and plan bloat before drift accumulates.

Testing & QA 46 stars 4 forks Updated yesterday Apache-2.0

Install

View on GitHub

Quality Score: 84/100

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

Skill Content

# Implement Spec Build the active spec to completion, one reviewable pass at a time. The spec is the source of truth, but the architecture is allowed to improve when the code teaches you the plan is stale. A pass (usually one slice) is a **commit checkpoint, not a stopping point.** The job is the whole spec — every slice, every global TODO — not the first green commit. Finishing a pass means starting the next one, not handing back to the user. Only stop when the spec is fully implemented (or a genuine blocker needs a decision only the user can make). **Work in parallel wherever the graph allows.** Do not walk the ladder one slice at a time when slices are independent. Read the spec's dependency graph as a wavefront and **delegate independent passes to subagents that run concurrently** (see Rules) — you orchestrate and integrate; only serialize what genuinely depends on prior work. ## Workflow 1. Read the repo README, the spec README, and the next slice before editing. Load any skills named by the spec. Identify the current pickup point, global TODOs, required gates, and what must stay green. If a multi-slice spec lacks a live handoff prompt, add one before the first pass ends. 2. Reconcile the plan with the current code. If the slice would preserve a development-only shim, duplicated type, weak wrapper, or obsolete path, replace it with the simpler architecture and update the spec handoff. 3. Implement one coherent pass: usually one slice, one vertical che...

Details

Author
dzhng
Repository
dzhng/duet-agent
Created
5 months ago
Last Updated
yesterday
Language
TypeScript
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

implement-spec

Runs a spec to completion without mid-run questions — each step mined for the existing pattern, gated green, committed before the next begins. Use it to implement from docs/specs/<id>.md, or when asked to build something unattended. Decisions go to the ledger rather than to the human.

0 Updated 1 weeks ago
AlpayC
Code & Development Solid

write-spec

Break large features into independently verifiable, human-reviewable slices under specs/<feature>/. Use for risky or multi-step feature work that needs upfront questioning, API seams, browser-playable checkpoints, HTML visualizations, screenshot gates, staged implementation plans, recursive fog-of-war reslicing, or proactive research into reference implementations/best practices before slicing. Pairs with your project's verification harness and screenshot gates (the browser checkpoints), [refactor-clean](../refactor-clean/SKILL.md) (review the materialized spec so the plan describes one-owner architecture, not the feature bolted on), [screenshot-critique](../screenshot-critique/SKILL.md) and [compare-screenshots](../compare-screenshots/SKILL.md) (the visual gates), and a code-review pass (audit each slice before it lands).

46 Updated yesterday
dzhng
Testing & QA Solid

implement-spec-with-codex

Run [implement-spec](../implement-spec/SKILL.md) with Codex doing the implementation passes while you orchestrate, integrate, and review. Use when the user asks to implement a spec with Codex, or to run implement-spec with Codex as the implementer.

46 Updated yesterday
dzhng