diff --git a/plans/golden-imagining-engelbart.md b/plans/golden-imagining-engelbart.md new file mode 100644 index 0000000..a89926f --- /dev/null +++ b/plans/golden-imagining-engelbart.md @@ -0,0 +1,230 @@ +# 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" diff --git a/plans/index.json b/plans/index.json new file mode 100644 index 0000000..27adc1f --- /dev/null +++ b/plans/index.json @@ -0,0 +1,126 @@ +{ + "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" + }, + "golden-imagining-engelbart": { + "title": "Plan status tracking", + "status": "implemented", + "created": "2026-01-07", + "implemented": "2026-01-07", + "category": "enhancement", + "notes": "This plan - meta!" + } + } +}