Learn-skills.dev spec-kit-implement
Use when approved Spec Kit `tasks.md` must be executed into implementation changes, or when task execution is blocked by sequencing/checklist gates before feature completion.
install
source · Clone the upstream repo
git clone https://github.com/NeverSight/learn-skills.dev
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/ahgraber/skills/spec-kit-implement" ~/.claude/skills/neversight-learn-skills-dev-spec-kit-implement && rm -rf "$T"
manifest:
data/skills-md/ahgraber/skills/spec-kit-implement/SKILL.mdsource content
Spec Kit Implement
Execute approved feature tasks in dependency order and keep
tasks.md status accurate.
When to Use
exists and you need to execute it phase-by-phase to deliver the feature.tasks.md- Implementation work has started, but task sequencing, checklist gates, or progress tracking is inconsistent.
- You need deterministic execution behavior before handoff or release readiness checks.
When Not to Use
does not exist yet (tasks.md
first).spec-kit-tasks- You are still writing or revising requirements/design artifacts (
,spec-kit-specify
,spec-kit-clarify
).spec-kit-plan - You need read-only consistency analysis rather than execution (
).spec-kit-analyze - You need coordinated artifact remediation after gaps are discovered (
).spec-kit-reconcile
Router Fit
- Primary route from
afterspec-kit
.spec-kit-tasks - Requires planning + task artifacts for the active feature branch.
- Routes execution-discovered artifact drift to
.spec-kit-reconcile
Preconditions
- Run from repository root (or a subdirectory inside it).
- Active feature context resolves to a single
directory.specs/<feature>/
reflects the current approvedtasks.md
.plan.md
Workflow
-
Resolve feature artifacts and enforce implementation gate:
- Run
exactly once.scripts/check-prerequisites.sh --json --require-tasks --include-tasks - Parse
andFEATURE_DIR
.AVAILABLE_DOCS - Derive:
TASKS = FEATURE_DIR/tasks.mdIMPL_PLAN = FEATURE_DIR/plan.md
- If prerequisites fail:
- missing
: stop and route totasks.mdspec-kit-tasks - missing
: stop and route toplan.mdspec-kit-plan
- missing
- Run
-
Enforce checklist gate when checklists exist:
- If
exists, scan all checklist files.FEATURE_DIR/checklists/ - If any unchecked items remain, stop and ask whether to proceed anyway.
- Continue only after explicit user approval.
- If
-
Load execution context:
- Required:
,tasks.md
.plan.md - Optional (when present):
,data-model.md
,contracts/
,research.md
.quickstart.md - Use these artifacts as source of truth; do not invent scope beyond them.
- Required:
-
Verify ignore-file coverage for active tooling:
- Check relevant ignore files (
,.gitignore
,.dockerignore
,.eslintignore
, etc.)..prettierignore - Add only missing critical patterns; preserve existing user/project conventions.
- Check relevant ignore files (
-
Parse
into an execution plan before running tasks:tasks.md- Extract phase boundaries and phase intent (setup/foundational, user-story phases, polish).
- Extract per-task fields: task ID, description, file path,
marker, and optional[P]
label.[US#] - Build dependency order from task IDs, phase ordering, and explicit sequencing notes.
- Treat this parsed structure as execution truth for progress and failure handling.
-
Execute tasks in phase order:
- Respect ordering and dependency constraints from
.tasks.md - Run
tasks in parallel only when there is no file overlap or dependency coupling.[P] - Follow tests-before-implementation ordering where test tasks exist.
- Complete each phase before moving to the next:
- setup/foundational work first,
- then user-story phases in priority order,
- polish and cross-cutting validation last.
- Respect ordering and dependency constraints from
-
Track progress and failures continuously:
- After each completed task, mark it
in[X]
immediately.tasks.md - Halt on critical sequential task failures and report the blocking context.
- For parallel batches, keep successful items moving and report failed tasks with next actions.
- After each completed task, mark it
-
Run completion checks:
- All required tasks are complete.
- Implementation aligns with
/spec.md
intent.plan.md - Required tests/validation pass per project constraints.
- If gaps remain (for example missing wiring, acceptance mismatch, integration drift), route to
with a concrete gap report.spec-kit-reconcile
-
Report implementation result:
- Absolute path to
.tasks.md - Completed vs remaining task counts.
- Checklist gate outcome (if used).
- Final status and recommended next step.
- Absolute path to
Output
- Updated
completion state for the active feature.tasks.md - Implementation progress summary with blockers/failures (if any).
- Final readiness signal for post-implementation verification/review.
Key Rules
- Treat
ordering as execution truth.tasks.md - Never mark a task
before its work and validations are complete.[X] - Do not run
tasks concurrently when they touch the same files or dependent resources.[P] - Stop and reroute when prerequisite artifacts are missing or invalid.
- Do not patch spec/plan/tasks ad hoc during execution; use
for structured remediation.spec-kit-reconcile
Common Mistakes
- Starting implementation with stale or missing
.tasks.md - Skipping checklist acknowledgment when unresolved checklist items exist.
- Forgetting immediate
updates in[X]
, causing drift between reality and artifact state.tasks.md - Running
tasks together despite file/dependency conflicts.[P] - Continuing past critical sequential failures instead of stopping and reporting.
- Editing
/spec.md
/plan.md
informally during implementation instead of routing remediation throughtasks.md
.spec-kit-reconcile
References
for implementation execution logic workflowreferences/spec-kit-implement-flow.dot
for overall context of how the implementation fits into the Spec Kit process.references/spec-kit-workflow.dotscripts/check-prerequisites.shhttps://github.com/github/spec-kit/blob/9111699cd27879e3e6301651a03e502ecb6dd65d/templates/commands/implement.md