Agent Native Repo Playbook

Overview

Use this playbook to recommend practical improvements for agent-first software development.

Operating model:

• Solo developer sets intent and priorities.
• Agents always write 100% of code and maintain docs.
• Repository structure is optimized for agent legibility and repeatability.

Modes

• Default audit: produce recommendation-first guidance.
• Scorecard audit: when the user asks for score, rubric, readiness, maturity, or benchmark, load references/harness-readiness-rubric.md.
• AGENTS audit: when reviewing root or nested guidance, load references/agents-md-best-practices.md.
• Docs audit: when reviewing docs placement or freshness, load references/docs-structure-and-maintenance.md.
• Source trace: use references/ryan-harness-principles.md; load raw Ryan sources only when exact source lookup is requested.