Initial commit

commands/pp-remove.md

@@ -0,0 +1,122 @@
+# Remove Subproject
+
+Remove a subproject from the project structure.
+
+## Arguments
+
+$ARGUMENTS
+
+## Purpose
+
+Safely remove a subproject. This will:
+1. Archive the subproject folder (not delete)
+2. Update root files to remove references
+3. Log the removal
+
+## Execution Instructions
+
+### Step 1: Parse Query
+
+Extract subproject name from query.
+
+If empty, list available subprojects and ask which to remove.
+
+### Step 2: Verify Subproject Exists
+
+```bash
+ls .context/project/{name}/INDEX.md
+```
+
+If not found, show error: "Subproject '{name}' not found."
+
+### Step 3: Check if Active
+
+Read `.context/project/STATUS.md` to check if this is the active subproject.
+
+If active, ask: "This is the active subproject. Which subproject should become active instead?"
+
+### Step 4: Confirm Removal
+
+Show warning:
+```
+## Removing Subproject: {name}/
+
+This will:
+- Archive {name}/ to archive/{name}_{date}/
+- Remove from INDEX.md subproject table
+- Remove from STATUS.md summary
+- Remove from CODEBASE.md refs
+- Add removal entry to CHANGELOG.md
+
+Files will NOT be deleted, just archived.
+
+Proceed? (yes/no)
+```
+
+Wait for confirmation.
+
+### Step 5: Archive Subproject
+
+```bash
+mv .context/project/{name} .context/project/archive/{name}_{date}
+```
+
+### Step 6: Update Root Files
+
+**INDEX.md**: Remove from subproject table
+
+**STATUS.md**:
+- Remove from subproject summary table
+- If was active, update active subproject
+
+**CODEBASE.md**: Remove from subproject refs
+
+**CHANGELOG.md**: Add entry
+```markdown
+## {DATE} | Removed Subproject: {name}
+
+**Changes**:
+- Archived {name}/ to archive/{name}_{date}/
+- Removed from project structure
+
+**Context**:
+- {reason if provided}
+- Files preserved in archive
+```
+
+### Step 7: Confirm Removal
+
+```
+## Removed Subproject: {name}/
+
+**Archived to**: archive/{name}_{date}/
+**Active subproject**: {new_active}
+
+Updated:
+- Root INDEX.md
+- Root STATUS.md
+- Root CODEBASE.md
+- Root CHANGELOG.md
+
+To restore, move from archive back to project root.
+```
+
+## Query Examples
+
+```bash
+# With name
+/pp-remove old-api
+
+# With reason
+/pp-remove old-api - replaced by new api design
+
+# Interactive (will list and ask)
+/pp-remove
+```
+
+## Safety Notes
+
+- Never deletes files, only archives
+- Always asks for confirmation
+- Logs removal in CHANGELOG
+- Can be restored by moving from archive