Initialize - Create AGENTS.md
Action
Immediately scan the codebase using the files listed below and create or update AGENTS.md. Do not wait for further instructions. Start scanning now.
Target File
AGENTS.md only. Do NOT create or modify CLAUDE.md.
Required Header
# AGENTS.md
This file provides guidance to AI coding agents (Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, Devin, Windsurf, Amp, Jules, Aider, VS Code, Zed, goose, RooCode, etc.) when working with code in this repository.
Files to Scan
| Priority |
Files |
Purpose |
| High |
README.md, PROJECT.md, CONTRIBUTING.md |
Project overview |
| High |
package.json, Makefile, Cargo.toml, go.mod, pyproject.toml |
Build commands |
| High |
CLAUDE.md, GEMINI.md |
Existing AI rules to merge |
| High |
.cursor/rules/, .cursorrules |
Cursor AI rules |
| High |
.github/copilot-instructions.md |
Copilot instructions |
| High |
.github/workflows/ |
CI/CD build/test commands |
| Medium |
docker-compose.yml, Dockerfile |
Container setup |
| Medium |
.env.example, config/ |
Configuration |
| Medium |
src/, lib/, app/ structure |
Architecture |
| Medium |
.gemini/settings.json |
Gemini CLI config |
| Low |
Linter/formatter configs |
Code style |
| Low |
.aider.conf.yml |
Aider config |
What to Include
- Build/Run Commands (install, build, run, test)
- Single Test Execution (how to run individual tests)
- Architecture Overview (high-level structure)
- Key Patterns (codebase-specific conventions)
- Environment setup requirements (if present)
- Database/migration commands (if present)
- Monorepo workspace structure (if present)
- Security considerations (if present)
- PR/commit message guidelines (if present)
- Deployment steps (if present)
What to Exclude
- Generic development practices
- Obvious instructions
- Complete file/directory listings
- Information easily found in config files
- Made-up sections like "Tips for Development" or "Support and Documentation"
Behavior
- If AGENTS.md does not exist: create it directly
- If AGENTS.md already exists: analyze current content and update it directly
- If CLAUDE.md or other AI config files exist, incorporate their important parts
- If a monorepo is detected, suggest creating nested AGENTS.md files for each subproject
- You can ONLY edit or create AGENTS.md -- never touch CLAUDE.md
Output Guidelines
- Keep under 500 lines
- Focused, actionable, scoped rules
- Write like clear internal documentation
- Use tables for command references
- No fabricated information
- Commands verified against project structure
- IMPORTANT: Always write in English only, regardless of conversation language
Source: KilimcininKorOglu/cli-tweaks — distributed by TomeVault.
1---2name: kilimcininkoroglu-cli-tweaks-initialize3description: Kilimcininkoroglu Cli Tweaks Initialize4---56# Initialize - Create AGENTS.md78## Action910Immediately scan the codebase using the files listed below and create or update AGENTS.md. Do not wait for further instructions. Start scanning now.1112## Target File1314AGENTS.md only. Do NOT create or modify CLAUDE.md.1516## Required Header1718```19# AGENTS.md20This file provides guidance to AI coding agents (Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, Devin, Windsurf, Amp, Jules, Aider, VS Code, Zed, goose, RooCode, etc.) when working with code in this repository.21```2223## Files to Scan2425| Priority | Files | Purpose |26|----------|----------------------------------------------------------------------|----------------------------|27| High | `README.md`, `PROJECT.md`, `CONTRIBUTING.md` | Project overview |28| High | `package.json`, `Makefile`, `Cargo.toml`, `go.mod`, `pyproject.toml` | Build commands |29| High | `CLAUDE.md`, `GEMINI.md` | Existing AI rules to merge |30| High | `.cursor/rules/`, `.cursorrules` | Cursor AI rules |31| High | `.github/copilot-instructions.md` | Copilot instructions |32| High | `.github/workflows/` | CI/CD build/test commands |33| Medium | `docker-compose.yml`, `Dockerfile` | Container setup |34| Medium | `.env.example`, `config/` | Configuration |35| Medium | `src/`, `lib/`, `app/` structure | Architecture |36| Medium | `.gemini/settings.json` | Gemini CLI config |37| Low | Linter/formatter configs | Code style |38| Low | `.aider.conf.yml` | Aider config |3940## What to Include4142- Build/Run Commands (install, build, run, test)43- Single Test Execution (how to run individual tests)44- Architecture Overview (high-level structure)45- Key Patterns (codebase-specific conventions)46- Environment setup requirements (if present)47- Database/migration commands (if present)48- Monorepo workspace structure (if present)49- Security considerations (if present)50- PR/commit message guidelines (if present)51- Deployment steps (if present)5253## What to Exclude5455- Generic development practices56- Obvious instructions57- Complete file/directory listings58- Information easily found in config files59- Made-up sections like "Tips for Development" or "Support and Documentation"6061## Behavior6263- If AGENTS.md does not exist: create it directly64- If AGENTS.md already exists: analyze current content and update it directly65- If CLAUDE.md or other AI config files exist, incorporate their important parts66- If a monorepo is detected, suggest creating nested AGENTS.md files for each subproject67- You can ONLY edit or create AGENTS.md -- never touch CLAUDE.md6869## Output Guidelines7071- Keep under 500 lines72- Focused, actionable, scoped rules73- Write like clear internal documentation74- Use tables for command references75- No fabricated information76- Commands verified against project structure77- IMPORTANT: Always write in English only, regardless of conversation language7879---80> Source: [KilimcininKorOglu/cli-tweaks](https://github.com/KilimcininKorOglu/cli-tweaks) — distributed by [TomeVault](https://tomevault.io).81<!-- tomevault:4.0:skill_md:2026-06-16 -->