Guides

Task guides for adopting, operating and developing Praetor, grouped by what you are doing. Each group opens with a short index that names the page to read first.

New here? Pick the path that matches your role:

• Adopting Praetor in a repository: start with Fast adoption.
• Contributing to Praetor itself: start with Contributing to Praetor.
• Running Praetor on a workstation: start with Workstation install and status.

Guide groups

• Adoption and onboarding: bring a repository under governance and verify what adoption declared.
• Agents, clients and model routing: agent hooks, client and editor configuration, context tools and model routing.
• Contributing, hooks and CI: local verification, Git hooks, the development MCP server and CI caching.
• State ledger and planning: the private ledger, planning drafts, wishes, issue sync, resource cleanup, the research and upstream radar and the efficiency ledger.
• Dogfooding: running Praetor against public repositories and repairing what fails.
• Workstations, devcontainers and operations: installing the engine, devcontainers, workstation sync and operational configuration.
• Build, release and deployment: release tags, the Helm chart, canary upgrades and the builder.
• Documentation governance: the Markdown gate, documentation drift, text register and the wiki sync.