← ClaudeAtlas

create-design-doclisted

Generate a structured engineering design doc from a refined PM feature spec. Use this skill when processing a design-doc queue item.
tomharris/engineer-agent · ★ 0 · Code & Development · score 65
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