project-tracker

# Project Tracker

Track every project in one place. Know what's moving, what's stalled, and what to kill.

**by The Agent Ledger** — [theagentledger.com](https://theagentledger.com)

## Setup

Create `projects/` directory and `projects/DASHBOARD.md`:

```markdown
# Project Dashboard

Last updated: [date]

| Project | Status | Priority | Next Action | Due |
|---------|--------|----------|-------------|-----|

## Active Projects
<!-- Agent maintains this section -->

## On Hold
<!-- Paused but not abandoned -->

## Completed
<!-- Archive of finished work -->
```

## How It Works

### Adding a Project

When the user mentions a new project, create `projects/<project-name>.md`:

```markdown
# Project: [Name]

**Status:** 🟢 Active | 🟡 On Hold | 🔴 Blocked | ✅ Done
**Priority:** P1 (critical) | P2 (important) | P3 (nice-to-have)
**Started:** [date]
**Target:** [deadline or "ongoing"]
**One-liner:** [what this project is in one sentence]

## Milestones

- [ ] Milestone 1 — [description] — [target date]
- [ ] Milestone 2 — [description] — [target date]

## Progress Log

### [date]
- What happened today

## Decisions

| Date | Decision | Rationale |
|------|----------|-----------|

## Blockers

- [blocker] → [who/what can unblock it]
```

### Dashboard Updates

Update `projects/DASHBOARD.md` whenever:
- A project status changes
- A milestone is completed
- A new project is added
- During weekly reviews

### Stalled Project Detection

A project is **stalled** if:
- No progress log entry in 7+ days
- Status is 🟢 Active but no recent milestone movement
- Has unresolved blockers older than 3 days

Flag stalled projects in daily briefings or heartbeat checks:
> ⚠️ **Stalled:** [Project Name] — no updates in [N] days. Continue, pause, or kill?

### Weekly Review Format

Generate every Sunday (or on request):

```markdown
# Weekly Project Review — [date range]

## Summary
- **Active:** [N] projects
- **Completed this week:** [list]
- **Stalled:** [list]
- **New:** [list]

## Pe...