Documentation
Start with the job. Follow the route.
Run one task first, then move into execution, control, learning, governance, inspection, or extension only when the work needs more detail.
Page evidence
Reading routes
map / active Choose the operating job, then follow its guides.
- 01Start
install and first task
- 02Run
scope through verification
- 03Control
settings and model tiers
- 04Learn
codebase and project memory
- 05Govern
initiatives, safety, release
- 06View
dashboard and status
- 07Build
architecture and contracts
- 08Migrate
verified v1 cutover
Reading map
Eight jobs. No mystery shelf.
Start
Install Guild Stack, run one bounded task, and learn where its evidence lands.
6 guidesRun
Turn approved intent into scoped specialist lanes, typed handoffs, review findings, and closure evidence.
2 guidesControl
Understand and override the model tier chosen for each specialist lane.
3 guidesLearn
Map a codebase, keep canonical knowledge local, and evolve reusable capability through explicit gates.
5 guidesGovern
Carry goals across runs while keeping workspace boundaries, permissions, quality, operations, and traces explicit.
2 guidesView
Inspect recorded work through the local dashboard or the optional Claude Code status line.
3 guidesBuild
Trace module ownership, host boundaries, typed communication, and canonical vocabulary.
1 guideMigrate
Move from v1 to v2 by mapping commands and settings, then proving one complete run.
Every guide
Browse all 26 guides.
Show all 26 guides
Start
- Get started with Guild Stack
Install Guild Stack on a receipt-verified host or preview one of 16 named targets, then run one bounded task with local .guild/ evidence.
- How Guild Stack works
Follow one task through Guild Stack's six-phase lifecycle, three entry lenses, approval gates, specialist lanes, review, and reflection.
- Command reference
The flat /guild:<verb> command surface: run the lifecycle, jump phases, inspect status, query memory, tune settings, and keep approval gates visible.
- Installation and updates
Install Guild Stack through the supported host path, choose stable or beta, inspect the install receipt, and apply updates without hiding host limits.
Run
- Choose the right operating scope
How Guild Stack scopes work across workspace, project, optional initiative, and run — and where durable state belongs at each level.
- Specialist roster
Meet Guild Stack's roster: 15 domain specialist templates minted on demand, plus the advisor and developer machinery agents, for scoped lanes and typed handoffs.
- Context assembly
Guild Stack gives each specialist a focused context bundle before dispatch: task lane, required skills, relevant wiki pages, and no project-wide dump.
- Dispatch and execution
How Guild Stack turns an approved plan into specialist tasks, selects an execution mode, records handoffs, and recovers failed lanes.
- Adversarial review
How Guild Stack challenges AI work before trusting it: independent review packets, bounded rounds, recorded verdicts, and no silent weak sign-offs.
- Verify a host-adapter migration run
The migration-specific evidence packet, reviewer requirements, and followup policy used to verify work against the host-adapter migration spec.
Control
- Configuration reference
Guild Stack settings: one settings.json file, seven-source inheritance, closed-key validation, model tiers, dispatch mode, security, and MCP pins.
- Cost-aware model tiering
Guild Stack routes each specialist lane to the cheapest model tier that fits the work, with deterministic scoring, overrides, and advisor escalation.
Learn
- Understand your codebase
Use /guild:learn to map a codebase, build a knowledge graph, produce an onboarding tour, analyze changes, and approve deeper scans before they run.
- Project memory and wiki
Guild Stack records canonical project memory as gated Markdown under .guild/wiki/, then derives recall indexes, graph views, and specialist context from it.
- Evolve skills and specialists
Guild Stack can learn from real runs without silent mutation: reflections propose better skills or specialists, evals test them, and you approve promotion.
Govern
- Run durable initiatives
Use initiatives when a Guild Stack goal spans sessions, branches, or repos: attach runs by choice, track evidence, and close only after exec, release, and docs-sync gates.
- Workspaces and federation
Use Guild Stack across a repo of repos without copying knowledge up: workspace manifests, child wikis, read-through recall, and settings inheritance.
- Quality and operations
Run release checks and operations without losing control: computed quality verdicts, approved runbooks, dry-runs, and hard safety rails.
- Security and permissions
What Guild Stack may touch, what always requires approval, and how repo content, secrets, network access, and MCP tools stay inside explicit boundaries.
- Run traces and observability
Inspect what Guild Stack did after a run: manifests, provenance, handoff receipts, verification, event logs, and local dashboard views under .guild/runs/.
View
- Inspect runs in the local dashboard
Launch the benchmark dashboard on 127.0.0.1, import recorded Guild Stack runs, and inspect timelines, knowledge, and wiki evidence without a cloud service.
- Claude Code status line
Add an opt-in Claude Code status line for active Guild Stack runs: loop round, cap, loop mode, restart count, and phase signal when available.
Build
- System architecture
Guild Stack internals: one lifecycle, module-owned resources, host adapters, file receipts, settings resolution, and durable .guild/ evidence.
- Handoff and communication contracts
The Guild handoff bus: specialists write typed receipts under .guild/runs/, and leads, review, verification, and replay consume files.
- Glossary
The canonical Guild Stack vocabulary for nesting, lifecycle, host, substrate, review, knowledge, and model tiering.
Migrate
- Migrate from v1 to v2
Move from Guild Stack v1 to v2: command renames, settings.json migration, rigor flags, phase verbs, and the approval-gated lifecycle.
Ready to move