Initial commit

commands/pp-resume.md

@@ -0,0 +1,123 @@
+# Resume Project Session
+
+Start a new chat session with full project context loaded.
+
+## Arguments
+
+$ARGUMENTS
+
+## Purpose
+
+This is the FIRST command to run when starting a new chat session. It:
+1. Loads all project context into memory
+2. Understands current state
+3. Prepares to continue work
+4. Optionally focuses on specific direction from query
+
+## Execution Instructions
+
+### Step 1: Verify Project Exists
+
+```bash
+ls .context/project/INDEX.md
+```
+
+If not found, inform user: "No project structure found. Run `/pp-init` first."
+
+### Step 2: Read Root Context
+
+Read these files in order:
+1. `.context/project/INDEX.md` - Project overview, subprojects, active subproject, high-level status
+2. `.context/project/WORKFLOW.md` - How this system works
+3. `.context/project/PRINCIPLES.md` - Methodology and rules
+4. `.context/project/LESSONS.md` - Past learnings
+
+### Step 3: Read Active Subproject Context
+
+From INDEX.md, identify active subproject, then read:
+1. `.context/project/{active}/STATUS.md`
+2. `.context/project/{active}/TODO.md`
+3. `.context/project/{active}/CODEBASE.md`
+4. `.context/project/{active}/LESSONS.md`
+5. `.context/project/{active}/PRINCIPLES.md` (if exists - overrides root)
+
+### Step 4: Read Recent Changes
+
+Read last 3-5 entries from:
+- `.context/project/{active}/CHANGELOG.md`
+
+### Step 5: Process Optional Query
+
+If query provided:
+- Parse for direction (e.g., "continue booking flow", "fix the API bug")
+- Focus context on relevant TODO items
+- Identify relevant LESSONS if debugging
+
+### Step 6: Check for Next Session Instructions (NEW)
+
+**After loading all standard files**, check for continuation instructions:
+
+```bash
+ls .context/project/{active}/NEXT.md
+```
+
+**If NEXT.md exists:**
+1. Read `.context/project/{active}/NEXT.md`
+2. Extract history file path from NEXT.md
+3. Read that history file for previous session context
+4. Note the full chat transcript path (but DO NOT load it)
+
+**If NEXT.md does NOT exist:**
+- Skip this step, proceed to summary
+
+### Step 7: Generate Resume Summary
+
+Output a compact summary:
+
+```
+## Session Resumed: {PROJECT_NAME}
+
+**Active**: {subproject}/ - {current phase}
+**Status**: {brief status}
+
+{IF NEXT.md exists:}
+### Instructions from Previous Session
+{content from NEXT.md "What To Do Next" section}
+
+**Previous Session**: {date} - {brief summary from history file}
+
+### Current Focus
+{from STATUS.md current focus}
+
+### In Progress
+{tasks marked [>] from TODO.md}
+
+### Recent Changes
+{last 2-3 changelog entries, one line each}
+
+### Key Context
+{if query provided, relevant context for that direction}
+
+---
+
+Ready to continue. {If NEXT.md exists: "Following previous session's plan." else: "What would you like to work on?"}
+```
+
+## Query Examples
+
+```bash
+# General resume - load everything
+/pp-resume
+
+# With direction - focus on specific area
+/pp-resume continue the booking flow implementation
+/pp-resume fix the WhatsApp routing bug
+/pp-resume review yesterday's changes
+```
+
+## Important Notes
+
+- This command is READ-ONLY (no file modifications)
+- After this, Claude has full project context
+- User can immediately start working
+- If query mentions something not in TODO, suggest adding it