mcpadvisor: Command for Claude Code

Please analyze and fix the Github issue: $ARGUMENTS.

Follow these steps for comprehensive issue resolution:

PLAN

1. Get issue details:

   gh issue view $ISSUE_NUMBER
   

2. Understand the problem described in the issue:

   • Read the issue description carefully
   • Check any attached screenshots or logs
   • Understand the expected vs actual behavior
   • Identify the scope (bug fix vs feature implementation)

3. Ask clarifying questions if necessary in issue comments

4. Research prior art and context:

   • Search existing documentation in docs/ for related information
   • Search PRs to see if you can find history on this issue:

     gh pr list --search "keyword from issue"
     

   • Search the codebase for relevant files using Grep/Glob tools
   • Check if similar issues have been resolved before

5. Break down the work using TodoWrite tool:

   • Identify all components that need changes
   • Plan implementation steps
   • Consider testing requirements
   • Plan documentation updates

6. Create documentation plan:

   • Determine which docs/ files need updates
   • Plan new documentation if implementing features
   • Consider updating:
     • docs/GETTING_STARTED.md for user-facing features
     • CONTRIBUTING.md for development changes
     • docs/ARCHITECTURE.md for architectural changes
     • docs/TECHNICAL_REFERENCE.md for technical implementations
     • Create issue-specific docs in docs/ with appropriate categorization

PRE-TEST VALIDATION

• Switch to main branch and create new branch for the issue:

  # Ensure you're starting from the latest main branch
  git checkout main
  git pull origin main
  
  # Create and switch to new feature branch
  git checkout -b issue-$ISSUE_NUMBER-brief-description
  

  Important: Always start from main to ensure your changes are based on the latest codebase and avoid merge conflicts.

• Run the full test suite to ensure clean environment:

  pnpm run check          # Lint and format check
  pnpm run test           # Unit tests
  pnpm run test:coverage  # Coverage report
  pnpm run test:e2e       # End-to-end tests (if applicable)