# dotbot

## Docs

- [Two-phase execution engine](https://docs.dotbot.ch/concepts/execution-engine.md): Understand how dotbot splits every task into a focused analysis phase and a code-writing implementation phase to reduce errors and enable human review.
- [Per-task git worktree isolation](https://docs.dotbot.ch/concepts/git-worktree-isolation.md): Learn how dotbot gives every task its own git branch and worktree so multiple AI agents can write code simultaneously without file conflicts.
- [Task lifecycle states and transitions](https://docs.dotbot.ch/concepts/task-lifecycle.md): A complete reference for every state a dotbot task can be in, how tasks move between states, and how to handle tasks that need human input.
- [Workflows and stacks in dotbot](https://docs.dotbot.ch/concepts/workflows-and-stacks.md): Learn how dotbot uses workflow.yaml pipelines and technology stacks — with task types, stack inheritance, settings merge order, and install commands.
- [Audit trail and session logging in dotbot](https://docs.dotbot.ch/dashboard/audit-trail.md): Learn what dotbot captures in session logs, how to configure log levels and cost tracking, and how to trace commits back to the tasks that produced them.
- [Project health checks with dotbot doctor](https://docs.dotbot.ch/dashboard/health-diagnostics.md): Run dotbot doctor to scan for stale locks, orphaned worktrees, missing dependencies, and task queue issues — with remediation steps for each.
- [dotbot web dashboard overview](https://docs.dotbot.ch/dashboard/overview.md): Learn how to launch the dotbot web dashboard, navigate its seven tabs, use the kickstart dialog, and inspect AI provider detection in Settings.
- [Configure AI providers in your dotbot project](https://docs.dotbot.ch/guides/configuring-providers.md): Switch between Claude, Codex, and Gemini, set per-task model overrides in workflow.yaml, and verify provider authentication from the Settings tab.
- [Build and run custom workflows in dotbot](https://docs.dotbot.ch/guides/creating-workflows.md): Define a workflow.yaml pipeline with prompt, script, and task_gen tasks, configure the kickstart form, and install the workflow into your project.
- [Share workflows via enterprise registries](https://docs.dotbot.ch/guides/enterprise-registries.md): Publish and install dotbot workflows, stacks, and tools from a git-hosted registry, manage multiple registries, and author a registry.yaml manifest.
- [Route AI questions to your team via Teams](https://docs.dotbot.ch/guides/teams-integration.md): Configure Microsoft Teams notifications so dotbot can route needs-input tasks to stakeholders and resume automatically once an answer arrives.
- [Add technology stacks to your dotbot project](https://docs.dotbot.ch/guides/using-stacks.md): Install built-in stacks like dotnet and dotnet-blazor, understand stack inheritance via extends, compose multiple stacks, and see how settings merge.
- [Install dotbot on Windows, macOS, and Linux](https://docs.dotbot.ch/installation.md): dotbot is a pure PowerShell tool with no runtime dependencies beyond PowerShell and Git. Pick the install method that fits your workflow and platform.
- [What is dotbot? AI development with audit trails](https://docs.dotbot.ch/introduction.md): dotbot wraps AI coding in a managed workflow engine with version-controlled audit trails. See every decision, resume across sessions, and run tasks in parallel.
- [Add custom PowerShell tools to the MCP server](https://docs.dotbot.ch/mcp/adding-tools.md): Create custom dotbot MCP tools by dropping a metadata.yaml and script.ps1 into a tools subdirectory. No registration step or server restarts required.
- [Configure the dotbot MCP server for Claude and Warp](https://docs.dotbot.ch/mcp/configuration.md): Add the dotbot MCP server to Claude Desktop, Claude CLI, or Warp by pointing your AI tool at the dotbot-mcp.ps1 script in your project's .bot directory.
- [dotbot MCP server overview and tool reference](https://docs.dotbot.ch/mcp/overview.md): The dotbot MCP server connects your AI tool to the task queue, decision log, and session tracker. Reference for all 33 built-in tools across six categories.
- [Get started with dotbot in five steps](https://docs.dotbot.ch/quickstart.md): Install dotbot, initialize a project, connect your AI tool via MCP, launch the web dashboard, and run your first workflow in five steps.
- [dotbot architecture and directory layout](https://docs.dotbot.ch/reference/architecture.md): How dotbot's MCP server, web UI, and autonomous runtime fit together, plus a complete reference for the .bot/ directory tree and runtime state separation.
- [dotbot CLI commands and flags reference](https://docs.dotbot.ch/reference/commands.md): Complete reference for every dotbot CLI command, including init, run, workflow, registry, doctor, status, and update — with flags and usage examples.
- [Decision tracking MCP tools reference](https://docs.dotbot.ch/reference/mcp-tools/decision-tracking.md): Reference for dotbot's 7 decision tracking MCP tools — create, read, update, and transition decision records from proposed through accepted or superseded.
- [Plans and operator steering MCP reference](https://docs.dotbot.ch/reference/mcp-tools/plans-and-steering.md): Reference for dotbot's plan management tools, the steering_heartbeat operator whisper mechanism, and the dev_start and dev_stop environment control tools.
- [Session management MCP tools reference](https://docs.dotbot.ch/reference/mcp-tools/session-management.md): Reference for all 5 dotbot session management MCP tools — initialising sessions, reading state and stats, updating fields, and tracking completed tasks.
- [Task management MCP tools reference](https://docs.dotbot.ch/reference/mcp-tools/task-management.md): Reference for all 15 dotbot task management MCP tools — creation, retrieval, state transitions, Q&A, and split management — with parameters and usage notes.
- [AI provider integration in dotbot](https://docs.dotbot.ch/reference/providers.md): Supported AI providers in dotbot — Claude, Codex, and Gemini — covering permission modes, authentication, per-task model overrides, and switching providers.
- [dotbot settings.default.json reference guide](https://docs.dotbot.ch/reference/settings.md): Complete reference for dotbot settings files and merge order — provider selection, model defaults, concurrency limits, logging, cost tracking, and sync.
- [Testing your project with dotbot verify hooks](https://docs.dotbot.ch/reference/testing.md): Configure verify hooks so dotbot automatically runs your test suite after every task, catches regressions before merging, and enforces code quality gates.
- [workflow.yaml schema reference for dotbot](https://docs.dotbot.ch/reference/workflow-yaml.md): Full schema reference for workflow.yaml — top-level fields, agents, skills, form modes, requires section, and the tasks pipeline with all supported fields.