# Plan: Add Plan Status Tracking

## Problem

Plans in `~/.claude/plans/` have inconsistent status tracking:
- Some have inline `**Status:** Implemented`
- Most have no status marker
- No central index to query plan statuses

## Solution

Create `~/.claude/plans/index.json` as a central registry for plan metadata and status.

## Design

### Index Schema

```json
{
  "plans": {
    "temporal-foraging-milner": {
      "title": "RAG JSON-to-text transformation",
      "status": "pending",
      "created": "2026-01-05",
      "category": "enhancement"
    },
    "fizzy-puzzling-candy": {
      "title": "Session summarization hook",
      "status": "implemented",
      "created": "2026-01-03",
      "implemented": "2026-01-03",
      "category": "feature"
    }
  }
}
```

### Status Values

| Status | Meaning |
|--------|---------|
| `pending` | Not yet implemented |
| `implemented` | Fully implemented |
| `partial` | Partially implemented |
| `abandoned` | Decided not to implement |
| `superseded` | Replaced by another plan |

### Categories

| Category | Meaning |
|----------|---------|
| `feature` | New capability |
| `enhancement` | Improve existing feature |
| `bugfix` | Fix an issue |
| `diagnostic` | One-time investigation (auto-complete) |
| `design` | Design document for reference |

## Files to Create

| File | Purpose |
|------|---------|
| `~/.claude/plans/index.json` | Central plan registry |

## Implementation

### Step 1: Create index.json with all current plans

Populate based on our verification:

**Implemented:**
- wise-dazzling-marshmallow (k8s quick-status)
- fizzy-puzzling-candy (session summarization)
- shimmering-discovering-bonbon (linux sysadmin agent)
- valiant-hugging-dahl (pi50 optimization)
- cozy-strolling-nygaard (status line + keybind)
- flickering-enchanting-fiddle (restructure components)
- velvet-percolating-porcupine (no-redundancy rule)
- 2025-01-02-gcal-design
- 2026-01-01-component-registry-design
- 2026-01-01-usage-tracking-design

**Diagnostic (complete):**
- elegant-prancing-allen (vulkan verification)
- pure-wishing-metcalfe (cluster diagnosis)
- glistening-wondering-wadler (structure verification)

**Pending:**
- temporal-foraging-milner (RAG improvement)
- cosmic-frolicking-compass (Zed Wayland)

**Handoff doc (reference only):**
- shimmering-discovering-bonbon-handoff

### Step 2: Update CLAUDE.md

Add plans index to state files table.

## Benefits

1. Single source of truth for plan statuses
2. Easy to query: `jq '.plans | to_entries[] | select(.value.status == "pending")' index.json`
3. No need to modify individual plan files
4. Can track implementation dates

## Full index.json Content

```json
{
  "version": "1.0",
  "description": "Plan status registry",
  "plans": {
    "temporal-foraging-milner": {
      "title": "RAG JSON-to-text transformation",
      "status": "pending",
      "created": "2026-01-05",
      "category": "enhancement"
    },
    "cosmic-frolicking-compass": {
      "title": "Zed Wayland compilation",
      "status": "pending",
      "created": "2025-12-13",
      "category": "enhancement",
      "notes": "External task - compile Zed with Wayland support"
    },
    "wise-dazzling-marshmallow": {
      "title": "K8s quick-status skill",
      "status": "implemented",
      "created": "2025-12-28",
      "implemented": "2025-12-29",
      "category": "feature"
    },
    "fizzy-puzzling-candy": {
      "title": "Session summarization hook",
      "status": "implemented",
      "created": "2026-01-03",
      "implemented": "2026-01-03",
      "category": "feature"
    },
    "shimmering-discovering-bonbon": {
      "title": "Linux sysadmin agent",
      "status": "implemented",
      "created": "2025-12-28",
      "implemented": "2025-12-28",
      "category": "feature"
    },
    "valiant-hugging-dahl": {
      "title": "Pi50 resource optimization",
      "status": "implemented",
      "created": "2026-01-05",
      "implemented": "2026-01-05",
      "category": "enhancement"
    },
    "cozy-strolling-nygaard": {
      "title": "Status line + keybind fix",
      "status": "implemented",
      "created": "2025-12-29",
      "implemented": "2025-12-29",
      "category": "bugfix"
    },
    "flickering-enchanting-fiddle": {
      "title": "Restructure components",
      "status": "implemented",
      "created": "2025-12-28",
      "implemented": "2025-12-28",
      "category": "enhancement"
    },
    "velvet-percolating-porcupine": {
      "title": "No-redundancy rule",
      "status": "implemented",
      "created": "2025-12-28",
      "implemented": "2025-12-28",
      "category": "enhancement"
    },
    "elegant-prancing-allen": {
      "title": "Vulkan verification",
      "status": "implemented",
      "created": "2025-12-12",
      "implemented": "2025-12-12",
      "category": "diagnostic"
    },
    "pure-wishing-metcalfe": {
      "title": "Cluster issue diagnosis",
      "status": "implemented",
      "created": "2025-12-27",
      "implemented": "2025-12-27",
      "category": "diagnostic"
    },
    "glistening-wondering-wadler": {
      "title": "Structure verification report",
      "status": "implemented",
      "created": "2026-01-03",
      "implemented": "2026-01-03",
      "category": "diagnostic"
    },
    "2025-01-02-gcal-design": {
      "title": "Google Calendar integration",
      "status": "implemented",
      "created": "2025-12-31",
      "implemented": "2026-01-01",
      "category": "design"
    },
    "2026-01-01-component-registry-design": {
      "title": "Component registry",
      "status": "implemented",
      "created": "2026-01-01",
      "implemented": "2026-01-01",
      "category": "design"
    },
    "2026-01-01-usage-tracking-design": {
      "title": "Usage tracking",
      "status": "implemented",
      "created": "2025-12-31",
      "implemented": "2026-01-01",
      "category": "design"
    },
    "shimmering-discovering-bonbon-handoff": {
      "title": "Linux sysadmin handoff doc",
      "status": "implemented",
      "created": "2025-12-28",
      "implemented": "2025-12-28",
      "category": "design",
      "notes": "Reference document for shimmering-discovering-bonbon"
    }
  }
}
```

## Commit

Single commit: "Add plans index.json for status tracking"