writing-plans

Files (1)

• SKILL.md

SKILL.md (first lines)

# Writing Plans

This is an internal meta skill. Humans should not need to reference it directly.

## Purpose

Turn an approved design into a concise execution plan that is specific enough to implement without re-deciding the architecture mid-flight.

## Core Rule

The plan is not another intent-clarification pass.

Once the design is approved, convert it into a checklist of concrete implementation steps, verification steps, and test-first seams.

## Workflow

1. Read the approved design and current codebase shape.
2. Lock the file and responsibility boundaries that matter for implementation.
3. Break the work into small steps that can be tracked and verified.
4. Call out the test-first seam for each meaningful behavior change.
5. Mark which steps can be delegated in parallel and which must stay sequential.
6. Group the steps into explicit execution groups when multiple seams are independent enough to run in different agents.
7. Make the plan easy to approve, execute, and keep updated through compaction.

## Plan Quality

Good plans are:

- specific about what changes
- small enough to track honestly
- sequenced in dependency order
- explicit about parallel versus sequential execution
- explicit about execution groups when delegation is likely
- explicit about verification
- free of placeholders and vague follow-ups

## Guardrails

- Do not leave the plan at the level of generic intentions.
- Do not mix multiple independent projects into one checklist.
- Do not plan broad refactors that the approved design did not justify.
- Do not skip the test-first angle for behavior changes.

## Output

Produce a concise checklist that `build` can present and maintain at `.opencode/darwin-build-plan.md`.

When useful, include an `Execution Groups` section such as:

```md
## Execution Groups
- Group A: data + mapping
- Group B: state + view model
- Group C: UI integration
- Integration step: wire outputs together and verify
```

From tykowale/darwin, MIT.

More from tykowale/darwin