Claude Code Workflow Setup

A plug-and-play workflow system for Claude Code that helps you maintain context across sessions using /hello and /bye commands.

What This Does

This workflow solves the "where did we leave off?" problem when working with Claude Code across multiple sessions and projects. It provides:

• /hello - Start a session by selecting a project and loading its context
• /bye - End a session by saving notes and updating project status
• Layered documentation - Brief overviews + detailed technical notes
• Git integration - Automatic commit/push reminders
• Multi-project support - Code projects (with git) and documentation-only projects
• Development standards - Consistent coding guidelines (DRY, YAGNI, git conventions, security)
• Project template - Quick-start scaffolding for new projects
• MVP mode - AI Co-Founder template for startups with autonomous execution

Quick Start

Choose your preferred setup method:

Option 1: Script Setup (Recommended)

Linux/Mac:

git clone https://github.com/cato-pine/claude-workflow-setup.git
cd claude-workflow-setup
./scripts/setup.sh

Windows PowerShell:

git clone https://github.com/cato-pine/claude-workflow-setup.git
cd claude-workflow-setup
.\scripts\setup.ps1

Option 2: Claude-Driven Setup

1. Copy commands/setup.md to ~/.claude/commands/
2. Run /setup in Claude Code
3. Follow Claude's prompts

Option 3: Manual Setup

See docs/MANUAL-SETUP.md for step-by-step instructions.

Folder Structure

After setup, you'll have:

~/projects/                    # Code projects (git repos)
├── my-app/
│   └── CLAUDE-INSTRUCTIONS.md
└── another-project/
    └── CLAUDE-INSTRUCTIONS.md

~/CloudSync/Claude/            # Documentation & notes (your cloud sync folder)
├── SessionNotes/              # Brief session summaries
├── claude-projects/           # Documentation-only projects
│   └── research-project/
│       ├── CLAUDE-INSTRUCTIONS.md
│       └── SessionNotes/      # Detailed notes for this project
└── README.md

How It Works

Starting a Session (/hello)

1. Lists all your projects (code + documentation)
2. You pick one to work on
3. Claude reads the project's CLAUDE-INSTRUCTIONS.md
4. Claude pulls latest code (if git project)
5. Claude reads NEXT-SESSION-START-HERE.md for context

Ending a Session (/bye)

1. Creates brief session summary (what was done across all projects)
2. Creates detailed technical notes (per project)
3. Updates CLAUDE-INSTRUCTIONS.md with current status
4. Asks about git commits/pushes
5. Updates NEXT-SESSION-START-HERE.md for next time

Project Types

Code Projects (in ~/projects/)

• Have git repositories
• /hello pulls latest code
• /bye handles commits and pushes

Documentation Projects (in cloud sync folder)

• No git required
• Great for research, planning, non-code work
• All files sync via your cloud service

MVP/Startup Projects (in ~/projects/)

• AI Co-Founder mode with proactive, autonomous execution
• Decision frameworks, metrics tracking, structured reviews
• Claude proposes solutions, executes within defined autonomy bounds
• Perfect for startups and side projects

Requirements

• Claude Code installed
• A cloud sync folder (Dropbox, pCloud, Google Drive, OneDrive, etc.)
• Git (for code projects)

Documentation

• Manual Setup Guide - Step-by-step instructions
• Concepts & Philosophy - Why this workflow exists
• FAQ - Common questions and troubleshooting

Examples

See the examples/ folder for filled-in examples of:

• A code project with git
• A documentation-only project
• Session notes

License

MIT License - see LICENSE

Contributing

Contributions welcome! Feel free to open issues or PRs.