pan setup

$ pan setup

Welcome to Overdeck Project Setup!

Step 1: Project Location
  Where is your project? [/home/user/Projects/MyProject]: _
  Scanning directory structure...

Step 2: Project Type Detection
  Found: 31 git repositories in subdirectories
  Detected: Polyrepo (multiple independent git repos)

  Is this correct? [Y/n]: _

Step 3: Template Selection
  Based on your project structure, recommended template:
  → progressive-polyrepo (30+ repos, team meta repo, progressive workspaces)

  Available templates:
    1. simple-app        — Single repo, standard branching
    2. monorepo          — One repo, multiple packages/services
    3. polyrepo          — 2-10 repos, all checked out per workspace
    4. progressive-polyrepo — 10+ repos, on-demand checkout
    5. custom            — Start from scratch

  Select template [4]: _

Step 4: Repository Configuration
  Scanning 31 repos for branch information...

  Default branch detected:
    - 17 repos use 'master'
    - 14 repos use 'main'

  PR target branch:
    What branch should PRs target? [main]: qa

  Would you like to organize repos into groups? [Y/n]: _

Step 5: Issue Tracker
  Which issue tracker does this project use?
    1. Linear
    2. GitHub Issues
    3. Rally
    4. GitLab Issues
    5. None / Manual

  Select [3]: _

  Rally artifact types to track [F,US,DE,TA]: _
  Rally project name: _

Step 6: Meta Repo
  Progressive polyrepo projects use a meta repo for shared skills,
  architecture docs, and team conventions.

  Create a new meta repo? [Y/n]: _
  Meta repo name [team-meta]: _

  Would you like the Setup Agent to analyze your codebase and
  generate initial docs? [Y/n]: _

  [Spawning Setup Agent...]

Step 7: Review & Save
  Here's your configuration:
  [YAML preview]

  Save to ~/.overdeck/projects.yaml? [Y/n]: _

  Done! Next steps:
  - Run 'pan workspace create F29698' to test workspace creation
  - Review generated docs in team-meta/
  - Share team-meta/ with your team for onboarding

templates/project-types/
├── simple-app/
│   ├── template.yaml          # Template metadata + defaults
│   └── agent-template/        # .claude/ skeleton
│       └── .claude/
│           ├── .overdeck/context/project.md
│           └── skills/
├── monorepo/
├── polyrepo/
└── progressive-polyrepo/
    ├── template.yaml
    ├── agent-template/
    └── meta-repo-scaffold/    # Skeleton for the meta repo

# template.yaml
name: progressive-polyrepo
description: Large-scale polyrepo with 10+ repos and progressive workspace creation
recommended_when:
  min_repos: 10
  has_meta_repo: true

defaults:
  workspace:
    type: polyrepo
    progressive: true
    workspaces_dir: workspaces
  specialists:
    merge: false

prompts:
  - key: pr_target
    question: "What branch should PRs target?"
    default: main
    type: string
  - key: create_meta
    question: "Create a meta repo for shared skills and docs?"
    default: true
    type: boolean
  - key: meta_name
    question: "Meta repo name?"
    default: "team-meta"
    type: string
    condition: create_meta == true

team-meta/
├── .agent-template/              # Copied into every workspace
│   └── .claude/
│       ├── .overdeck/context/project.md # Managed project conventions
│       └── skills/
├── overdeck/                   # Overdeck-specific config
│   └── repo-groups.yaml          # Repo group definitions
├── docs/
│   ├── repo-map.md               # What each repo does
│   ├── architecture.md           # System architecture
│   └── onboarding/
│       ├── checklist.md          # Prerequisites checklist
│       ├── machine-setup.sh      # Automated setup script
│       └── README.md
└── README.md

# Setup Agent prompt includes:
- Project context (name, path, type, repo count, tracker)
- Detected repositories table
- Tasks: Generate .overdeck/context/project.md, repo-map.md, repo-groups.yaml, onboarding checklist
- Output location: {{META_REPO_PATH}}/