setup-projects

Setup Projects

Initialize project and session management for organized multi-session work.

Step 1: Ask Configuration

Use AskUserQuestion:

Question 1: "Where should projects be stored?"

• Options:
  • "projects/ folder (Recommended)" - Standard location
  • "Custom location" - Specify a different path

Question 2: "Where should session files be stored?"

• Options:
  • "sessions/ folder (Recommended)" - Date-based session storage
  • "Inside each project" - Project-specific sessions

Step 2: Create Directory Structure

mkdir -p projects
mkdir -p sessions

Step 3: Create Project Index

Write projects/PROJECT_INDEX.md:

# Project Index

Central registry of all projects.

| Project | Status | Created | Last Active | Description |
|---------|--------|---------|-------------|-------------|
| (none yet) | - | - | - | - |

## Status Legend
- **active** - Currently being worked on
- **paused** - On hold, will resume
- **completed** - Finished, archived
- **archived** - No longer relevant

Step 4: Create Session Index

Write sessions/SESSION_INDEX.md:

# Session Index

Date-based session tracking.

| Date | Focus | Projects Touched | Key Outcomes |
|------|-------|------------------|--------------|
| (none yet) | - | - | - |

## Session Folder Format
`YYYY-MM-DD_brief-description/`

## Contents
Each session folder contains work artifacts from that date:
- Drafts and work-in-progress
- Research notes
- Temporary files
- Session summary (optional)

Step 5: Create Project Template

Write projects/.project-template/:

.project-template/
├── README.md          # Project overview
├── STATUS.md          # Current status and next steps
├── DECISIONS.md       # Decision log
└── .gitkeep

README.md template:

# Project: ${PROJECT_NAME}

## Overview
[Brief description of the project]

## Goals
- [ ] Goal 1
- [ ] Goal 2

## Key Files
- `file1.ext` - Description
- `file2.ext` - Description

## Related
- [[Link to related project]]