name: Projects
slug: projects
version: 1.0.1
description: Build a personal project management system that scales from simple lists to structured planning.
homepage: https://clawic.com/skills/projects
changelog: "Clearer disclosure of what is stored and where"
metadata:
clawdbot:
emoji: ๐
os:
- linux
- darwin
- win32
displayName: Projects
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
~/Clawic/data/projects/ as workspace Everything this skill reads or writes is a plain local note under the folders declared in configPaths โ nothing leaves the machine and no credential is ever written. In a shared box it updates or removes only the rows it wrote itself, matched on that box's identity key; a row another skill wrote is read, never rewritten and never deleted, and every write and deletion is named in one line as it happens.
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:
~/Clawic/data/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:
~/Clawic/data/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
~/Clawic/data/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
~/Clawic/data/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