Documentation Index

Fetch the complete documentation index at: https://panopticon-cli.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Meta Repos

​

What a Meta Repo Contains

team-meta/
├── .agent-template/              # Copied into every workspace
│   └── .claude/
│       ├── CLAUDE.md             # Project conventions for agents
│       └── skills/               # Team-specific skills
│           └── workspace-add-repo/
├── panopticon/                   # Panopticon-specific config
│   └── repo-groups.yaml          # Repo group definitions
├── docs/                         # Architecture and reference docs
│   ├── repo-map.md               # What each repo does
│   ├── architecture.md           # System architecture overview
│   └── onboarding/               # Team onboarding materials
│       ├── checklist.md          # Prerequisites checklist
│       ├── machine-setup.sh      # Automated setup script
│       └── README.md
└── README.md

​

Directory Structure

​

.agent-template/

​

panopticon/repo-groups.yaml

groups:
  simphony:
    - int-micros-simphony
    - int-micros-simphony-api
    - micros-symphony-canonical-transform

  aloha:
    - int-aloha
    - int-aloha-hrbridge
    - aloha-agent-canonical-transfer

  shared-lib:
    - int-aws-hs-service
    - int-aws-store-config-labels

​

docs/

​

Creating a Meta Repo

​

Via Setup Wizard

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]: _

​

Via Setup Agent

1. Explores all repositories in the project
2. Detects conventions, patterns, and dependencies
3. Generates CLAUDE.md with only non-obvious project-specific rules
4. Generates repo-map.md documenting each repo’s purpose
5. Generates repo-groups.yaml with logical groupings
6. Generates onboarding checklist with prerequisites

​

Manual Creation

mkdir -p team-meta/{.agent-template/.claude,panopticon,docs/onboarding}

​

Onboarding Flow

1. Clone the meta repo
   git clone git@github.com:yourorg/team-meta.git
   
2. Run the machine setup script
   cd team-meta/docs/onboarding
   ./machine-setup.sh
   
   This installs prerequisites, authenticates CLI tools, and clones repositories.
3. Run pan setup
   pan setup
   
   The wizard detects existing repos and applies your team’s template with pre-configured settings.
4. Ready to work
   pan workspace create INT-123
   

​

Updating the Meta Repo

1. Update the meta repo (normal git workflow)
2. Changes propagate when agents sync skills:
   pan sync
   

• A new workspace is created
• pan sync is run
• The Setup Agent runs and regenerates files

​

Meta Repo Best Practices

​

What to Include in CLAUDE.md

• How to run npm install, git commit, etc. (LLMs know these)
• Standard industry practices

• Deviations from defaults — “PRs target qa not main”
• Per-repo quirks — “Each Lambda has its own package.json, no root one”
• Breaking behaviors — “Never run terraform apply without approval”
• Architecture patterns — “API gateway handles auth, microservices don’t”

​

What to Include in Repo Map

• Purpose — What the repo does
• Dependencies — What it depends on, what depends on it
• Common change patterns — “Changes here usually need corresponding changes in api-service”
• Key files — Where to start looking

​

Machine Setup Script

#!/bin/bash
# Auto-generated by Panopticon Setup Agent

echo "=== Team Onboarding Setup ==="

# Check prerequisites
command -v git >/dev/null || { echo "Install git first"; exit 1; }
command -v gh >/dev/null || { echo "Install GitHub CLI"; exit 1; }
command -v node >/dev/null || { echo "Install Node.js 20+"; exit 1; }

# Authenticate GitHub CLI
gh auth status || gh auth login

# Clone repos
REPOS=(
  "yourorg/int-micros-simphony"
  "yourorg/int-toast"
)

for repo in "${REPOS[@]}"; do
  name=$(basename "$repo")
  if [ ! -d "$name" ]; then
    gh repo clone "$repo" "$name"
  fi
done

echo "Done! Run 'pan status' to verify setup."

​

Related Guides

• Progressive Polyrepo — Progressive workspace configuration
• Setup Wizard — Interactive project setup
• Projects — Project registry and configuration