project-dashboard

# project-dashboard

Progress visualization and status reporting for qualitative research projects. Shows where you are in the sandwich methodology and what comes next.

## When to Use

Use this skill when:
- User asks "where am I?" or "what's my progress?"
- User mentions "status", "dashboard", or "progress"
- User wants to know if they're ready for the next stage
- User needs an overview of their project state

## Capabilities

1. **Progress Visualization** - ASCII and structured progress display
2. **Readiness Checks** - Determine if prerequisites are met
3. **Recommendations** - Suggest next steps based on current state
4. **Statistics** - Show coding counts, quotes, concepts

## Scripts

### calculate-progress.js
Calculate progress percentages for each stage.

```bash
node skills/project-dashboard/scripts/calculate-progress.js \
  --project-path /path/to/project
```

**Returns:**
```json
{
  "stage1_progress": 85,
  "stage2_progress": 30,
  "stage3_progress": 0,
  "overall_progress": 38
}
```

### generate-dashboard.js
Generate a formatted dashboard view.

```bash
node skills/project-dashboard/scripts/generate-dashboard.js \
  --project-path /path/to/project \
  --format ascii|json|markdown
```

### check-readiness.js
Check readiness for stage transitions.

```bash
node skills/project-dashboard/scripts/check-readiness.js \
  --project-path /path/to/project \
  --target-stage stage2
```

**Returns:**
```json
{
  "ready": true,
  "requirements_met": ["10+ documents", "memos written"],
  "requirements_missing": [],
  "recommendations": ["Consider more memos for depth"]
}
```

## Dashboard Output

### ASCII Format
```
The Sandwich Methodology
========================

     Stage 1: Human Foundation
     [========= ] 90%
     12 documents coded | 5 memos written
     Status: Ready for Stage 2!

     Stage 2: Human-AI Partnership
     [====      ] 40%
     Phase 1: Complete | Phase 2: In Progress | Phase 3: Not Started
     25 documents processed | 156 quotes extract