ADR-009: AI Agent and Plugin Policy

Publishable summary of this architecture decision.

Status: Accepted

Context

AI agents and plugins generate local state (runtime, caches, logs, sessions, skills) that can pollute repositories and cause conflicts between developers.

Decision

Local AI agent state must not be versioned. Only shared configurations with explicit project approval enter the repository. Per-family .gitignore templates must include patterns for agent directories.

Tools required to operate a project must be explicitly documented in the repository.

Consequences

Repositories stay free of ephemeral state. Each developer maintains their local environment without conflicts. Gitignore templates ensure consistency across repos.