create-design-doclisted
Install: claude install-skill tomharris/engineer-agent
# Create a Design Doc
Generate a comprehensive engineering design doc from a PM's feature spec, incorporating any prior spec refinement Q&A.
## Tools Needed
- `mcp__slite__get-note` — fetch spec and optional template from Slite
- `mcp__slite__create-note` — create the design doc on approval
- `Read`, `Write` — read/write queue items and source code
- `Grep`, `Glob` — explore codebase architecture, find implementations and patterns
- `mcp__atlassian__searchJiraIssuesUsingJql` — find dependency tickets
- `mcp__atlassian__getJiraIssue` — read ticket details
## Input
A queue item file in `~/.local/share/engineer-agent/queue/incoming/` with type `design-doc`, containing the spec content in `## Context`. The frontmatter may include `spec_refinement_id` linking to a completed spec-refinement for additional Q&A context.
## Steps
### 1. Gather Context
Read the queue item's `## Context` section for the spec content. Extract the `project` field from frontmatter.
Read `~/.local/share/engineer-agent/engineer.yaml` to find the project config at `projects.<project>` for codebase path and Slite settings.
If `spec_refinement_id` is present in the frontmatter, search `~/.local/share/engineer-agent/queue/completed/` for a matching spec-refinement item (by `source_id`). Extract the Q&A from its `## Draft Response` — the filled-in `_Answer:_` fields provide critical context from PM conversations.
### 2. Determine Template
Check the queue item frontmatter or config for a template:
- I