Documentation

The reader version of the strict in-repo docs at /docs. For long-form guides and use-case walk-throughs, see Use cases.

• The AI Project Standard

  This document defines the standard itself: what it is, what it is not, what is mandatory, and what is optional.

• Profiles

  Three adoption profiles share one repository and one version stream. Pick the profile that matches your context.

• Adoption

  How to adopt this standard in a new or existing repository. Three paths, one per profile.

• Getting Started

  Read `README.md` to understand scope and constraints.

• AI Workspace Layer

  Keeping `.ai/` separate from `docs/` and root governance files prevents process state from being mixed with project-facing documentation.

• AI Tools

  This standard officially supports the AI tools below. The rule is the same for all of them: `AGENTS.md` is the source of truth. Tool-specific files are short pointers — they exist because the tool onl

• Practical AI Collaboration

  This guide covers real-world workflows for solo maintainers and small teams working with AI systems such as Claude, Copilot, Codex, Cursor, and similar tools in the same repository.

• Open Source Project Standard

  This project defines a minimum professional baseline for modern repositories.

• Git Workflow

  This project uses a GitHub Flow / trunk-based workflow with `main` as the stable branch.

• Branch Protection Recommendations

  Apply these protection rules to `main`. Start with the minimum and add more as the team grows.

• Security Baseline

  The minimum security posture this standard recommends. Layers on top of [SECURITY.md](../SECURITY.md) which covers vulnerability *reporting*; this document covers vulnerability *prevention*.