Skip to main content
ClaudeWave
Skill292 repo starsupdated 1mo ago

implement

The implement skill serves as the entry point dispatcher for executing completed specifications in the startup framework. It automatically detects which decomposition tier (Direct, Incremental, or Factory) is present by inspecting spec artifacts like plan directories and manifest files, then routes execution to the appropriate sub-skill without performing implementation logic directly. Use this skill when you have a finalized specification ready for code generation and need automatic detection of the correct execution strategy.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/rsmdt/the-startup /tmp/implement && cp -r /tmp/implement/plugins/start/skills/implement ~/.claude/skills/implement
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

## Persona

Act as the implementation entry-point dispatcher. Resolve the spec, detect which decomposition artifacts are present, hand off to the matching execution sub-skill. You do not orchestrate implementation directly — every loop body lives in a sub-skill.

**Implementation Target**: $ARGUMENTS

## Interface

DispatchTarget {
  tier: Direct | Incremental | Factory
  skill: implement-direct | implement-incremental | implement-factory
  artifact: string                // path that triggered the dispatch
}

State {
  target = $ARGUMENTS
  specDirectory: string           // resolved .start/specs/NNN-name/ path
  artifacts: {
    plan?: string                 // path to plan/README.md if present
    manifest?: string             // path to manifest.md if present
    requirements?: string         // path to requirements.md
    solution?: string             // path to solution.md
  }
  dispatch: DispatchTarget
}

## Constraints

**Always:**
- Resolve the spec via the specify-meta skill before inspecting artifacts.
- Detect artifacts before dispatching — do not assume a tier.
- Pass `$ARGUMENTS` through unchanged to the sub-skill.
- When multiple decomposition artifacts coexist (both `plan/` and `manifest.md`), ask the user which to run.
- Surface what was detected so the user can confirm the dispatch target.

**Never:**
- Implement code directly — sub-skills own all execution logic.
- Run two sub-skills in parallel — pick one tier per `/start:implement` invocation.
- Modify spec artifacts during dispatch — that is each sub-skill's responsibility.

## Reference Materials

This skill is a thin dispatcher and has no reference materials of its own.
Each sub-skill owns its references, examples, and templates:

- [implement-direct](../implement-direct/SKILL.md) — phase-less orchestrator for low-complexity work
- [implement-incremental](../implement-incremental/SKILL.md) — linear phase loop for single-feature plans
- [implement-factory](../implement-factory/SKILL.md) — factory loop with information barriers and retry

## Workflow

### 1. Resolve Spec

Use the specify-meta skill with `$ARGUMENTS` to resolve `specDirectory`. The `--read` output reveals which artifacts exist via the `plan_dir`, `plan`, `manifest`, `units`, and `scenarios_*` keys.

If `$ARGUMENTS` is a file path or freeform brief (no spec ID), skip spec-meta resolution. Treat this as a direct-mode invocation and route to `implement-direct`.

### 2. Detect Artifacts

Inspect the resolved spec directory for decomposition artifacts:

```
manifest_md    = exists(specDirectory / "manifest.md")
plan_readme    = exists(specDirectory / "plan" / "README.md")
requirements   = exists(specDirectory / "requirements.md")
solution       = exists(specDirectory / "solution.md")
```

### 3. Dispatch

Apply the routing rules:

```
match (artifacts) {
  manifest_md exists AND NOT plan_readme   => use the implement-factory skill
  plan_readme exists AND NOT manifest_md   => use the implement-incremental skill
  manifest_md exists AND plan_readme       => ask the user under header "Pipeline":
                                                Factory      — run factory loop on manifest.md
                                                Incremental  — run phase loop on plan/
                                                Abort        — exit without action
  none of the above
    AND (requirements OR solution exists)  => use the implement-direct skill
  none of the above AND no specs           => Error: no specification artifacts found.
                                              Run the specify skill first, or pass a brief.
}
```

Before invoking the sub-skill, present a one-line dispatch summary to the user:

```
Detected: manifest.md → routing to implement-factory
```

```
Detected: plan/README.md → routing to implement-incremental
```

```
Detected: only requirements.md and solution.md → routing to implement-direct
```

### 4. Hand Off

Use the chosen sub-skill (`implement-direct`, `implement-incremental`, or `implement-factory`) with the same `$ARGUMENTS`.

Each sub-skill is self-contained: it reads its own artifacts, runs its own loop, and reports its own completion summary. The dispatcher does not post-process sub-skill output.

### Notes on tier mismatch

If the spec README decision log records a tier (e.g., "Decomposition tier: Incremental") but the corresponding artifact is missing (e.g., no `plan/` directory), report the mismatch to the user before falling through to the next available tier. This typically indicates an interrupted specify run — the user should re-run the specify skill for that spec to complete decomposition, or explicitly choose a different tier.
analyzeSkill

Deep-dive codebase analysis that explains how things actually work — business rules, architecture patterns, auth flows, data models, integrations, and performance hotspots. Use whenever the user asks "how does X work", "map the Y flow", "what are the business rules for Z", "trace the auth path", "explore the codebase for patterns", "find all [domain concept]", or needs mechanism-level understanding before making a change. Produces What/How/Why findings with file:line evidence, cross-cutting connections, and clean-solution recommendations first.

brainstormSkill

You MUST use this before any creative work — creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements, and design before implementation.

constitutionSkill

Create or update a project constitution with governance rules. Uses discovery-based approach to generate project-specific rules.

debugSkill

Systematically diagnose and resolve bugs through conversational investigation and root cause analysis

documentSkill

Generate and maintain documentation for code, APIs, and project components

implement-directSkill

Lightweight implementation orchestrator for low-complexity work — fixes, refactors, doc changes, or single-AC features that do not warrant a phase plan or factory decomposition.

implement-factorySkill

Factory loop orchestrator for multi-feature or multi-component implementation manifests. Use for high-complexity work with parallel-eligible workstreams and holdout-scenario evaluation.

implement-incrementalSkill

Linear phase-loop orchestrator for single-feature implementation plans. Use for medium-complexity work where transparent human-in-the-loop phase review is preferred over factory automation.