# AGENTS.md (root) **Precedence:** The **closest AGENTS.md** to changed files wins. Root holds global defaults only. ## Project Overview {{PROJECT_DESCRIPTION}} **Tech Stack**: {{LANGUAGE}} {{VERSION}}, {{BUILD_TOOL}}, {{FRAMEWORK}} **Type**: {{PROJECT_TYPE}} ## Global Rules - Keep PRs small (~≤300 net LOC) - Conventional Commits: `type(scope): subject` - Ask before: heavy deps, full e2e, repo rewrites - Never commit secrets or PII {{LANGUAGE_CONVENTIONS}} ## Development Workflow 1. Create feature branch: `git checkout -b feature/description` 2. Make changes with tests 3. Run pre-commit checks (see below) 4. Commit with conventional format 5. Push and create PR 6. Address review feedback 7. Merge when approved ## Pre-commit Checks **Always run before committing:** - Typecheck: {{TYPECHECK_CMD}} - Lint: {{LINT_CMD}} - Format: {{FORMAT_CMD}} - Tests: {{TEST_CMD}} - Build: {{BUILD_CMD}} ## Code Quality Standards {{QUALITY_STANDARDS}} ## Security & Safety - Never commit secrets, credentials, or PII - Validate all user inputs - Use parameterized queries for database access - Keep dependencies updated {{SECURITY_SPECIFIC}} ## Testing Requirements - Write tests for new features - Maintain {{TEST_COVERAGE}}% minimum coverage - Run fast tests locally: {{TEST_FAST_CMD}} - Run full suite in CI: {{TEST_FULL_CMD}} ## Index of Scoped AGENTS.md {{SCOPE_INDEX}} ## When Instructions Conflict Nearest AGENTS.md wins. User prompts override files. {{LANGUAGE_SPECIFIC_CONFLICT_RESOLUTION}} ## Documentation - Architecture: {{ARCHITECTURE_DOC}} - API docs: {{API_DOC}} - Contributing: {{CONTRIBUTING_DOC}}