ballred/project

Project Skill

Create, track, and archive projects that bridge the gap between goals and daily tasks.

Usage

/project              # Interactive: create new project or view status
/project new          # Create a new project
/project status       # Dashboard of all active projects
/project archive <name>  # Archive a completed project

Commands

/project or /project new

Creates a new project folder with a CLAUDE.md context file, interactively linked to a goal.

Steps:

1. Read Goals/1. Yearly Goals.md to list available goals
2. Ask user which goal this project supports (or "none" for standalone)
3. Ask for project name
4. Create Projects/<ProjectName>/CLAUDE.md with structure below
5. If linked to a goal, add [[Projects/<ProjectName>]] reference in the yearly goals file

Project CLAUDE.md Template:

# Project: <Name>

## Overview
[Brief description of what this project achieves]

## Goal Link
Supports: [[1. Yearly Goals#<Goal Name>]]

## Status
- **Phase:** Planning | Active | Review | Complete
- **Progress:** 0%
- **Started:** <date>
- **Target:** <date>

## Key Decisions
- [Decision 1] - [Date] - [Rationale]

## Next Actions
- [ ] [First concrete step]
- [ ] [Second step]

## Notes
[Running log of updates, blockers, learnings]

/project status

Scans all Projects/*/CLAUDE.md files and displays a dashboard.

Steps:

1. Glob for Projects/*/CLAUDE.md
2. Read each file, extract: name, status/phase, progress%, goal linkage, next action
3. Display dashboard table

Output Format:

## Project Dashboard

| Project | Phase | Progress | Goal | Next Action |
|---------|-------|----------|------|-------------|
| ProjectA | Active | 60% | [[Goal 1]] | Review PR |
| ProjectB | Planning | 10% | [[Goal 3]] | Draft spec |

### Summary
- Active projects: N
- Total progress (weighted): X%
- Projects without goal link: [list]
- Stalled projects (no update in 14+ days): [list]

/project archive <name>

Moves a completed project to the archives.

Steps:

1. Verify Projects/<name>/ exists
2. Confirm with user before archiving
3. Update project CLAUDE.md status to "Complete" and progress to 100%
4. Move folder: mv Projects/<name> Archives/Projects/<name>
5. Create Archives/Projects/ directory if it doesn't exist
6. Update any goal references to note completion
7. Report what was archived

Project Naming Conventions

• Use PascalCase for folder names: Projects/LearnSpanish/
• Keep names concise but descriptive
• Avoid special characters

Cascade Integration

Projects are the critical middle layer:

Goals/1. Yearly Goals.md     <- "What I want to achieve"
    |
    v
Projects/*/CLAUDE.md         <- "How I'll achieve it" (THIS SKILL)
    |
    v
Daily Notes/*.md             <- "What I'm doing today"

When creating tasks in daily notes, reference the project:

- [ ] Draft API spec — [[Projects/MyApp/CLAUDE.md|MyApp]]

Task-Based Progress Tracking

New Project Tasks

TaskCreate:
  subject: "Read yearly goals"
  description: "Load goals for project linking"
  activeForm: "Reading yearly goals..."

TaskCreate:
  subject: "Create project structure"
  description: "Create folder and CLAUDE.md for new project"
  activeForm: "Creating project structure..."

TaskCreate:
  subject: "Link project to goal"
  description: "Add project reference to yearly goals file"
  activeForm: "Linking project to goal..."

Status Dashboard Tasks

TaskCreate:
  subject: "Scan project files"
  description: "Glob and read all Projects/*/CLAUDE.md files"
  activeForm: "Scanning project files..."

TaskCreate:
  subject: "Generate dashboard"
  description: "Compile status dashboard from project data"
  activeForm: "Generating project dashboard..."

Mark each task in_progress when starting, completed when done.

Integration

Works with:

• /daily - Surface project next-actions in morning routine
• /weekly - Project status in weekly review
• /goal-tracking - Project progress feeds goal calculations
• /onboard - Discover and load project context
• /push - Commit project changes