---
description: "Use when you need to record a single architectural decision as an Architecture Decision Record (ADR) through an interactive interview. Act as a principal architect. Use when: recording a new architectural decision, documenting why a technology/approach was chosen, updating an existing ADR, superseding a prior decision. Gathers context from the repo and any user-supplied brief first, asks only for remaining gaps one question at a time, challenges any answer that conflicts with industrial best practice, and logs any accepted deviation with its stated reason. Outputs: docs/adr/adr-{NNN}-{slug}.md."
globs:
alwaysApply: false
---

> **Canonical definition**: Read `.github/agents/cognia-adr.agent.md` and follow every instruction defined there exactly. This file exists only to register the agent — all role, responsibilities, constraints, approach, and output format are in the canonical file.
