# Projects

> Query and manage project status using the project manager tool

- Skill: `sensei-hacker/projects` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sensei-hacker/projects`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sensei-hacker/projects/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: sensei-hacker (https://skillmd.com/u/sensei-hacker)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sensei-hacker/projects

---


# Project Management Skill

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

## Project Manager Tool

Located at: `claude/manager/scripts/project_manager.py`

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

## Quick Commands

### List Active Projects (TODO)

```bash
python3 claude/manager/scripts/project_manager.py list TODO
```

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

### List All Projects

```bash
python3 claude/manager/scripts/project_manager.py list
```

Shows all projects regardless of status.

### List by Status

```bash
# Completed projects
python3 claude/manager/scripts/project_manager.py list COMPLETE

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

# In progress
python3 claude/manager/scripts/project_manager.py list IN_PROGRESS

# Cancelled
python3 claude/manager/scripts/project_manager.py list CANCELLED
```

### Show Project Details

```bash
python3 claude/manager/scripts/project_manager.py show <name>
```

Example:
```bash
python3 claude/manager/scripts/project_manager.py show finding5
python3 claude/manager/scripts/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

```bash
python3 claude/manager/scripts/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/manager/scripts/project_manager.py`

## Status Definitions

| Status | Emoji | Meaning |
|--------|-------|---------|
| TODO | 📋 | Defined but not started |
| IN_PROGRESS | 🚧 | Actively being worked on |
| COMPLETE | ✅ | Finished and merged |
| BACKBURNER | ⏸️ | Paused, will resume later |
| CANCELLED | ❌ | Abandoned |

## Assignment Status

| Indicator | Meaning |
|-----------|---------|
| ✉️ Assigned | Developer notified via email |
| 📝 Planned | Created but not yet assigned |

## Usage Examples

### Finding a Specific Project

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

```bash
# Search by partial name
python3 claude/manager/scripts/project_manager.py show chacha

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

### Checking What's Active

```bash
# Quick view of what needs to be done
python3 claude/manager/scripts/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

```bash
# View all completed projects
python3 claude/manager/scripts/project_manager.py list COMPLETE
```

### Project Statistics

```bash
python3 claude/manager/scripts/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. **Compact INDEX.md (keeps only active projects):**
   ```bash
   python3 claude/manager/scripts/compact_index.py
   ```
   This automatically separates active and completed projects.

2. **Verify with project manager:**
   ```bash
   python3 claude/manager/scripts/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:

```bash
# 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

```bash
# Verify tool exists
ls -lh claude/manager/scripts/project_manager.py

# Make executable if needed
chmod +x claude/manager/scripts/project_manager.py
```

### Syntax Errors

The tool requires Python 3.7+ for dataclasses:
```bash
python3 --version  # Should be 3.7 or higher
```

### No Matches Found

If searching for a project returns no results:
```bash
# List all projects to see exact names
python3 claude/manager/scripts/project_manager.py list
```

---

## Related Skills

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