diff --git a/CLAUDE.md b/CLAUDE.md index e9b244e6..4ee88d51 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -37,10 +37,9 @@ Town (/Users/stevey/gt) ## Project Info -This is the **Go port** of Gas Town, a multi-agent workspace manager. +Gas Town is a multi-agent workspace manager written in Go. - **Issue prefix**: `gt-` -- **Python version**: ~/ai/gastown-py (reference implementation) - **Architecture**: docs/architecture.md ## Development diff --git a/docs/architecture.md b/docs/architecture.md index 37f7e79c..ba670002 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -73,7 +73,6 @@ gt install ~/gt --git # Create HQ with git **See**: [docs/hq.md](hq.md) for comprehensive HQ documentation, including: - Beads redirect patterns for complex setups -- Multi-system sharing (PGT/GGT coexistence) - HQ templates for organizations - Migration between HQs @@ -2299,10 +2298,8 @@ Federation is tracked in **gt-9a2** (P3 epic). Key tasks: ## Implementation Status -Gas Town is being ported from Python (gastown-py) to Go (gastown). The Go port (GGT) is in development: +Gas Town is written in Go. Current development epics: -- **Epic**: gt-u1j (Port Gas Town to Go) -- **Scaffolding**: gt-u1j.1 (Go scaffolding - blocker for implementation) - **Management**: gt-f9x (Town & Rig Management: install, doctor, federation) See beads issues with `bd list --status=open` for current work items. diff --git a/docs/hq.md b/docs/hq.md index d2fa6ab2..3dee7900 100644 --- a/docs/hq.md +++ b/docs/hq.md @@ -118,57 +118,9 @@ mayor/rigs/gastown/.beads ``` **When to use redirects:** -- Shared HQ between different Gas Town versions (PGT/GGT) - When rig beads should be the canonical town beads - Hybrid setups where agents work in different locations -## Multiple Gas Towns in One Location - -Sometimes you need to run multiple Gas Town systems from the same parent directory. This creates a "shared HQ" scenario. - -### The Problem - -If Python Gas Town (PGT) and Go Gas Town (GGT) both use `~/ai/`: -``` -~/ai/ -├── .gastown/ # PGT runtime config (hidden) -├── .runtime/ # GGT runtime state (gitignored) -├── .beads/ # Which system owns this? -├── mayor/ # PGT mayor? GGT mayor? -└── gastown/ # PGT rig? GGT rig? -``` - -Note: GGT uses `.runtime/` for runtime state and `settings/` for behavioral config. -PGT uses `.gastown/` for both. - -### Solutions - -**Option 1: Separate HQs (recommended)** -``` -~/ai/ # PGT HQ -~/gt/ # GGT HQ (separate) -``` - -**Option 2: Namespaced directories** -``` -~/ai/ -├── pgt/ # PGT HQ -│ ├── mayor/ -│ └── gastown/ -└── ggt/ # GGT HQ - ├── mayor/ - └── gastown/ -``` - -**Option 3: Beads redirect (advanced)** -``` -~/ai/ -├── .beads/redirect # Points to canonical location -├── pgt-mayor/ # PGT-specific -├── ggt-mayor/ # GGT-specific -└── gastown/ # Shared rig -``` - ## HQ Configuration Files ### mayor/town.json