From three-pillars
Produce a detailed-design.md from an existing design.md. Maps high-level entities and behaviors to concrete modules, interfaces, and test boundaries.
How this skill is triggered — by the user, by Claude, or both
Slash command
/three-pillars:tp-design-detail {design-name} [--auto] [--force-takeover]{design-name} [--auto] [--force-takeover]The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Turn a high-level design into a concrete implementation blueprint.
Turn a high-level design into a concrete implementation blueprint.
Argument: {design-name} (required) — must match an existing directory under three-pillars-docs/tp-designs/.
three-pillars-docs/tp-designs/{design-name}/design.md must exist. If not, tell the user to run /tp-design {design-name} first and stop.Run first-run preflight per skills/_shared/first-run.md.
Run collaboration preflight per skills/_shared/collaboration.md with phase: "detail". This verifies the branch and refreshes the lock for this design. Honor --force-takeover if passed.
1b. Repo-map preamble (optional) per skills/_shared/repo-map-preamble.md. If aider is on PATH, generate a structural map of the codebase before exploration. The map informs which files are load-bearing per PageRank — use it to focus the Explore agent / Grep / Glob calls in step 3 instead of scanning blind.
Read design.md from the design directory.
Explore the codebase to understand existing patterns, conventions, and integration points. Use the Explore agent or Grep/Glob as needed. Understand where the new code will live and what it will touch.
Read project docs per skills/_shared/read-project-docs.md.
Have a conversation with the user to resolve any open questions from design.md and make key implementation decisions:
Write three-pillars-docs/tp-designs/{design-name}/detailed-design.md with this structure. If design.md carries a weight-class frontmatter block, stamp the same class onto this artifact (python3 -c "import sys; sys.path.insert(0,'skills/_shared'); from weight_class import write_class; write_class('<artifact>', '<class>')" or write the ---\nweight-class: <class>\n--- block directly at the top):
# <Design Name> — Detailed Design
## Module Structure
Where the code lives. File paths, new modules, relationship to existing code.
Size the boundaries here: caps per `CLAUDE.md` §File Size Limits — when a proposed module or its test file would plausibly exceed the soft-warn, split the boundary at design time (by responsibility), not at implement time.
## Interfaces
Public APIs with signatures. For each:
- Function/method signature
- Input/output types
- Key behaviors and edge cases
## Data Flow
How data moves through the system. Reference existing pipeline stages if applicable.
## Test Strategy
For each interface:
- What to test (happy path, edge cases, error conditions)
- Unit vs integration
- What to mock and why
## Upstream Design Dependencies
Other TDD designs this depends on (by name), what it needs from each, and minimum viable criteria (what must exist before implementation can proceed). Reference the Dependencies section from design.md and make concrete.
## Dependencies
- Internal: existing modules this touches
- External: new packages (with versions if known)
## Implementation Order
Ordered list of what to build first → last, grouped by natural phases.
Each phase should be independently testable.
## Decisions
Key implementation choices made during this design and their rationale.
skills/_shared/commit-after-work.md. Artifact paths to stage:
three-pillars-docs/tp-designs/{design-name}/detailed-design.mdthree-pillars-docs/tp-designs/{design-name}/lock.json (rolled into the same commit)
Commit message: Design: {design-name} detailed./tp-plan {design-name}.{design-name} per skills/_shared/validate-name.md.skills/_shared/collaboration.md — the preflight step can refuse to proceed if another developer holds this design.detailed-design.md and ask before overwriting.--auto is Shape B per skills/_shared/auto-mode.md — a generator skill: produce the artifact without human Q&A and log every judgment call.
In --auto:
design.md, the codebase exploration in step 3, and the project docs read in step 4.three-pillars-docs/tp-designs/{design-name}/decisions.md using the canonical init/append snippet in skills/_shared/auto-mode.md. Use [tp-design-detail] as the bare skill-name prefix.detailed-design.md already exists, overwrite without asking and log the overwrite as a decision.decisions.md entry. Do not re-document here.decisions.md alongside the artifact in the commit (step 7).Contract: in --auto, this skill never prompts; the trail of judgment calls lives in decisions.md for human review.
npx claudepluginhub curtisthe/three-pillars-plugin --plugin three-pillarsProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.