Repo Agent Context Audit

Overview

Assess whether a repository has a small, usable agent context stack: a short top-level instruction file, task-specific skills, and behavior/implementation specs for substantial work. Default to a read-only audit and minimal recommendations; create or edit high-context files only when the user explicitly asks.

If the user asks to generate, split, or apply root/scoped AGENTS.md files, handoff to agentsmd-scaffold. This skill may identify that scaffold as the smallest useful change, but should not duplicate the generation workflow.

Default Standard

Prefer this three-layer shape:

1. AGENTS.md or repo-equivalent: 80-150 lines, top-level routing only.
2. .agents/skills/<task>/SKILL.md: reusable workflows for common fragile tasks.
3. specs/<id>/PRODUCT.md and specs/<id>/TECH.md: checked-in contracts for substantial features.

Do not force this exact layout when a repo already has a coherent equivalent, such as WARP.md, CLAUDE.md, CONTRIBUTING.md, or framework-specific instruction files. Map existing files to the layers first, then fill only the real gaps.