---

name: diashort-feature-development description: Use when making changes to diashort - new features, bug fixes, refactoring, or modifications. Guides through brainstorming, planning, and subagent-driven implementation with reviews.

Diashort Development Workflow

Overview

End-to-end workflow for diashort changes: brainstorm → plan → implement with subagents → review → merge.

Core principle: Design before code, plan before implementation, review every task.

When to Use

• Adding new features or endpoints
• Fixing bugs (non-trivial)
• Refactoring or modifying existing functionality
• Any change touching multiple files
• Any change requiring tests

The Workflow

Copydigraph workflow {
    rankdir=TB;

    "User request" [shape=doublecircle];
    "Brainstorm (Q&A design)" [shape=box];
    "Write plan to docs/plans/" [shape=box];
    "Create TodoWrite for all tasks" [shape=box];
    "Per task: Implementer subagent" [shape=box];
    "Spec compliance review" [shape=diamond];
    "Code quality review" [shape=diamond];
    "Fix issues" [shape=box];
    "Mark task complete" [shape=box];
    "More tasks?" [shape=diamond];
    "Final verification (tests + types)" [shape=box];
    "Commit and push" [shape=doublecircle];

    "User request" -> "Brainstorm (Q&A design)";
    "Brainstorm (Q&A design)" -> "Write plan to docs/plans/";
    "Write plan to docs/plans/" -> "Create TodoWrite for all tasks";
    "Create TodoWrite for all tasks" -> "Per task: Implementer subagent";
    "Per task: Implementer subagent" -> "Spec compliance review";
    "Spec compliance review" -> "Fix issues" [label="issues"];
    "Spec compliance review" -> "Code quality review" [label="pass"];
    "Fix issues" -> "Spec compliance review";
    "Code quality review" -> "Fix issues" [label="issues"];
    "Code quality review" -> "Mark task complete" [label="approved"];
    "Mark task complete" -> "More tasks?";
    "More tasks?" -> "Per task: Implementer subagent" [label="yes"];
    "More tasks?" -> "Final verification (tests + types)" [label="no"];
    "Final verification (tests + types)" -> "Commit and push";
}

Phase 1: Brainstorm

REQUIRED: Load superpowers:brainstorming skill.

• Ask questions one at a time to understand requirements
• Prefer multiple choice questions
• Explore 2-3 approaches with trade-offs
• Present design in 200-300 word sections, validate each

Phase 2: Write Plan

REQUIRED: Load superpowers:writing-plans skill.

Save to: docs/plans/YYYY-MM-DD-<feature-name>.md

Plan structure:

• Goal, Architecture, Tech Stack header
• Bite-sized tasks (each 2-5 minutes)
• TDD steps: write test → run (fail) → implement → run (pass) → commit
• Exact file paths and code

Phase 3: Execute with Subagents

REQUIRED: Load superpowers:subagent-driven-development skill.

For each task:

1. Implementer subagent - implements the task
2. Spec compliance review - verifies implementation matches spec exactly
3. Code quality review - checks patterns, maintainability
4. Fix any issues, re-review until approved
5. Mark task complete in TodoWrite

Diashort Patterns

Checklist for New Endpoints

• Atom for storage (if needed)
• Flow for business logic
• Error classes with statusCode
• Route in server.ts with auth check
• Error handler in mapErrorToResponse()
• Initialize store and add to cleanup interval
• Update root / endpoint documentation
• Unit tests for atom/flow
• Integration tests for HTTP endpoints

Final Steps

1. Run bun test - all tests must pass
2. Run bunx @typescript/native-preview - no type errors
3. Commit with conventional commits (feat:, test:, docs:)
4. Push to origin/main

Quick Reference