AGENTS.md Assistant

Quick start

• Review README.md, CONTRIBUTING.md, and docs/CI configs to learn the intended workflow.
• Pull exact commands from build scripts (Makefile, package.json, pyproject.toml, justfile).
• Map key directories (source, tests, docs, scripts) and mark generated or vendor paths.
• Capture architecture: key entrypoints, components, and configuration locations.
• Fill unknowns with TODOs and confirm them with the user.

Workflow

1) Inspect the repository
- Read README.md, CONTRIBUTING.md, and /docs for goals and workflows.
- Check build/config files: Makefile, package.json, pyproject.toml, justfile, Dockerfile, CI pipelines.

2) Extract commands
- Record install, dev, lint, format, typecheck, test, and build commands exactly as documented.
- If multiple options exist, capture the preferred default and note alternates.

3) Map structure
- Identify primary code, tests, docs, scripts, and generated/ignored folders.
- Note where key configs live and any build artifacts to avoid editing.

4) Summarize architecture & environment
- Document key components, data flow, and entrypoints.
- Capture required versions, services, env vars, and migration/seed steps.

5) Author AGENTS.md
- Use references/agents_md_template.md as the base.
- Place AGENTS.md at the repo root unless instructed otherwise.
- Flag missing info with TODOs and ask for confirmation.

Reference

• references/agents_md_template.md: base template to fill.