Skip to content

Planning Work

This project uses a shared plans repository for planning and work management.

Plans Repository

All planning documents, specs, proposals, and task tracking live in a sibling plans repository:

~/dev/
├── plans/              # Planning docs, specs, beads
├── cloud_control_plane/ # This repo - code
└── ...

Key tools in the plans repository:

  • OpenSpec: Creating proposals and specs (/proposal, /apply)
  • Beads: Task tracking and work management (bd ready, bd show, bd close)
  • Workflow: Session completion and sync process

Quick Reference

For Humans

  1. Create proposals/specs with OpenSpec
  2. Import approved tasks to beads
  3. Check progress with bd stats or bd list

For AI Agents

bd ready              # Find available work (no blockers)
bd show <id>          # View issue details
bd update <id> --status in_progress  # Claim work
bd close <id>         # Complete work
bd sync               # Sync with git

Cross-Repository Work

  • Planning artifacts (specs, proposals, beads) → plans repo
  • Code changes → this repo (cloud_control_plane)
  • Each repo has its own git history—commit to the correct repo

Agent Workflow Docs (This Repo)

Use these when executing implementation/debugging tasks in cloud_control_plane: