# Plan List
No more hunting through documents or wikis. The Plan List shows you **every plan across your entire workspace**—with requirement counts, task counts, and status badges that tell you what's ready for execution and what's still in draft.

{{< thumbcard src="/images/ui/plans/plan-list-overview.png" alt="Plan list with project filter and search" caption="5 plans across 2 projects, filterable in seconds—this is what planning visibility looks like" >}}

## What this page covers

- Project and search filters
- Table columns and sorting
- Status indicators
- Creating new plans

## Filters that actually help

### Project filter

Working across multiple projects? Use the **Project** dropdown to focus on plans for a specific project. Select "All Projects" when you need the complete picture—like during quarterly planning or portfolio reviews.

### Search

Find any plan instantly:
- Plan key: `plan_20251226_003`
- Title fragment: `JSDoc`
- Project name: `test-planner`

Results update as you type. No waiting, no page reloads.

## Table columns that tell the story

| Column | What it shows | Why it matters |
|--------|---------------|----------------|
| **Plan** | Key and title | Full context without clicking |
| **Status** | Draft, Approved, or Archived | Know what's ready for execution |
| **Requirements** | Count of requirements | Scope indicator at a glance |
| **Tasks** | Count of generated tasks | Execution coverage visible |
| **Project** | Parent project | Cross-project visibility |
| **Updated** | Last change | Spot stale plans immediately |

**Click any column header to sort.** Click again to reverse. Most developers sort by Updated (default) to see recent plans first, or by Status to find approved plans ready for work.

## Plan rows: everything you need, no clicks required

Each row shows you:

- **Plan key** — Unique identifier for reference and search
- **Title** — What this plan accomplishes
- **Status badge** — Color-coded: draft (gray), approved (green), archived (muted)
- **Requirements** — How many requirements this plan defines
- **Tasks** — How many tasks were generated from this plan
- **Project** — Where this plan belongs
- **Updated** — When something last changed

See a plan that needs attention? Click the row to open the full [Plan Detail](../plan-detail/) view.

## Creating new plans

Click the **+** button next to the project filter to open the [Planner](../../planner/). Plans created through the Planner include:

- Structured idea and constraints
- Success criteria
- Design section (problem, approach, risks)
- Generated requirements with scenarios
- Generated tasks with acceptance criteria

> [!TIP]
> **Better than blank documents:** The Planner guides you through structured planning so every plan has the same anatomy. No more "what should I include?" questions.

## Pagination: scale without slowdown

Large plan libraries stay fast with pagination:

- **Rows per page** — 10, 25, or 50 (pick your preference)
- **Page navigation** — Prev/Next buttons, current page indicator
- **Total count** — "Showing 1–5 of 5" so you always know the full scope

Even with dozens of plans, the list loads instantly.

## Workflows that work

### Finding approved plans ready for execution

1. Sort by **Status**
2. Look for **Approved** badges
3. Check **Tasks** column—plans with tasks are ready for agent work

### Reviewing plan coverage

1. Filter to your project
2. Check **Requirements** vs **Tasks** columns
3. Plans where Tasks < Requirements may have incomplete coverage

### Quarterly planning review

1. Keep "All Projects" selected
2. Sort by **Updated** descending
3. Review recent plans to understand current priorities

One view, complete planning visibility. No document aggregation required.

## Next steps

- **[Plan Detail](../plan-detail/)** — Dive deep into individual plans
- **[Planner](../../planner/)** — Create new plans with structured guidance

**Try it now:** Open Plans, find an approved plan, and click through to see how requirements trace to tasks.