jimeh/.vscode.d
1
0
Fork 0
mirror of https://github.com/jimeh/.vscode.d.git synced 2026-02-19 11:26:39 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
Files
dadc1948123d0cc253cdef5400c3f82d6ddba529
.vscode.d/claude/commands/refactor-agents.md.md
Jim Myhrberg daeda663a4 feat(claude): add AGENTS.md commands and refactor symlink handling 
Add two new Claude Code slash commands:
- generate-agents.md.md: Generate hierarchical AGENTS.md structures
- refactor-agents.md.md: Refactor existing AGENTS.md files

Changes to siren script:
- Make Claude symlinks conditional on CLI installation
- Extract _add_command_symlinks() for reusable command symlinking
- Extract _cleanup_stale_commands() for generic stale link cleanup
- Add plan mode instructions to CLAUDE.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 01:17:30 +00:00

1.2 KiB
Raw Blame History

source
source
https://www.aihero.dev/a-complete-guide-to-agents-md

Task: Refactor my AGENTS.md

I want you to refactor my AGENTS.md file to follow progressive disclosure principles. If there is no AGENTS.md file, look for a CLAUDE.md file instead.

Follow these steps:

  1. Find contradictions: Identify any instructions that conflict with each other. For each contradiction, ask me which version I want to keep.

  2. Identify the essentials: Extract only what belongs in the root AGENTS.md:

    • One-sentence project description
    • Package manager (if not npm)
    • Non-standard build/typecheck commands
    • Anything truly relevant to every single task

  3. Group the rest: Organize remaining instructions into logical categories (e.g., TypeScript conventions, testing patterns, API design, Git workflow). For each group, create a separate markdown file.

  4. Create the file structure: Output:

    • A minimal root AGENTS.md with markdown links to the separate files
    • Each separate file with its relevant instructions
    • A suggested docs/ folder structure

  5. Flag for deletion: Identify any instructions that are:

    • Redundant (the agent already knows this)
    • Too vague to be actionable
    • Overly obvious (like "write clean code")