phase-design

Coordinate the Design phase of epic-stage-workflow with task discovery and tracking updates.

3|2|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/jakekausler/claude-code-workflow --skill phase-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phase-design
Source: https://github.com/jakekausler/claude-code-workflow/tree/main/skills/phase-design
Command: npx skills add https://github.com/jakekausler/claude-code-workflow --skill phase-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This step coordinates the Design phase of epic-stage-workflow to clarify what to build and how to approach it.

Core Features & Use Cases

  • Task discovery via task-navigator (Haiku) to obtain a concrete task card
  • Context gathering with Explore to build system and codebase context
  • Optional brainstorming via brainstormer (Opus) when multiple viable approaches exist
  • Coordination and tracking updates via doc-updater to finalize design phase artifacts and update epic stage status

Quick Start

Initiate the Design phase by gathering task context, evaluating approaches, and updating tracking documents.

Frequently Asked Questions about phase-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the design phase in an epic workflow and when do I need it?

The design phase coordinates context gathering and approach appraisal for an epic workflow. You need it when a new task requires clarifying what to build and how to approach it before starting the build stage.

How do I gather codebase context before starting a build phase?

To gather codebase context before a build phase, the design phase delegates context gathering to Explore and uses task-navigator to obtain a concrete task card for the upcoming work.

How do I evaluate multiple architecture options for a new feature?

To evaluate multiple architecture options for a new feature, the design phase provides optional brainstorming via brainstormer when multiple viable approaches exist, allowing you to appraise different paths before finalizing design artifacts.

Do I need to update tracking documents after completing the design phase?

Yes, you need to update tracking documents after completing the design phase. It mandates coordination via doc-updater to finalize design phase artifacts and update epic stage status for alignment before build.

Can I use brainstorming for task discovery instead of just architecture options?

Brainstorming is reserved for appraising multiple viable architecture approaches, not task discovery. Task discovery is handled separately by task-navigator to obtain a concrete task card for the work.

What are the limitations of skipping the design phase in an epic workflow?

Skipping the design phase means missing mandatory context gathering, approach appraisal, and alignment before build. It bypasses required updates to epic stage tracking documents, risking unclear build scope and undocumented architecture decisions.