Workspace Kit
Workspace scaffolding — organized folders, indexes, and templates for multi-session work.
Installation
/plugin install workspace-kit@abilityai
Skills
| Skill | Description |
|---|---|
| /workspace-kit:setup-projects | Initialize the project/session structure |
| /workspace-kit:create-project <name> | Create a new tracked project |
| /workspace-kit:create-session [topic] | Create today's session folder |
| /workspace-kit:archive-project <name> | Archive a completed project |
Setup
Run /workspace-kit:setup-projects to initialize:
projects/ ├── PROJECT_INDEX.md # Central project registry └── .project-template/ # Template for new projects sessions/ └── SESSION_INDEX.md # Session tracking
Project Structure
Each project folder contains:
projects/my-project/ ├── README.md # Project overview, goals, key files ├── STATUS.md # Current status, next steps, blockers ├── DECISIONS.md # Decision log with rationale └── [project files]
•README.md — Project description, goals (checkboxes), key files, related links
•STATUS.md — Current status (active/paused/completed), next steps, blockers, progress log
•DECISIONS.md — Decision log with dates, rationale, and outcomes
Session Structure
Sessions are date-based temporary workspaces:
sessions/
├── 2025-01-15_api-research/
│ ├── README.md
│ ├── notes.md
│ └── scratch.py
└── 2025-01-16_client-prep/
└── ...What Goes Where
| Content Type | Location | Why |
|---|---|---|
| Final deliverables | projects/ | Persistent, tracked |
| Project documentation | projects/ | Part of project |
| Code in development | projects/ | Version controlled |
| Daily work artifacts | sessions/ | Temporary |
| Research and exploration | sessions/ | May not be kept |
| Scratch files | sessions/ | Disposable |
Workflow
Starting Work
1.Check
projects/PROJECT_INDEX.md for active projects2.Open project's
STATUS.md to see next steps3.Create session if needed:
/workspace-kit:create-session researchDuring Work
•Update project
STATUS.md as you progress•Store temporary files in session folder
•Log decisions in
DECISIONS.mdEnding Work
•Update
STATUS.md with progress and next steps•Move final outputs from session to project
•Clean up temporary session files