claude-code/plans/golden-imagining-engelbart.md

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

{
  "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

{
  "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"