ai-dev

ai-dev

Strategic planning meets rapid execution. A Claude Code plugin that bridges vision-to-code workflows with main-branch development.

What's Included

• 10 Agents - Specialized AI agents for orchestration, planning, review, implementation, and research
• 20+ Commands - Strategic planning, git workflows, quality checks, and execution commands
• 7 Skills - Reusable knowledge for git, architecture, APIs, testing, performance, and strategic planning
• Strategy Templates - Ready-to-use templates for VISION.md, OKRs.md, EPICS.md

Workflow Overview

flowchart TB
    subgraph Strategic["Strategic Planning"]
        K["/ai-dev:kickoff"] --> NS["/ai-dev:north-star"]
        NS --> ST["/ai-dev:strategy"]
        ST --> ME["/ai-dev:metrics"]
        ME --> OK["/ai-dev:okrs"]
        OK --> EP["/ai-dev:epics"]
        EP --> US["/ai-dev:user-stories"]
    end

    subgraph GitHub["GitHub"]
        MS[(Milestones)]
        IS[(Issues)]
    end

    subgraph Execution["Execution"]
        PI["/ai-dev:plan-issue #123"] --> PL["/ai-dev:plan"]
        PL --> WK["/ai-dev:work"]
        WK --> RV["/ai-dev:review"]
        RV --> CP["/ai-dev:commit-push"]
    end

    subgraph Output["Output"]
        MAIN[("main branch")]
        STRAT[("/strategy/")]
    end

    EP -->|creates| MS
    US -->|creates| IS
    IS -->|reads| PI
    CP -->|pushes to| MAIN
    K -->|writes| STRAT
    SS["/ai-dev:sync-strategy"] -->|updates| STRAT
    MAIN -.->|merged PRs| SS

Philosophy

This plugin combines:

• Strategic Planning - 8-phase Socratic workflow from problem space to user stories
• Trunk-Based Development - All commits to main, no feature branches, small atomic changes
• GitHub Integration - Epics → Milestones, User Stories → Issues, bidirectional sync

Quick Start

1. Install the Plugin

# Add the marketplace
/plugin marketplace add https://github.com/drewdresser/ai-dev-settings

# Install the plugin
/plugin install ai-dev

Alternative: Clone directly

git clone https://github.com/drewdresser/ai-dev-settings.git ~/.claude/plugins/ai-dev

2. Start Using Commands

# Strategic planning (full 8-phase workflow)
/ai-dev:kickoff "My Project"

# Bridge GitHub Issue to implementation plan
/ai-dev:plan-issue #42

# Execute a plan with task tracking
/ai-dev:work plans/feature-name.md

# Commit and push to main
/ai-dev:commit-push

Command Reference

Strategic Planning

Command	Purpose
/ai-dev:kickoff	Full 8-phase strategic planning workflow
/ai-dev:north-star	Define vision, mission, and north star
/ai-dev:strategy	Define strategy and non-goals
/ai-dev:metrics	Define success metrics and failure thresholds
/ai-dev:okrs	Create quarterly OKRs
/ai-dev:epics	Create epics (→ GitHub Milestones)
/ai-dev:user-stories	Create user stories (→ GitHub Issues)

Execution Workflow

Command	Purpose
/ai-dev:plan-issue	Bridge GitHub Issue → technical plan
/ai-dev:plan	Interactive technical planning
/ai-dev:work	Execute plan with TodoWrite tracking
/ai-dev:review	Multi-agent code review
/ai-dev:sync-strategy	Sync GitHub → /strategy/ docs

Git (Main-Branch Development)

Command	Purpose
/ai-dev:commit	Create conventional commit (local)
/ai-dev:commit-push	Commit + push to main with quality gates
/ai-dev:sync	Pull latest from origin

Quality

Command	Purpose
/ai-dev:run-tests	Run test suite
/ai-dev:lint-fix	Fix linting issues
/ai-dev:security-scan	Scan for security issues

Workflow: User Story → Shipped Code

1. /ai-dev:kickoff "MyProject"
   → Creates /strategy/VISION.md, OKRs.md, EPICS.md
   → Creates GitHub Milestones and Issues

2. /ai-dev:plan-issue #123
   → Reads issue + strategic context
   → Generates plans/issue-123-feature-name.md

3. /ai-dev:work plans/issue-123-feature-name.md
   → TodoWrite task breakdown
   → Incremental commits to main
   → Final push with quality gates

4. /ai-dev:sync-strategy
   → Updates /strategy/ with GitHub state
   → Tracks epic progress

Directory Structure