dev-workflow

Development Workflow Plugin for Claude Code

A comprehensive Claude Code plugin for feature development, bug fixes, and PR workflows. Enforces best practices through upfront planning, parallelized subagent execution, verification agents, and workflow commands.

Features

• Upfront planning - Brainstorming and structured implementation plans before code
• Plan execution - Parallel implementation via agent teams (worktrees + mailbox) or subagents (run_in_background), auto-selected
• Git worktree support - Isolated workspaces for parallel development
• Pre-commit verification - Type checking, security scans, debug code detection
• PR review verification - SHA-anchored sticky-comment check + blocker scanning (inline gh ops, no slash command wrapper)
• Git guardrails - Blocks direct pushes to main, warns on raw merge commands
• Code review agents - Staff-level comprehensive reviews
• Context recovery - Restore state after context compaction

Philosophy

This plugin enforces three core principles:

1. Planning Before Implementation

Features start with brainstorming (Socratic exploration of requirements and design), followed by writing plans that break work into bite-sized, verifiable tasks. This catches issues early and provides clear success criteria.

2. Parallel Execution with Mode Selection

Plan execution automatically selects the best execution mode:

• Team mode (when agent teams enabled): Multiple implementers in worktrees, dedicated reviewer with mailbox communication, lead in delegate mode
• Subagent mode (default): Parallel dispatch via run_in_background, each subagent gets only what you pass it (lightweight context), independent model selection per task

Subagent mode is more efficient for well-scoped tasks — subagents start fresh with just their prompt, avoiding full context loading overhead.

3. Parallelization Through Isolation

Git worktrees + agents enable true parallel development:

• Multiple features/experiments in isolated workspaces
• Agents work independently without blocking
• Easy cleanup (delete worktree, no branch pollution)

Complete Development Workflow

flowchart TD
    subgraph FEATURE ["Feature Development Path"]
        A[New feature request] --> B[Brainstorming skill]
        B --> C["Explore requirements & design"]
        C --> D[Using-git-worktrees skill]
        D --> E[Create isolated workspace]
        E --> F[Writing-plans skill]
        F --> G["Break into tasks with acceptance criteria"]
        G --> H{Agent teams enabled?}
        H -->|Yes| I1["Plan-execution: team mode"]
        I1 --> I2["Parallel implementers + reviewer in worktrees"]
        H -->|No| I3["Plan-execution: subagent mode"]
        I3 --> I4["Parallel dispatch with lightweight context"]
        I2 --> J["Push + create PR"]
        I4 --> J
        J --> K[PR ready]
    end

    subgraph BUG ["Bug Fix Path"]
        L[Bug report] --> M[Systematic-debugging skill]
        M --> N["4-phase root cause analysis"]
        N --> O[Test-driven-development skill]
        O --> P["Red → Green → Refactor"]
        P --> Q[Commit fix]
        Q --> R["Push + create PR"]
        R --> K
    end

    subgraph MERGE ["PR Merge Workflow"]
        K --> S[CI + Reviews]
        S --> T{Approved?}
        T -->|No| U[Address feedback]
        U --> S
        T -->|Yes| V["Verify CI + SHA-anchored sticky comment"]
        V --> W["gh pr checks --watch + match Reviewed commit: SHA to head"]
        W --> X{Blockers?}
        X -->|Yes| U
        X -->|No| Y[Merge & cleanup]
    end

    style FEATURE fill:#e3f2fd
    style BUG fill:#fff3e0
    style MERGE fill:#fce4ec

Feature Development Path

Phase	Skill/Command	Purpose
1. Design	brainstorming	Socratic exploration of requirements and design trade-offs
2. Isolate	using-git-worktrees	Create isolated workspace (optional, for parallel work)
3. Plan	writing-plans	Break feature into bite-sized tasks with acceptance criteria
4. Execute	plan-execution	Parallel via agent teams or subagents (auto-selected)
5. PR & Merge	Native gh ops	gh pr checks --watch, SHA-match latest sticky comment, fix loop until ready, merge

Bug Fix Path

Phase	Skill/Command	Purpose
1. Analyze	systematic-debugging	4-phase root cause analysis (gather, hypothesize, verify, fix)
2. Test	test-driven-development	Red-green-refactor discipline
3. Commit	N/A	Commit fix with conventional message
4. PR & Merge	Native gh ops	Create PR, gh pr checks --watch, SHA-match sticky comment, merge

Git Guards

The plugin prevents common mistakes: