From ac80a9ab18f566c5b8e552bad808d77256a14f0f Mon Sep 17 00:00:00 2001
From: Mischa <mischa@gorinskat.nl>
Date: Fri, 26 Jun 2026 09:37:22 +0200
Subject: [PATCH] docs: add plan status convention to CLAUDE.md

Defines Status field values (Not started / In progress / Deferred /
Complete / Abandoned) and scanning rules so any session knows which
plans are open vs done without reading every file.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vgmzx8VTTTmCskSpQtsLTr
---
 CLAUDE.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 959a77e..ed72162 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -146,3 +146,19 @@ Specs: `docs/working/specs/YYYY-MM-DD-<topic>-design.md`
 Plans: `docs/working/plans/YYYY-MM-DD-<topic>.md`
 
 The brainstorming and writing-plans skills default to `docs/superpowers/`; these lines override that default.
+
+### Plan status convention
+
+Every plan in `docs/working/plans/` must have a `**Status:**` line immediately after the title heading:
+
+| Status | Meaning |
+|---|---|
+| `📋 Not started` | Plan written; work not yet begun |
+| `🔄 In progress — <note>` | Actively being worked on |
+| `⏸️ Deferred — <reason>` | Intentionally postponed |
+| `✅ Complete (YYYY-MM-DD)` | Done |
+| `❌ Abandoned — <reason>` | Won't implement |
+
+**When asked what's open:** surface `Not started` and `In progress` plans. Show `Deferred` plans but label them clearly. Omit `Complete` and `Abandoned` unless explicitly asked.
+
+**When finishing a plan:** update the `**Status:**` field in the plan file to `✅ Complete (YYYY-MM-DD)` before closing the session. This applies whether execution was done by Claude directly, via the superpowers:executing-plans skill, or via superpowers:subagent-driven-development.