# AGENTS.md

## Purpose
- Store Azure marketplace agents with canonical identity and harness-specific variants.

## Patterns
- `agents/azure/<skill-id>-agent/AGENT.md` is the harness-neutral contract.
- `agents/azure/<skill-id>-agent/harnesses/codex.toml` is the Codex native variant.
- `agents/azure/<skill-id>-agent/harnesses/copilot.agent.md` is the Copilot variant.
- `agents/azure/<skill-id>-agent/metadata.json` mirrors agent metadata beside the asset and aligns with `catalog/agents.json`.

## Rules
- Keep skill links pointed at `skills/azure/<skill-id>/SKILL.md`.
- Keep agent catalog IDs suffixed with `-agent` to avoid colliding with skill IDs.
- Keep prompts role-first and token-lean; load skill references only on demand.
- Treat Azure MCP runtime exposure as truth; do not hard-code undocumented namespace assumptions into the agent contract.
- When discussing Azure MCP setup, prefer Microsoft-documented consolidated mode guidance for AI agents, but adapt to the tools actually exposed in the active client.
- Run `npm run validate` after changes.