Name		Name	Last commit message	Last commit date
parent directory ..
README.adoc		README.adoc
coverage.a2ml		coverage.a2ml
debt.a2ml		debt.a2ml
methodology.a2ml		methodology.a2ml

README.adoc

Agent Instructions

Methodology-aware configuration for AI agents. Read by any AI agent (Claude, Gemini, Copilot, etc.) at session start.

Table of Contents

Files

File	Purpose
`methodology.a2ml`	Default mode, invariants, ring ceiling, priority weights, convergent budget
`coverage.a2ml`	Session coverage tracking — what was visited, what was skipped, what has MUSTs
`debt.a2ml`	Meander debt — things found but not fixed, carried between sessions

How Agents Use These

Read methodology.a2ml at session start — know mode, invariants, ceiling
Read coverage.a2ml — know what was visited last time, what was skipped
Read debt.a2ml — know what’s outstanding from previous sessions
At session end, update coverage.a2ml and debt.a2ml

Relationship to Other Files

AGENTIC.a2ml says WHAT agents can do (permissions, gating)
agent_instructions/ says HOW agents should work (methodology)
bot_directives/ says what the gitbot-fleet does (fleet-specific)
CLAUDE.md says how Claude specifically should work (Claude-specific)

Reference

ADR-002 in standards/agentic-a2ml/docs/ADR-002-methodology-layer.adoc