/personal:dev:initai - Initialize AI Assistant Boilerplate

Purpose

Set up minimal boilerplate files for AI assistants (Claude, Cursor, Gemini) in a non-destructive way, creating only what's missing.

Usage

/personal:dev:initai

Execution

1. Analyze existing structure

   • Check for existing files: CLAUDE.md, GEMINI.md, .claude/, .cursor/, docs/
   • Look for project metadata: package.json, Cargo.toml, pyproject.toml, go.mod, README.md etc
   • Extract project name and type

2. Create AGENTS.md (only if missing)

   • Extract project name from metadata or directory name

   • Detect primary language from file extensions or config files

   • Create minimal AGENTS.md:

     # AI Coding Agent Instructions for [Project Name]
     
     See @docs/ for full documentation.
     
     ## Project Overview
     
     ## Core Rules
     
     ### New Sessions
     
      - Read @docs/tasks.md for task management
      - Review `docs/developer/architecture-guide.md` for essential patterns
      - Consult specialized guides when working on specific features
      - Check git status and project structure
     
     ### Development Practices
     
     **CRITICAL:** Follow these strictly:
     
     1. **Read Before Editing**: Always read files first to understand context
     2. **Follow Established Patterns**: Use patterns from this file and `docs/developer`
     3. **Senior Architect Mindset**
     

3. Check for comprehensive check command

   • If package.json exists, look for scripts matching: check, check:all, verify, validate, ci, precommit, lint:all
   • If found, create .claude/commands/check.md with this structure:
     • Use "---" for frontmatter
     • Set description and allowed-tools
     • Create execution section that runs the discovered command
     • Keep it simple - just run the command and report results

4. Create CLAUDE.md (if missing)

   @AGENTS.md
   

5. Create docs/README.md (only if docs/ exists but README.md doesn't)

   # [Project Name] Documentation
   
   Project documentation goes here.
   

6. Report results

   • List what was created
   • List what was skipped (already existed)
   • Confirm initialization complete

Other Rules & Information

• This command is non-destructive - it never overwrites existing files
• Only creates directories and files that are missing
• Keeps all generated content minimal and focused
• The generated check command (if any) serves as an example for project-specific commands