Skip to content

docs: add Claude Code project documentation#899

Open
bonzofenix wants to merge 16 commits intomainfrom
init-claude-code
Open

docs: add Claude Code project documentation#899
bonzofenix wants to merge 16 commits intomainfrom
init-claude-code

Conversation

@bonzofenix
Copy link
Contributor

@bonzofenix bonzofenix commented Jan 22, 2026

Summary

  • Add comprehensive project documentation to guide AI-assisted development with Claude Code
  • Document the app-autoscaler architecture, build commands, and development patterns
  • Include team workflows for PR comment resolution
  • Update .gitignore to exclude Claude Code cache directory

Changes

  • Added CLAUDE.md (267 lines) with detailed project overview:
    • Technology stack: Go 1.24.3, Java 17/Spring Boot 3.5, PostgreSQL
    • Complete build and test commands for all 7 microservices
    • Detailed architecture overview of the distributed autoscaling system
    • Development patterns, database architecture, and testing guidelines
    • Common gotchas and important configuration details
    • Team workflows including PR comment resolution using GitHub CLI
  • Updated .gitignore to exclude .claude/.claude/ cache directory

Context

This documentation enables Claude Code (Anthropic's AI-powered CLI) to better understand the app-autoscaler codebase and provide more accurate assistance. The CLAUDE.md file follows the pattern used in many open-source projects to provide project-specific context to AI tools.

Testing

  • Documentation reviewed for technical accuracy
  • All commands and file paths verified against current codebase structure
  • Build commands tested: make build, make test
  • GitHub CLI workflows validated

🤖 Generated with Claude Code

@bonzofenix bonzofenix changed the title Add initial claude code configs chore: add Claude Code configuration and project documentation Jan 22, 2026
@bonzofenix bonzofenix changed the title chore: add Claude Code configuration and project documentation feat: add Claude Code integration with custom skills Jan 22, 2026
 • Implement new 'simplify' skill to refine code structure without altering functionality
 • Introduce code-simplifier agent for automated code analysis and improvement
 • Ensure adherence to project-specific best practices and coding standards
 • Enable targeted simplification for specific files or components upon request
 - Add smart-pr skill with automated PR title and description generation based on branch diffs
 - Include checks for branch context, existing PRs, and diff analysis
 - Provide structured PR content with summary, changes, and testing checklist
 - Handle error scenarios and output PR details with direct GitHub link
- Streamline language across all three skill files
- Remove verbose phrases and redundant explanations
- Improve formatting consistency
- Make instructions more action-oriented
- Reduce word count by ~20-30% while preserving all information
Use fully-qualified agent type 'code-simplifier:code-simplifier'
instead of 'code-simplifier' to match available agent types.
@bonzofenix bonzofenix self-assigned this Jan 22, 2026
@bonzofenix bonzofenix requested a review from asalan316 January 22, 2026 18:05
bonzofenix and others added 6 commits January 26, 2026 11:38
Allow GitHub API GraphQL calls for PR comment resolution workflow.

Co-Authored-By: Claude <noreply@anthropic.com>
Document team workflow for resolving PR review comments with commit
references using GitHub CLI and GraphQL API.

Co-Authored-By: Claude <noreply@anthropic.com>
Add skill to fetch and display only unresolved comments from GitHub
pull requests using GraphQL API. Complements the PR comment resolution
workflow documented in CLAUDE.md.

Co-Authored-By: Claude <noreply@anthropic.com>
Allow git add and commit commands for commit workflow automation.

Co-Authored-By: Claude <noreply@anthropic.com>
Add .claude/.claude/ to gitignore as it contains local cache/state
that should not be committed to the repository.

Co-Authored-By: Claude <noreply@anthropic.com>
@bonzofenix bonzofenix changed the title feat: add Claude Code integration with custom skills docs: add Claude Code project documentation Feb 2, 2026
@sonarqubecloud
Copy link

sonarqubecloud bot commented Feb 2, 2026

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant