/project - Project Management Command

Manage CODITECT projects with hierarchical work item tracking.

Usage

# Create new project
/project create "Project Name" --description "Description"

# List all projects
/project list [--status active|completed|archived]

# Show project details with progress
/project show P001

# Update project
/project update P001 --name "New Name" --status completed

# Show project hierarchy (tree view)
/project tree P001

# Create sub-project
/project sub-project P001 "Sub-Project Name"

# Archive project
/project archive P001

System Prompt

System Prompt

⚠️ EXECUTION DIRECTIVE: When the user invokes this command, you MUST:

1. IMMEDIATELY execute - no questions, no explanations first
2. ALWAYS show full output from script/tool execution
3. ALWAYS provide summary after execution completes

DO NOT:

• Say "I don't need to take action" - you ALWAYS execute when invoked
• Ask for confirmation unless requires_confirmation: true in frontmatter
• Skip execution even if it seems redundant - run it anyway

The user invoking the command IS the confirmation.

---

You are managing CODITECT projects using the Work Item Hierarchy system (ADR-006).

ID Convention:

• Projects: P{NNN} (P001, P042, P123)
• Sub-Projects: SP{NNN} (SP001, SP057)

Available Actions:

Create Project

# Parse: /project create "NAME" [--description "DESC"]
python3 scripts/work_items.py project create "$NAME" --description "$DESC"

List Projects

# Parse: /project list [--status STATUS]
python3 scripts/work_items.py project list $STATUS_FILTER

Show Project

# Parse: /project show ID
python3 scripts/work_items.py project show "$ID"

Project Tree

# Parse: /project tree ID
python3 scripts/work_items.py project tree "$ID"

Create Sub-Project

# Parse: /project sub-project PARENT_ID "NAME"
python3 scripts/work_items.py sub-project create "$PARENT_ID" "$NAME"

Update Project

# Parse: /project update ID [--name NAME] [--status STATUS] [--description DESC]
python3 scripts/work_items.py project update "$ID" $OPTIONS

Output Format: Always display:

1. Project ID (P001 format)
2. Name and description
3. Status (active/completed/archived)
4. Progress percentage (rolled up from children)
5. Sub-project count
6. Epic count
7. Created/updated timestamps

Example Response:

Project P001 created successfully.

  ID:          P001
  Name:        AI Syllabus
  Description: Educational curriculum framework
  Status:      active
  Progress:    0% (no work items yet)
  Sub-Projects: 0
  Epics:       0
  Created:     2025-12-13T10:30:00Z

Next steps:
  /project sub-project P001 "Phase 1"  - Add sub-project
  /epic create P001 "Epic Name"        - Add epic directly

Examples

Create a Project

/project create "CODITECT v2.0" --description "Next major version"

View Project with Hierarchy

/project tree P001

Output:

P001: CODITECT v2.0 (75% complete)
├── SP001: Backend (80%)
│   ├── E001: API Redesign (100%)
│   └── E002: Database Migration (60%)
└── SP002: Frontend (70%)
    ├── E003: Component Library (90%)
    └── E004: Dashboard (50%)

List Active Projects

/project list --status active

Success Output

When project operation completes:

✅ COMMAND COMPLETE: /project
Action: <create|list|tree|status>
Project: <project-id>
Result: Operation successful

Completion Checklist

Before marking complete:

• Project data loaded/created
• Hierarchy calculated
• Output formatted
• Changes persisted (if write operation)

Failure Indicators

This command has FAILED if:

• ❌ Project not found
• ❌ Invalid project ID format
• ❌ Write permission denied
• ❌ Hierarchy calculation error

When NOT to Use

Do NOT use when:

• Need task-level operations (use /work-next)
• Need blocker analysis (use /blockers)
• Single session task (project overhead unnecessary)

Anti-Patterns (Avoid)

Anti-Pattern	Problem	Solution
Create without checking	Duplicate projects	List first, then create
Ignore hierarchy	Miss dependencies	Use tree view regularly
Skip status updates	Stale data	Update after milestones

Principles

This command embodies:

• #4 Separation of Concerns - Projects, sub-projects, epics
• #9 Based on Facts - Uses actual work item data
• #6 Clear, Understandable - Hierarchical visualization

Full Standard: CODITECT-STANDARD-AUTOMATION.md

---

Script: scripts/work_items.py Standard: CODITECT-CORE-STANDARDS/CODITECT-STANDARD-WORK-ITEMS.md ADR: docs/03-architecture/adrs/ADR-005-work-item-hierarchy.md Version: 1.0.0