Merge polecat/Dementus: harness design documentation (gt-cr9)

This commit is contained in:
Steve Yegge
2025-12-19 12:50:26 -08:00
4 changed files with 401 additions and 356 deletions

View File

@@ -31,14 +31,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