dev-cycle

Dev Cycle - Development Session Manager

Orchestrated development workflow: Discovery → Planning → Review → Build

Agent Roles

• Scout: Codebase Explorer - explores before planning (haiku, fast, cheap)
• Bob: Technical Builder - builds code, ensures quality
• Garry: Chief of Staff - validates completion, checks alignment
• Arlo: Pattern Whisperer - involved when data/analytics/numbers are part of the work

Session State

Sessions are stored in ~/.claude/dev-cycles/active/ and ~/.claude/dev-cycles/completed/

Starting a Session

1. Check for Active Session

ls ~/.claude/dev-cycles/active/ | grep "$(basename $(pwd))"

If active session exists for this project:

• Read the session file
• Show current status (phase, completed tasks, blockers)
• Ask: "Continue this session or start new?"

2. Start New Session

Ask these questions in order:

1. Branch: "Work on existing branch, create new, or no branch?"

   • If existing: git branch -a to show options
   • If new: Ask for branch name (follow branch-workflow conventions)
   • If none: Work on current branch

2. Scope: "What are we building?"

   • Get clear description
   • For small tasks: Can collapse Discovery+Planning

3. Create session file:

~/.claude/dev-cycles/active/{project-name}--{YYYYMMDD-HHMMSS}.md

Session File Format

# Dev Cycle: {description}

## Meta
- **Project**: {project-name}
- **Branch**: {branch-name or "none"}
- **Started**: {timestamp}
- **Phase**: discovery | planning | review | building | blocked
- **Involves Data/Analytics**: yes | no

## Discovery
{Requirements, context, decisions made during discovery}

## Plan
{Tasks with checkboxes, phases, acceptance criteria}

## Progress
- [x] Task 1 - completed
- [ ] Task 2 - current
- [ ] Task 3 - pending

## Blockers
{Any blockers encountered - stop and ask the user}

## Batched Questions
{Easy questions to ask after build is done}

## Decisions
{Key decisions made during this session}