agent-11: Command for Claude Code

/plan - Project State Management

Purpose: Primary interface for viewing and managing project state. Provides real-time insights into progress, quality gates, and next actions.

Usage: /plan [subcommand] [args]

Available Subcommands:

• status - Show current phase, task, progress, blockers
• next - Show what's coming up
• phase [N] - Show details for specific phase
• gate [N] - Show quality gate status for phase
• update [field] [value] - Update plan field
• archive - Archive completed phases to reduce context

Command Implementation

Prerequisites

Before executing any /plan command:

1. Verify project-plan.md exists (created by /bootstrap)
2. Validate plan structure against project/schemas/project-plan.schema.yaml
3. Check for .context/phase-N-context.yaml files for active phases

Error Handling

Common Errors:

• No project-plan.md: "No project plan found. Run /bootstrap to generate one."
• Invalid schema: "Project plan validation failed. Check against schema at project/schemas/project-plan.schema.yaml"
• Phase not found: "Phase N not found. Available phases: 1-{total}"
• Invalid field: "Field '{field}' not recognized. Valid fields: task_status, blockers, current_focus"

---

Subcommand: /plan status

Purpose: Display current project state at a glance.

Algorithm:

1. Read project-plan.md YAML frontmatter
2. Parse metadata:
   - project_name
   - total_phases
   - current_phase
   - current_task (from current phase)
3. Calculate progress metrics:
   - overall_progress = completed_tasks / total_tasks
   - phase_progress = completed_tasks_current_phase / total_tasks_current_phase
4. Read .context/phase-{current_phase}-context.yaml for:
   - blockers
   - next_action
   - quality_gate_status
5. Format and display output

Output Format:

📊 Project: {project_name}
📍 Phase: {current_phase}/{total_phases} - {phase_name}
📋 Task: {current_task}/{total_tasks_phase} - {task_description}
🎯 Progress: {overall_progress}% overall, {phase_progress}% current phase

⚠️ Blockers: {blockers_list or "None"}
➡️ Next Action: {next_action}

🚦 Quality Gates:
- Phase 1: {status_emoji} {STATUS} ({passed}/{total})
- Phase 2: {status_emoji} {STATUS} ({passed}/{total})
...

Status Legend:
✅ PASSED - All gates passed
🟡 IN PROGRESS - Some gates pending
❌ FAILED - One or more gates failed
⏸️ NOT STARTED - Phase not yet begun