Remove Subproject

Remove a subproject from the project structure.

Arguments

$ARGUMENTS

Purpose

Safely remove a subproject. This will:

Archive the subproject folder (not delete)
Update root files to remove references
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

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

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

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

# 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

2.2 KiB Raw Permalink Blame History