chore(agent): configure AI agents and tools
Add configuration for BMad, Claude, OpenCode, and other AI agent tools and workflows.
This commit is contained in:
85
.claude/commands/fix-issue.md
Normal file
85
.claude/commands/fix-issue.md
Normal file
@@ -0,0 +1,85 @@
|
||||
# Fix Issue Command
|
||||
|
||||
Identify and resolve code issues
|
||||
|
||||
## Instructions
|
||||
|
||||
Follow this structured approach to analyze and fix issues: **$ARGUMENTS**
|
||||
|
||||
1. **Issue Analysis**
|
||||
- Use `gh issue view $ARGUMENTS` to get complete issue details
|
||||
- Read the issue description, comments, and any attached logs/screenshots
|
||||
- Identify the type of issue (bug, feature request, enhancement, etc.)
|
||||
- Understand the expected vs actual behavior
|
||||
|
||||
2. **Environment Setup**
|
||||
- Ensure you're on the correct branch (usually main/master)
|
||||
- Pull latest changes: `git pull origin main`
|
||||
- Create a new feature branch: `git checkout -b fix/issue-$ARGUMENTS`
|
||||
|
||||
3. **Reproduce the Issue**
|
||||
- Follow the steps to reproduce described in the issue
|
||||
- Set up the development environment if needed
|
||||
- Run the application/tests to confirm the issue exists
|
||||
- Document the current behavior
|
||||
|
||||
4. **Root Cause Analysis**
|
||||
- Search the codebase for relevant files and functions
|
||||
- Use grep/search tools to locate the problematic code
|
||||
- Analyze the code logic and identify the root cause
|
||||
- Check for related issues or similar patterns
|
||||
|
||||
5. **Solution Design**
|
||||
- Design a fix that addresses the root cause, not just symptoms
|
||||
- Consider edge cases and potential side effects
|
||||
- Ensure the solution follows project conventions and patterns
|
||||
- Plan for backward compatibility if needed
|
||||
|
||||
6. **Implementation**
|
||||
- Implement the fix with clean, readable code
|
||||
- Follow the project's coding standards and style
|
||||
- Add appropriate error handling and logging
|
||||
- Keep changes minimal and focused
|
||||
|
||||
7. **Testing Strategy**
|
||||
- Write or update tests to cover the fix
|
||||
- Ensure existing tests still pass
|
||||
- Test edge cases and error conditions
|
||||
- Run the full test suite to check for regressions
|
||||
|
||||
8. **Code Quality Checks**
|
||||
- Run linting and formatting tools
|
||||
- Perform static analysis if available
|
||||
- Check for security implications
|
||||
- Ensure performance isn't negatively impacted
|
||||
|
||||
9. **Documentation Updates**
|
||||
- Update relevant documentation if needed
|
||||
- Add or update code comments for clarity
|
||||
- Update changelog if the project maintains one
|
||||
- Document any breaking changes
|
||||
|
||||
10. **Commit and Push**
|
||||
- Stage the changes: `git add .`
|
||||
- Create a descriptive commit message following project conventions
|
||||
- Example: `fix: resolve issue with user authentication timeout (#$ARGUMENTS)`
|
||||
- Push the branch: `git push origin fix/issue-$ARGUMENTS`
|
||||
|
||||
11. **Create Pull Request**
|
||||
- Use `gh pr create` to create a pull request
|
||||
- Reference the issue in the PR description: "Fixes #$ARGUMENTS"
|
||||
- Provide a clear description of the changes and testing performed
|
||||
- Add appropriate labels and reviewers
|
||||
|
||||
12. **Follow-up**
|
||||
- Monitor the PR for feedback and requested changes
|
||||
- Address any review comments promptly
|
||||
- Update the issue with progress and resolution
|
||||
- Ensure CI/CD checks pass
|
||||
|
||||
13. **Verification**
|
||||
- Once merged, verify the fix in the main branch
|
||||
- Close the issue if not automatically closed
|
||||
- Monitor for any related issues or regressions
|
||||
|
||||
Remember to communicate clearly in both code and comments, and always prioritize maintainable solutions over quick fixes.
|
||||
Reference in New Issue
Block a user