ai-assisted-coding-governance AGENTS.md

AGENTS.md

Version: 1.32 · Last reviewed: 2026-09-01 · Active client: none (internal repository)

Guidance for AI agents working in this repository — the source repo for the AI-assisted coding governance package. This repo applies its own rules to itself.

⚠️ Mandatory rules

Before any task, read and follow core-rules.md — the non-negotiable base that applies to every task (secrets, data, correctness, licensing, provenance, safe agentic actions, compliance, stop-and-ask, client overrides). Then read the module for your task: writing-rules.md before producing or editing documents and content — including documentation about code, such as READMEs, API references, and runbooks (factual grounding, citations, confidentiality, voice fidelity, accessible documents, verified documentation) — the module that applies to nearly everything here, since this repository is Markdown — and coding-rules.md before writing, editing, or running code (dependencies, security, testing, accessibility), which covers the PowerShell scripts in scripts/. If anything below conflicts with these, the stricter rule wins. Load them in one pass before you start reading this repository's code or content — not after you have picked an approach. For a non-trivial task that means core-rules.md, the task module above, the active client's profile (below — none in this repo), and the matching craft companion — writing-patterns.md for content, coding-patterns.md for code; scale that set to the blast radius the way core-rules.md's own checklist does — a typo doesn't earn four files. A rule reached after the work is shaped is too late to shape it. Load means open the file with your file-reading tool — a link you have not opened has not loaded.

Work the way agent-workflow.md describes (work loop, ask-vs-proceed-vs-object boundary, verification, structured hand-off, bounded iteration and adversarial self-review, economy of effort, subagent delegation). Read writing-patterns.md before writing or editing a non-trivial document — which is most work here — and coding-patterns.md before writing or editing non-trivial code; apply their quality patterns. Where craft meets safety, safety and correctness win.