Projects

Project Management Skill

Query and manage INAV project tracking using the project_manager.py tool.

Project Manager Tool

Located at: claude/projects/project_manager.py

This Python script provides powerful project querying capabilities across INDEX.md and COMPLETED_PROJECTS.md.

Quick Commands

List Active Projects (TODO)

python3 claude/projects/project_manager.py list TODO

Shows all active TODO projects with priority, assignee, and creation date.

List All Projects

python3 claude/projects/project_manager.py list

Shows all projects regardless of status.

List by Status

# Completed projects
python3 claude/projects/project_manager.py list COMPLETE

# Backburner projects
python3 claude/projects/project_manager.py list BACKBURNER

# In progress
python3 claude/projects/project_manager.py list IN_PROGRESS

# Cancelled
python3 claude/projects/project_manager.py list CANCELLED

Show Project Details

python3 claude/projects/project_manager.py show <name>

Example:

python3 claude/projects/project_manager.py show finding5
python3 claude/projects/project_manager.py show transpiler

Shows full details for a specific project including:

• Status, priority, assignee
• Creation and completion dates
• Location in filesystem
• Line numbers in INDEX.md

View Statistics

python3 claude/projects/project_manager.py stats

Shows:

• Count by status (TODO, COMPLETE, etc.)
• Count by priority (HIGH, MEDIUM, etc.)
• Total projects
• Active vs completed breakdown

Project File Locations

• Active projects index: claude/projects/INDEX.md (13KB - active only)
• Completed projects archive: claude/projects/COMPLETED_PROJECTS.md (36KB - full archive)
• Active project directories: claude/projects/{name}/
• Archived project directories: claude/archived_projects/{name}/
• Project manager tool: claude/projects/project_manager.py

Status Definitions

Assignment Status

Usage Examples

Finding a Specific Project

When you need to find a project but don't know the exact name:

# Search by partial name
python3 claude/projects/project_manager.py show chacha

# Will show: privacylrs-fix-finding5-chacha-benchmark

Checking What's Active

# Quick view of what needs to be done
python3 claude/projects/project_manager.py list TODO

Output:

Status          Priority   Project                                            Created
====================================================================================================
📋 TODO         HIGH       fix-cli-align-mag-roll-invalid-name                2025-12-02
📋 TODO         CRITICAL   privacylrs-fix-finding1-stream-cipher-desync       2025-11-30
...

Checking Recent Completions

# View all completed projects
python3 claude/projects/project_manager.py list COMPLETE

Project Statistics

python3 claude/projects/project_manager.py stats

Output:

=== Project Statistics ===

By Status:
  CANCELLED           1 projects
  COMPLETE           37 projects
  TODO                8 projects

Total Projects: 46
Active Projects: 8
Completed: 38

For Managers Only

Updating INDEX.md

After completing a project:

1. Move to COMPLETED_PROJECTS.md:

   cd claude/projects
   python3 compact_index.py
   

   This automatically separates active and completed projects.

2. Verify with project manager:

   python3 project_manager.py stats
   python3 project_manager.py list TODO
   

3. Update the "Last Updated" date in INDEX.md header

Manual Index Queries (Fallback)

If project_manager.py is unavailable:

# View active projects section
grep -A 20 "^## Active Projects" claude/projects/INDEX.md

# Count by status
grep -c "^### 📋" claude/projects/INDEX.md  # TODO
grep -c "^### ✅" claude/projects/INDEX.md  # COMPLETE
grep -c "^### ⏸️" claude/projects/INDEX.md  # BACKBURNER

Tool Benefits

✅ Fast queries - No need to search through 2000+ lines manually ✅ Smart search - Partial name matching ✅ Statistics - Instant project counts and breakdowns ✅ Status filtering - View only what you need ✅ Detail view - See everything about a specific project

Troubleshooting

Tool Not Found

# Verify tool exists
ls -lh claude/projects/project_manager.py

# Make executable if needed
chmod +x claude/projects/project_manager.py

Syntax Errors

The tool requires Python 3.7+ for dataclasses:

python3 --version  # Should be 3.7 or higher

No Matches Found

If searching for a project returns no results:

# List all projects to see exact names
python3 claude/projects/project_manager.py list

Related Skills

• email - Read task assignments (tasks often reference projects)
• communication - Communicate about project status