---
description: Show detailed information about a specific plan from PLANS.md
agent: Build+
mode: subagent
---

<!-- SPDX-License-Identifier: MIT -->
<!-- SPDX-FileCopyrightText: 2025-2026 Marcus Quinn -->

Arguments: $ARGUMENTS

## Quick Output (Default)

```bash
~/.aidevops/agents/scripts/show-plan-helper.sh $ARGUMENTS
```

Display the output directly to the user. The script handles all formatting.

## Fallback (Script Unavailable)

1. Read `todo/PLANS.md`
2. Find the matching plan section by fuzzy title match or plan ID
3. Extract and format all sections (Purpose, Progress, Decisions, etc.)
4. Find related tasks in `TODO.md`

## Arguments

**Plan identifier (required unless --list or --current):**
- Plan name (fuzzy match): `opencode`, `destructive`, `beads`
- Plan ID: `p001`, `p002`, etc.

**Options:**
- `--current` - Show plan related to current git branch
- `--list` - List all active plans briefly
- `--json` - Output as JSON

## Examples

```bash
/show-plan opencode              # Show aidevops-opencode Plugin plan
/show-plan p001                  # Show plan by ID
/show-plan --current             # Show plan for current branch
/show-plan --list                # List all plans
/show-plan "destructive"         # Fuzzy match "Destructive Command Hooks"
/show-plan beads                 # Show Beads Integration plan
```

## Output Format

Script outputs formatted Markdown with:
- Status, Estimate, Progress phases (checkboxes)
- Purpose, Context
- Decisions (with Rationale + Date)
- Discoveries (with Evidence + Impact)
- Related Tasks
- Numbered options: 1=start work, 2=view another plan, 3=back to `/list-todo`

## After Display

1. **"1"** - Begin working on the plan:
   1. Run `~/.aidevops/agents/scripts/pre-edit-check.sh`
   2. Create safe linked worktree if needed: `wt switch -c feature/<plan-slug>`
   3. Update plan status: `**Status:** Planning` → `**Status:** In Progress (Phase 1/N)`, add `started:` timestamp
   4. Display first phase description and any blockers
2. **"2"** - View another plan → prompt for name, run `/show-plan <name>`
3. **"3"** - Return to task list → run `/list-todo`

## Related Commands

- `/list-todo` - List all tasks and plans
- `/save-todo` - Save current discussion as task/plan
- `/ready` - Show tasks with no blockers
