dirien/stop-building-portals-start-building-conversations/agent-rules

AGENTS.md Generator Skill

Generate and maintain AGENTS.md files following the agents.md convention. AGENTS.md is FOR AGENTS, not humans.

When to Use

• Creating or updating AGENTS.md for new/existing projects
• Standardizing agent documentation across repositories
• Checking if AGENTS.md files are current with recent code changes
• Onboarding AI agents to an unfamiliar codebase

Scripts

See references/scripts-guide.md for full options.

Workflow

1. Detect: detect-project.sh + detect-scopes.sh to identify stacks and subsystems
2. Extract: extract-commands.sh, extract-ci-rules.sh, etc. to gather facts
3. Generate: generate-agents.sh with --style=thin (default) or --verbose
4. Verify: verify-content.sh + verify-commands.sh -- MANDATORY before done

Use --update to preserve human-curated content outside <!-- GENERATED --> markers.

Core Principles

• Structured over Prose -- tables parse faster than paragraphs
• Never Fabricate -- only document what exists; verify every command and path
• Pointer Principle -- point to files, don't duplicate content
• Auto Symlinks -- CLAUDE.md/GEMINI.md symlinks by default (see `ai-tool-compatibility.md`)

References

Templates

Root: assets/root-thin.md (default), root-verbose.md. Scoped: assets/scoped/ -- backend-go.md, backend-php.md, python-modern.md, typo3.md, symfony.md, skill-repo.md, cli.md, frontend-typescript.md, oro.md.

Supported Projects

Go, PHP (Composer/Laravel/Symfony/TYPO3/Oro), TypeScript (React/Next/Vue/Node), Python (pip/poetry/ruff/mypy), Skill repos, Hybrid (multi-stack with auto-scoping).