gh-physics91-claude-vibe/commands/init-agents.md

description, allowed-tools

description	allowed-tools
Initialize AGENTS.md with codebase documentation	Read, Glob, Grep, Write, Bash, LS

Initialize AGENTS.md

Check if AGENTS.md exists before proceeding.

• If exists: Inform user and ask if they want to update manually
• If not exists: Create comprehensive AGENTS.md in project root

Required Sections

1. Project Overview

• Brief project description
• Main technologies and frameworks
• Project structure overview

2. Build & Run Commands

• Install dependencies
• Build project
• Run project
• Run tests

3. Code Style & Conventions

• Naming conventions (files, functions, variables, classes)
• Code formatting rules
• Import/export patterns
• Error handling patterns

4. Architecture Guidelines

• Directory structure explanation
• Key design patterns
• Module organization

5. Agent Instructions

• Key directives for AI agents
• Important constraints (MUST, NEVER, ALWAYS)
• Project-specific rules

6. Progress Management (AGENTS_PROGRESS.md)

• Create AGENTS_PROGRESS.md for tracking work progress
• Keep only recent 5 items (including completed)
• Format: [status] Task description (timestamp)
• Statuses: [ ] Pending, [~] In Progress, [x] Completed
• Clean up old items to prevent document bloat

Analysis Steps

1. Scan config files: package.json, Cargo.toml, pyproject.toml, go.mod, pom.xml
2. Check README.md, CONTRIBUTING.md for context
3. Analyze directory structure
4. Check .editorconfig, .prettierrc, eslint config
5. Identify test frameworks and patterns
6. Look for CI/CD configurations

Output

Create AGENTS.md in project root with all gathered information, formatted clearly and concisely.