docs: add harness design documentation (gt-cr9)

Create comprehensive harness documentation covering:
- What a harness is (installation directory vs town concept)
- Harness structure and creation with gt install
- Beads redirect patterns for complex setups
- Multi-system sharing (PGT/GGT coexistence)
- Configuration files (town.json, rigs.json, state.json)
- Harness templates for organizations
- Migration between harnesses

Update architecture.md to:
- Rename "Town" section to "Harness (Town)" with clearer explanation
- Add cross-references to new harness.md
- Update directory structure section with "Harness Level" heading
- Expand CLI commands section with more gt install options

Update install.go help text to reference harness.md.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-12-19 12:02:04 -08:00
parent 95ba8fcb6b
commit 1e6a363757
3 changed files with 386 additions and 24 deletions

View File

@@ -30,14 +30,18 @@ var installCmd = &cobra.Command{
Short: "Create a new Gas Town harness (workspace)",
Long: `Create a new Gas Town harness at the specified path.
A harness is the top-level directory where Gas Town is installed. It contains:
A harness is the top-level directory where Gas Town is installed - the root of
your workspace where all rigs and agents live. It contains:
- CLAUDE.md Mayor role context (Mayor runs from harness root)
- mayor/ Mayor config and state
- rigs/ Managed rig clones (created by 'gt rig add')
- .beads/ Town-level beads DB (mayor mail, coordination)
- mayor/ Mayor config, state, and rig registry
- rigs/ Managed rig containers (created by 'gt rig add')
- .beads/ Town-level beads DB (gm-* prefix for mayor mail)
If path is omitted, uses the current directory.
See docs/harness.md for advanced harness configurations including beads
redirects, multi-system setups, and harness templates.
Examples:
gt install ~/gt # Create harness at ~/gt
gt install . --name my-workspace # Initialize current dir