# Plan Dashboard

> Scan planning documents, parse YAML frontmatter, and regenerate docs/planning/*/_index.md dashboard files with current pipeline status summaries.

- Skill: `dejanvasic85/plan-dashboard` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dejanvasic85/plan-dashboard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dejanvasic85/plan-dashboard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: dejanvasic85 (https://skillmd.com/u/dejanvasic85)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dejanvasic85/plan-dashboard

---


# Skill: plan-dashboard

## Trigger

Use this skill when the user says:

- "update dashboard"
- "show pipeline status"
- "what's the status"
- "planning status"
- invokes `/plan-dashboard`

## Purpose

Scan all planning documents, parse their YAML frontmatter, and regenerate the two `_index.md` dashboard files with current status summaries.

## Output

Updates both dashboard files:

- `docs/planning/ideas/_index.md`
- `docs/planning/plans/_index.md`

## Workflow

### Step 1 — Scan all planning documents

Read every `.md` file (excluding `_index.md` itself) in:

- `docs/planning/ideas/`
- `docs/planning/plans/` (read `plan.md` inside each subdirectory)

For each file, extract the YAML frontmatter fields.

### Step 2 — Calculate metrics

**For ideas:**

- Count by status: `captured | in-progress | completed | deferred`
- Count by domain
- Identify ideas with `status: captured` that have no `plan:` value (not yet planned)

**For plans:**

- Count by status: `planning | ready | in-progress | blocked | completed`
- Identify blocked plans
- Calculate overall completion percentage from task checkboxes in the plan

### Step 3 — Generate dashboard files

#### `docs/planning/ideas/_index.md`

```markdown
---
updated: 'YYYY-MM-DD'
---

# Ideas

## Summary

| Status      | Count |
| ----------- | ----- |
| Captured    | N     |
| In Progress | N     |
| Completed   | N     |
| Deferred    | N     |
| **Total**   | **N** |

## Ideas

| File                      | Title | Status      | Domain | Captured | Plan      |
| ------------------------- | ----- | ----------- | ------ | -------- | --------- |
| [filename](./filename.md) | title | status      | domain | date     | link or — |

(Sorted by: captured date desc)

## Action Required

- [List any captured ideas with no plan link — needs /plan-from-idea]
```

#### `docs/planning/plans/_index.md`

```markdown
---
updated: 'YYYY-MM-DD'
---

# Execution Plans

## Summary

| Status      | Count |
| ----------- | ----- |
| Planning    | N     |
| Ready       | N     |
| In Progress | N     |
| Blocked     | N     |
| Completed   | N     |
| **Total**   | **N** |

## Plans

| #                         | Title | Status      | Idea      | Started   | Completed |
| ------------------------- | ----- | ----------- | --------- | --------- | --------- |
| [NNN](./NNN-slug/plan.md) | title | status      | idea link | date or — | date or — |

(Sorted by: number asc)

## Pipeline Flow

Ideas → Plans
[N ideas total] → [N plans total]

## Blockers

- [List any plans with status: blocked and note what's blocking them]
```

### Step 4 — Confirm

Report which dashboard files were updated and the high-level counts for each stage.

## Notes

- Parse YAML frontmatter between `---` delimiters at the top of each file
- Checkbox completion: count `- [x]` as done, `- [ ]` as pending
- If a stage directory is empty, write a minimal dashboard noting no items yet
- Preserve the `updated:` frontmatter field with today's date on each write
- Do not modify any non-`_index.md` files in this skill