johno/gastown
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat: rename harness to HQ throughout docs and code (gt-a41)

Browse Source 
The "hq-" prefix for town-level beads revealed that "HQ" (headquarters)
is a better name than "harness" for the top-level Gas Town structure.

- Renamed docs/harness.md to docs/hq.md with updated content
- Updated all documentation references in architecture.md and bootstrap.md
- Updated CLI help text and user-facing messages in install.go
- Updated gitinit.go with HQGitignore constant and HQ terminology
- Updated molecule templates in builtin_molecules.go
- Kept InitGitForHarness function name for backwards compatibility

HQ is more intuitive (where the mayor sits), fits the Mad Max aesthetic,
matches the beads prefix (hq-*), and is self-documenting.

🤖 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-20 14:24:49 -08:00
parent afee8bba17
commit 91a0f3b80f
7 changed files with 542 additions and 539 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
docs/bootstrap.md
View File

@@ -1,6 +1,6 @@
# Bootstrapping Gas Town from a Harness
# Bootstrapping Gas Town from an HQ
This guide documents how to bootstrap a full Gas Town installation from a harness repository (e.g., `steveyegge/stevey-gt`).
This guide documents how to bootstrap a full Gas Town installation from an HQ repository (e.g., `steveyegge/stevey-gt`).
## Prerequisites
@@ -10,17 +10,17 @@ This guide documents how to bootstrap a full Gas Town installation from a harnes
## Overview
A Gas Town harness is a template repository containing:
A Gas Town HQ is a template repository containing:
- Town-level configuration (`mayor/`, `.beads/`)
- Rig configs (`gastown/config.json`, `beads/config.json`)
- CLAUDE.md for Mayor context
The harness does NOT contain:
The HQ does NOT contain:
- The actual gt binary (must be built)
- Full rig structures (must be populated)
- Agent state files (must be created)
## Step 1: Clone the Harness
## Step 1: Clone the HQ
```bash
git clone git@github.com:steveyegge/stevey-gt.git ~/gt
@@ -62,7 +62,7 @@ cp gt ~/bin/gt
## Step 5: Populate Rig Structures
For each rig in your harness (gastown, beads, etc.), create the full agent structure:
For each rig in your HQ (gastown, beads, etc.), create the full agent structure:
### Gastown Rig
@@ -165,13 +165,13 @@ Here's a condensed script for bootstrapping:
set -e
# Configuration
HARNESS_REPO="git@github.com:steveyegge/stevey-gt.git"
HQ_REPO="git@github.com:steveyegge/stevey-gt.git"
GASTOWN_REPO="git@github.com:steveyegge/gastown.git"
BEADS_REPO="git@github.com:steveyegge/beads.git"
TOWN_ROOT="$HOME/gt"
# Clone harness
git clone "$HARNESS_REPO" "$TOWN_ROOT"
# Clone HQ
git clone "$HQ_REPO" "$TOWN_ROOT"
cd "$TOWN_ROOT"
# Install Go if needed