# pair

> AI-assisted software development — structured Knowledge Base, Agent Skills, and adoption files for AI coding assistants.

## 

- [Welcome](https://pair.foomakers.com/docs)

## Docs

- [Concepts](https://pair.foomakers.com/docs/concepts)
- [How to Contribute](https://pair.foomakers.com/docs/contributing)
- [What is pair?](https://pair.foomakers.com/docs/getting-started)
- [Guides](https://pair.foomakers.com/docs/guides)
- [AI Coding Tools](https://pair.foomakers.com/docs/integrations)
- [Migrations](https://pair.foomakers.com/docs/migrations)
- [Project Management Tools](https://pair.foomakers.com/docs/pm-tools)
- [Process Lifecycle](https://pair.foomakers.com/docs/process-lifecycle)
- [Reference](https://pair.foomakers.com/docs/reference)
- [Support](https://pair.foomakers.com/docs/support)
- [Tutorials](https://pair.foomakers.com/docs/tutorials)
- [What's new in v0.5.1](https://pair.foomakers.com/docs/whats-new)

## Concepts

- [Adoption Files](https://pair.foomakers.com/docs/concepts/adoption-files)
- [Agent Integration](https://pair.foomakers.com/docs/concepts/agent-integration)
- [AI-Assisted SDLC](https://pair.foomakers.com/docs/concepts/ai-assisted-sdlc)
- [Canonical States & State Mapping](https://pair.foomakers.com/docs/concepts/canonical-states)
- [Code Host vs PM Tool](https://pair.foomakers.com/docs/concepts/code-host)
- [Definition of Ready & Done](https://pair.foomakers.com/docs/concepts/definition-of-ready-and-done)
- [Glossary](https://pair.foomakers.com/docs/concepts/glossary)
- [Knowledge Base](https://pair.foomakers.com/docs/concepts/knowledge-base)
- [llms.txt](https://pair.foomakers.com/docs/concepts/llms-txt)
- [Package-local adoption](https://pair.foomakers.com/docs/concepts/package-local-adoption)
- [PR State Flow (gate ≠ review)](https://pair.foomakers.com/docs/concepts/pr-state-flow)
- [Dedicated Review Identity](https://pair.foomakers.com/docs/concepts/review-identity)
- [Skills](https://pair.foomakers.com/docs/concepts/skills)
- [Tag-Driven Quality Gates](https://pair.foomakers.com/docs/concepts/tag-driven-gates)

## Contributing

- [Architecture](https://pair.foomakers.com/docs/contributing/architecture)
- [Batch engine internals](https://pair.foomakers.com/docs/contributing/batch-engine-internals)
- [Development Setup](https://pair.foomakers.com/docs/contributing/development-setup)
- [Release Process](https://pair.foomakers.com/docs/contributing/release-process)
- [Writing Guidelines](https://pair.foomakers.com/docs/contributing/writing-guidelines)
- [Writing Migration Pages](https://pair.foomakers.com/docs/contributing/writing-migration-pages)
- [Writing Skills](https://pair.foomakers.com/docs/contributing/writing-skills)

## Getting started

- ["Bootstrap: guided or quick"](https://pair.foomakers.com/docs/getting-started/bootstrap-quick-mode)
- [Solo, team or organization](https://pair.foomakers.com/docs/getting-started/choose-your-path)
- [Quickstart](https://pair.foomakers.com/docs/getting-started/quickstart)
- [Verify your setup](https://pair.foomakers.com/docs/getting-started/verify)

## Guides

- [Adopt pair in an existing repository](https://pair.foomakers.com/docs/guides/adopt-existing-repo)
- [Assess security, cost and coupling](https://pair.foomakers.com/docs/guides/assess-security-cost-coupling)
- [Configure autonomy and per-stage engine and model](https://pair.foomakers.com/docs/guides/autonomy-and-profiles)
- [Configure card states, DoR/DoD and the process profile](https://pair.foomakers.com/docs/guides/card-states)
- [Classify stories and use risk tags](https://pair.foomakers.com/docs/guides/classify-risk)
- [Configure another harness](https://pair.foomakers.com/docs/guides/configure-harness)
- [Customize the Knowledge Base for your team](https://pair.foomakers.com/docs/guides/customize-for-your-team)
- [Customize templates](https://pair.foomakers.com/docs/guides/customize-templates)
- [Deliver a card with the delivery workflow](https://pair.foomakers.com/docs/guides/deliver-a-card)
- [Deliver multiple cards automatically](https://pair.foomakers.com/docs/guides/deliver-many-cards)
- [Measure delivery](https://pair.foomakers.com/docs/guides/delivery-metrics)
- [Own and publish a Knowledge Base](https://pair.foomakers.com/docs/guides/external-kb)
- [Cycle Hooks and Blocking Severities](https://pair.foomakers.com/docs/guides/hooks-and-severities)
- [Install via the Claude Code marketplace](https://pair.foomakers.com/docs/guides/install-via-marketplace)
- [Join a project that already uses pair](https://pair.foomakers.com/docs/guides/join-a-pair-project)
- [Package-local rules in a monorepo](https://pair.foomakers.com/docs/guides/monorepo-rules)
- [Set up quality gates and the coverage ratchet](https://pair.foomakers.com/docs/guides/quality-gates)
- [Configure a review identity and light auto-approval](https://pair.foomakers.com/docs/guides/review-identity)
- [Automate work via tags](https://pair.foomakers.com/docs/guides/tag-automation)
- [Update the Knowledge Base](https://pair.foomakers.com/docs/guides/update-kb)

## Integrations

- [Adding a Harness](https://pair.foomakers.com/docs/integrations/adding-a-harness)
- [Claude Code](https://pair.foomakers.com/docs/integrations/claude-code)
- [Codex](https://pair.foomakers.com/docs/integrations/codex)
- [Cursor](https://pair.foomakers.com/docs/integrations/cursor)
- [GitHub Copilot](https://pair.foomakers.com/docs/integrations/github-copilot)
- [opencode](https://pair.foomakers.com/docs/integrations/opencode)
- [pi](https://pair.foomakers.com/docs/integrations/pi)
- [Web and Cloud Environments](https://pair.foomakers.com/docs/integrations/web-cloud-environments)
- [Windsurf](https://pair.foomakers.com/docs/integrations/windsurf)

## Migrations

- ["v0.4 → v0.5: Canonical States + Domain Modeling"](https://pair.foomakers.com/docs/migrations/v0.4-to-v0.5)

## Pm tools

- [Azure DevOps](https://pair.foomakers.com/docs/pm-tools/azure-devops)
- [Add a custom PM tool](https://pair.foomakers.com/docs/pm-tools/custom)
- [Filesystem](https://pair.foomakers.com/docs/pm-tools/filesystem)
- [GitHub Projects](https://pair.foomakers.com/docs/pm-tools/github-projects)
- [Linear](https://pair.foomakers.com/docs/pm-tools/linear)

## Process lifecycle

- [The delivery cycle in depth](https://pair.foomakers.com/docs/process-lifecycle/delivery-cycle)
- [Delivery workflow](https://pair.foomakers.com/docs/process-lifecycle/delivery-workflow)
- [Lifecycle modes](https://pair.foomakers.com/docs/process-lifecycle/lifecycle-modes)
- [Phases](https://pair.foomakers.com/docs/process-lifecycle/phases)
- ["Execution: Implement & Review"](https://pair.foomakers.com/docs/process-lifecycle/phases/execution)
- ["Induction: Project Setup"](https://pair.foomakers.com/docs/process-lifecycle/phases/induction)
- ["Iteration: Stories & Tasks"](https://pair.foomakers.com/docs/process-lifecycle/phases/iteration)
- ["Strategic Planning: Epics"](https://pair.foomakers.com/docs/process-lifecycle/phases/strategic-planning)
- [Analysis and refinement workflow](https://pair.foomakers.com/docs/process-lifecycle/refinement-workflow)
- [Skill layers](https://pair.foomakers.com/docs/process-lifecycle/skill-layers)
- [Tag-driven automation](https://pair.foomakers.com/docs/process-lifecycle/tag-driven-automation)

## Reference

- [Adoption settings](https://pair.foomakers.com/docs/reference/adoption-settings)
- [CLI Commands](https://pair.foomakers.com/docs/reference/cli/commands)
- [CLI Help Examples](https://pair.foomakers.com/docs/reference/cli/examples)
- [Install sources](https://pair.foomakers.com/docs/reference/cli/install-sources)
- [update-link](https://pair.foomakers.com/docs/reference/cli/update-link)
- [Configuration](https://pair.foomakers.com/docs/reference/configuration)
- [Coupling Model](https://pair.foomakers.com/docs/reference/coupling-model)
- [Guidelines & How-To Catalog](https://pair.foomakers.com/docs/reference/guidelines-catalog)
- [KB Structure](https://pair.foomakers.com/docs/reference/kb-structure)
- [Claude Code plugin & /pair-assistant](https://pair.foomakers.com/docs/reference/pair-assistant)
- [pair-next Arguments](https://pair.foomakers.com/docs/reference/pair-next)
- [Quality Gates & Configuration](https://pair.foomakers.com/docs/reference/quality-gates-configuration)
- [Quality Model](https://pair.foomakers.com/docs/reference/quality-model)
- [Skill Management](https://pair.foomakers.com/docs/reference/skill-management)
- [Skills Catalog](https://pair.foomakers.com/docs/reference/skills-catalog)
- [CLI Contracts Specification](https://pair.foomakers.com/docs/reference/specs/cli-contracts)
- [KB Source Resolution](https://pair.foomakers.com/docs/reference/specs/kb-source-resolution)
- [Templates catalog](https://pair.foomakers.com/docs/reference/templates-catalog)

## Support

- [FAQ](https://pair.foomakers.com/docs/support/general-faq)
- [Troubleshooting](https://pair.foomakers.com/docs/support/troubleshooting)

## Tutorials

- [Automated development](https://pair.foomakers.com/docs/tutorials/automated-development)
- [Brainstorming](https://pair.foomakers.com/docs/tutorials/brainstorming)
- [Enterprise Adoption](https://pair.foomakers.com/docs/tutorials/enterprise-adoption)
- [Adopting pair on an Existing Project](https://pair.foomakers.com/docs/tutorials/existing-project)
- [Your First Project](https://pair.foomakers.com/docs/tutorials/first-project)
- [Refinement](https://pair.foomakers.com/docs/tutorials/refinement)
- [Release testing](https://pair.foomakers.com/docs/tutorials/release-testing)
- [Share AI artifacts with your team](https://pair.foomakers.com/docs/tutorials/share-ai-artifacts)
- [Team Setup](https://pair.foomakers.com/docs/tutorials/team-setup)