Campaign Setup

Set up a campaign workspace from scratch. You will create the workspace, add shell integration, bring in your projects as submodules, navigate efficiently with shortcuts, and connect festival planning to your codebase.

Create a Campaign

Start by initializing a new campaign workspace:

camp init my-startup
cd my-startup

This creates the following directory structure:

my-startup/
├── projects/          # Git submodules for all your codebases
├── festivals/         # Festival Methodology workspace
├── docs/              # Human-authored documentation
├── ai_docs/           # AI research and documentation
├── workflow/           # Workflow management (reviews, pipelines, design)
├── dungeon/           # Archived and deprioritized work
├── justfile           # Command runner recipes
└── CLAUDE.md          # Agent memory document

Shell Integration

Add camp and fest shell functions to your shell config:

# Add to ~/.zshrc
eval "$(camp shell-init zsh)"
eval "$(fest shell-init zsh)"

Reload your shell:

source ~/.zshrc

This gives you two navigation commands:

  • cgo - campaign navigation (directories, projects, categories)
  • fgo - festival navigation (jump to festivals, toggle between planning and code)

Use cgo with category shortcuts to move around your workspace instantly:

cgo              # Campaign root
cgo p            # projects/
cgo f            # festivals/
cgo d            # docs/
cgo a            # ai_docs/
cgo w            # worktrees/

No more typing long paths. Every important directory is one shortcut away.

Add Projects

Bring your codebases into the campaign as git submodules:

camp project add https://github.com/you/api-service
camp project add https://github.com/you/web-app
camp project list  # See all projects

Projects live under projects/ as git submodules. They retain their own git history, branches, and remotes while staying tracked by the campaign.

Navigate to any project with fuzzy matching:

cgo p api        # Jump to projects/api-service

Switch between projects and the campaign root without thinking about paths:

cgo p api        # Jump to projects/api-service
cgo p web        # Jump to projects/web-app
cgo              # Back to campaign root

Fuzzy matching means you only need to type enough characters to uniquely identify the project.

Initialize Festival Planning

Set up the festivals directory for structured project planning:

fest init

This creates the festival lifecycle subdirectories:

festivals/
├── planning/      # Festivals being designed
├── active/        # Currently executing
├── ready/         # Prepared, awaiting execution
├── ritual/        # Recurring or special festivals
└── dungeon/       # Terminal statuses (completed, archived, someday)

Create Your First Festival

A festival is a goal-oriented project plan with phases, sequences, and tasks:

fest create festival --type standard my-first-feature

Navigate to it with either command:

fgo my-first-feature   # Jump directly to the festival
cgo f                  # Jump to the festivals directory

Connect your festival to the project it plans work for:

fest link

Now fgo toggles between the festival directory and the linked project directory. Jump back and forth between planning and code without losing context.

Planning Tools

Camp provides lightweight planning tools to capture and prioritize work:

camp intent          # Capture ideas and goals
camp leverage        # Score projects by impact
camp dungeon         # Archive deprioritized work

Use these to decide what deserves a festival and what belongs in the dungeon.

Health Check

Keep your campaign in good shape:

camp doctor          # Diagnose campaign issues
camp sync            # Sync all submodules

Run camp doctor periodically to catch stale submodules, broken links, or structural problems before they slow you down.

Register Globally

If you work across multiple campaigns, register them for quick switching:

camp register        # Add current campaign to global registry
camp list            # See all registered campaigns
camp switch          # Switch between campaigns

This lets you manage several campaign workspaces from anywhere in your terminal.

What You Built

You now have a fully structured campaign workspace with:

  • Projects tracked as git submodules under projects/
  • Festival planning initialized and ready for structured execution
  • Shell navigation via cgo and fgo for instant movement
  • Global registration for multi-campaign workflows

Next Steps