Projects

--- name: Projects description: Build a personal project management system that scales from simple lists to structured planning. metadata: {"clawdbot":{"emoji":"📁","os":["linux","darwin","win32"]}} ---

Core Behavior

• User mentions a project → help define scope, create folder
• User adds tasks → capture in project context
• Regular review prompts → surface stalled projects
• Create ~/projects/ as workspace

First Question

• "What does done look like?" — define success before starting
• Scope creep is the project killer — clear boundaries from day one
• If they can't define done, the project isn't ready to start

Project Types to Recognize

• One-time goal: clear end state, then archive (move apartments, plan trip)
• Ongoing area: never truly done, maintain indefinitely (health, career)
• Client work: external deadline, deliverables, often paid
• Learning: skill acquisition, may spawn other projects
• Creative: writing, art, building — process matters as much as output

Minimal Project Structure

• Folder with project name: ~/projects/kitchen-renovation/
• README.md: what, why, done criteria, deadline if any
• tasks.md: simple checklist, add as discovered
• notes.md: decisions made, research, reference material

When User Starts a Project

• Ask: "What's the one sentence description?"
• Ask: "When does this need to be done?" (or "no deadline")
• Ask: "What's the very next physical action?"
• Create folder with README containing answers

Task Capture

• Quick capture: "Add to kitchen project: call contractor"
• Tasks are concrete actions, not vague goals
• "Research options" is a task, "figure out renovation" is not
• Estimate size if useful: small/medium/large or hours

When Projects Grow

• More than 15 tasks → consider grouping into phases
• Multiple workstreams → split into areas within project
• Dependencies emerging → note which tasks block others
• Collaborators involved → note who owns what

Phase/Milestone Structure

For larger projects:

~/projects/kitchen-renovation/
├── README.md
├── phase-1-planning/
│   ├── tasks.md
│   └── notes.md
├── phase-2-demo/
├── phase-3-install/
└── archive/

Active Project Limits

• Suggest maximum 3-5 active projects — more means nothing progresses
• Distinguish active (working this week) from someday (parked intentionally)
• Parked projects go in ~/projects/_someday/
• Review someday quarterly — activate, archive, or delete

Weekly Project Review

• What progressed this week?
• What's the next action for each active project?
• Any projects stalled more than 2 weeks?
• Any someday projects ready to activate?

Stalled Project Detection

• No task completions in 2+ weeks → surface in review
• Ask: "Is this still a priority? Block or drop?"
• Options: push forward, park to someday, kill it
• Killing projects is healthy — better than zombie projects

Project Completion

• Define done checklist in README from start
• When complete: review what went well, what didn't
• Archive to ~/projects/_archive/year/
• Celebrate completion — don't just move to next thing

Client/Work Projects

• Add: deadline, contact info, rate if applicable
• Track time if billing: simple log in project folder
• Deliverables list with status
• Communication log: key decisions and approvals

What NOT To Suggest

• Complex project management app until files fail
• Rigid methodology (Agile, GTD, etc.) — adapt to user
• Gantt charts for personal projects — overkill
• Time tracking for non-billable work — adds friction

Project Templates

Offer to create templates for recurring project types:

• "You start client projects often — want a template?"
• Template: folder structure, README prompts, standard tasks
• Keep templates minimal — adapt per project

Integration Points

• Calendar: deadlines, milestones
• Contacts: collaborators, stakeholders
• Invoices: if client project with billing
• Goals: projects often serve larger goals

Someday/Maybe List

• Ideas not ready for commitment
• Review monthly — promote, delete, or keep parking
• No guilt about long lists — it's a holding pen
• "This would be cool but not now" is valid

Project Metrics (When Asked)

• How long did similar projects take?
• Completion rate: started vs finished
• Average project duration
• Don't track obsessively — only if user finds it useful