harness-step1-create-agents-md

To generate an AGENTS.md file, this Skill scans your codebase directory structure, dependency files, and existing docs, then automatically produces an 80–120 line agent orientation file along with a complete docs skeleton.

The docs skeleton created during a codebase scan includes ARCHITECTURE.md, CONVENTIONS.md, TECH_DECISIONS.md, QUALITY.md, and an exec-plans directory, providing a comprehensive knowledge-base structure for agent orientation.

Yes, this codebase scanning tool works with monorepos by scanning 2–3 levels of directory structure and dependency files to infer project organization, generating the AGENTS.md and docs skeleton for any project size.

When the codebase scan encounters uninferable details, it flags the unknown or inferential content for human review to ensure the generated AGENTS.md and docs skeleton remain accurate and require manual verification.

The best way to set up project documentation is to scan the repository and generate AGENTS.md plus the docs skeleton, enabling any Claude Code session to orient quickly using the pre-populated knowledge-base files.

No, you do not need existing documentation to generate AGENTS.md and a docs skeleton; the Skill scans dependency files and directory structures to infer organization, though any existing docs are utilized to improve accuracy.