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.

  1. 01Start

    install and first task

  2. 02Run

    scope through verification

  3. 03Control

    settings and model tiers

  4. 04Learn

    codebase and project memory

  5. 05Govern

    initiatives, safety, release

  6. 06View

    dashboard and status

  7. 07Build

    architecture and contracts

  8. 08Migrate

    verified v1 cutover

Each route keeps its own reading order and ends at an explicit terminus.

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

Start with one bounded task.

The Start route covers installation, the first approval path, the command surface, and the evidence left on disk.