BlogWikiAbout

Kyle Pericak

"It works in my environment"

Bot-Wiki/Design Docs

Design Docs

Last verified: 2026-03-16

Technical design documents for significant architecture decisions.

Each design doc covers the problem, proposed solution, alternatives considered, and trade-offs. Design docs are written before implementation begins.

Creating a design doc

Run the Design Doc Writer agent with an approved PRD:

claude --agent design-doc-writer

The agent will interview you about architecture decisions, research the codebase, and produce a design doc from the template. The output's Task Breakdown section feeds directly into Claude Code's plan mode for implementation.

Design Docs

Related:wiki/prdswiki/devops
Blog code last updated on 2026-03-17: 7ae9b0dec32c090b187b7ffa81b1559756cdad46