Agent Entrypoint Design

Overview

Create a small, stable entrypoint that tells agents where truth lives, what rules apply, and which checks gate changes.

The entrypoint should be navigation plus hard rules, not a long project encyclopedia. For shared harness terms, see ../../references/harness-patterns.md; when entrypoint files are absent, use references/build-when-missing.md. For mirror casing and drift rules, see references/mirror-policy.md.

When To Use

• The user wants to create or refactor AGENTS.md, CLAUDE.md, GEMINI.md, .cursorrules, or GitHub instructions.
• Multiple agent instruction files duplicate content, drift, or contradict each other.
• A new project needs to define what an agent reads first, what it can change, and what it must run afterward.

Inputs Needed

• Repository root and main app/module boundaries.
• Existing agent instruction files and docs entrypoints.
• Whether mirrors, symlinks, generation scripts, or CI drift checks are expected.