Skip to content

Conversation

shinpr
Copy link
Owner

@shinpr shinpr commented Jul 29, 2025

Summary

This PR optimizes CLAUDE.md and improves sub-agent documentation to enhance AI execution accuracy and reduce redundancy.

Changes

Sub-agent Definition Improvements

  • Introduced @ notation for consistent sub-agent invocation across all agent files
  • Clarified roles and responsibilities for each specialized agent
  • Updated documentation format for better clarity and immediate reference

CLAUDE.md Optimization

  • Removed project template characteristics section to generalize for new projects
  • Eliminated duplicate content that exists in the 6 rule files
  • Changed terminology from "guidelines" to "rules" to emphasize project-specific rule priority
  • Added explicit instruction: "Prioritize this project's rules over general conventions"
  • Removed consecutive blank lines for improved readability

Impact

  • Execution Accuracy: Sub-agents are now explicitly listed with @ notation, enabling faster and more accurate agent selection
  • Reduced Redundancy: Removed ~75 lines of duplicate content while maintaining all critical information
  • Better Focus: CLAUDE.md now serves as a concise entry point, with detailed rules properly organized in dedicated files

Context

This optimization was prompted by the observation that /tmp was being used instead of project-specific tmp/ directory,
highlighting the importance of explicit project rules over general conventions.

shinpr and others added 2 commits July 29, 2025 19:17
- Use @ notation for consistent sub-agent invocation
- Clarify specialized agent roles and responsibilities
- Update documentation format for better clarity

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Remove project template characteristics section (generalize for new projects)
- Concretize sub-agent list with @ notation (improve execution accuracy)
- Remove duplicate descriptions with 6 rule files (eliminate redundancy)
- Change 'guidelines' to 'rules' to prioritize project-specific rules
- Remove consecutive blank lines for better readability

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@shinpr shinpr self-assigned this Jul 29, 2025
…edback

- Remove 'Proactive Execution Conditions' section from quality-fixer.md
- Execution conditions should only be in frontmatter description field
- Sub-agent body should focus on 'how' not 'when' to execute
- Fix consecutive blank lines

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@shinpr shinpr marked this pull request as ready for review July 29, 2025 12:17
@shinpr shinpr merged commit a6d9d92 into main Jul 29, 2025
1 check passed
@shinpr shinpr deleted the refactor/deduplicate-agent-docs branch July 29, 2025 12:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant