Add New Subproject

Create a new subproject in the project structure.

Arguments

$ARGUMENTS

Purpose

Add a new subproject with full file structure. Query should contain:

• Subproject name (folder name)
• Description/purpose
• Optionally: initial scope, dependencies

Execution Instructions

Step 1: Parse Query

Extract from query:

• name: Folder name (lowercase, no spaces)
• title: Human-readable title
• description: What this subproject does
• dependencies: Relationships to other subprojects

If query is empty or missing info, ask:

1. "Subproject folder name (e.g., 'api', 'frontend'):"
2. "Title (e.g., 'REST API Backend'):"
3. "Brief description:"
4. "Dependencies on other subprojects? (optional)"

Step 2: Create Directory Structure

mkdir -p .context/project/{name}/prds .context/project/{name}/docs .context/project/{name}/archive

Step 3: Copy and Process Templates

Copy subproject templates from ~/.claude/commands/pp-init-assets/templates/subproject/:

# Copy all subproject templates
cp ~/.claude/commands/pp-init-assets/templates/subproject/*.md .context/project/{name}/

Then process placeholders:

• {{SUBPROJECT_NAME}} → name
• {{SUBPROJECT_TITLE}} → title
• {{SUBPROJECT_DESCRIPTION}} → description
• {{DATE}} → current date
• {{SUBPROJECT_STATUS}} → "Not Started"
• Other placeholders → "TBD" or empty

Step 4: Update Root Files

INDEX.md: Add to subproject table

| {name}/ | Planned | {description} |

STATUS.md: Add to subproject summary table

| {name}/ | - | Not Started |

CODEBASE.md: Add to subproject refs

- `{name}/CODEBASE.md` - {title} files

CHANGELOG.md: Add entry

## {DATE} | Added Subproject: {name}

**Changes**:
- Created {name}/ subproject structure

**Context**:
- {description}

Step 5: Confirm Creation

## Created Subproject: {name}/

**Title**: {title}
**Description**: {description}

**Files created**:
- {name}/INDEX.md
- {name}/STATUS.md
- {name}/TODO.md
- {name}/CHANGELOG.md
- {name}/PRINCIPLES.md
- {name}/CODEBASE.md
- {name}/LESSONS.md

**Updated**:
- Root INDEX.md
- Root STATUS.md
- Root CODEBASE.md
- Root CHANGELOG.md

To start working on this subproject, update STATUS.md to set it as active.

Query Examples

# Full description
/pp-add api - REST API backend using FastAPI, handles auth and data

# Just name (will ask for details)
/pp-add mobile

# With dependencies
/pp-add frontend - React dashboard, depends on api for data