Florian BRUNIAUX
|
0bdb34b2a4
|
docs: external orchestration frameworks, pr-triage skill, GitHub Actions templates
Added:
- guide/third-party-tools.md: External Orchestration Frameworks section
(Ruflo + Athena Flow) with architectural distinction from multi-instance tools
- examples/skills/pr-triage/: 3-phase PR backlog management skill
(audit, deep review via parallel agents, validated comment posting)
- examples/github-actions/: claude-code-review.yml + .coderabbit.yaml +
prompts/code-review.md — AI-powered PR review GitHub Actions workflow
- docs/resource-evaluations/073-athena-flow-workflow-runtime.md (2/5 Watch)
- docs/resource-evaluations/074-ruflo-multi-agent-orchestration.md (3/5 Pertinent)
Updated:
- examples/README.md + examples/github-actions/README.md: new templates indexed
- machine-readable/reference.yaml: new entries for github-actions + pr-triage
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
2026-03-05 09:47:16 +01:00 |
|
Florian BRUNIAUX
|
9b75b5125e
|
release: v3.27.8 - prompt-based GitHub Actions code review workflow
New examples/github-actions/claude-code-review.yml with externalized prompt,
anti-hallucination protocol, /claude-review on-demand trigger. Templates 116→161.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
2026-02-19 14:23:15 +01:00 |
|
Florian BRUNIAUX
|
9170095320
|
docs(examples): add YAML frontmatter to 7 README files
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
2026-02-15 19:20:57 +01:00 |
|
Florian BRUNIAUX
|
2f84c2a769
|
feat(guide): comprehensive improvements - troubleshooting, CLI ref, pitfalls, DeepSeek
MAJOR ENHANCEMENTS:
## README Updates
- Add pedagogical approach section emphasizing learning journey over reference manual
- Reference zebbern/claude-code-guide as key inspiration for troubleshooting
- Clarify guide philosophy: mentor for mastering Claude Code
## Main Guide (english-ultimate-claude-code-guide.md)
### New Sections Added:
1. **Status Overview Table** - Section completeness at a glance
2. **Section 10.3: CLI Flags Complete Reference**
- 19 flags with descriptions and examples
- Common flag combinations
- Safety guidelines table
3. **Section 10.4: Enhanced MCP Troubleshooting**
- 3 common errors with solutions (tool validation, server not found, Windows paths)
- MCP debugging techniques (logs, manual testing)
- One-shot health check scripts (PowerShell + Bash)
- Full clean reinstall procedures (Windows + macOS/Linux)
4. **Section 9.11: Common Pitfalls & Best Practices**
- Security pitfalls (Do/Don't + working hook example)
- Performance pitfalls (context strategy, thinking levels)
- Workflow pitfalls (prompt format template)
- Collaboration pitfalls (team coordination)
- Cost optimization pitfalls (model selection table)
- Learning pitfalls (progressive adoption checklist)
5. **Section 11: DeepSeek Integration**
- Complete setup (Windows/macOS/Linux)
- Cost comparison (98% savings)
- Use cases and limitations
- Provider switching strategies
6. **Appendix A: File Locations Reference**
- Platform-specific paths (Windows/macOS/Linux)
- Quick access commands
- Environment variables reference
- Recommended .gitignore
## Cheatsheet (cheatsheet-en.md)
- Add CLI Flags Quick Reference table
- Add Common Issues Quick Fix table
- Add Health Check one-liners
- Add Cost Optimization section
- Update to version 2.0
## GitHub Actions (examples/github-actions/)
- **claude-pr-auto-review.yml**: Comprehensive review workflow
- 8 focus areas (correctness, security, performance, etc.)
- Priority-based feedback (🔴🟡🟢💡)
- Smart file filtering
- Draft PR detection
- Error handling + fallback comments
- **README.md**: Update workflow #1 documentation with new features
## Documentation Quality
- All examples are practical and tested
- Platform-specific instructions throughout
- Do/Don't format for quick scanning
- Cross-references to zebbern guide where appropriate
- Maintains pedagogical tone established in original guide
IMPACT: Guide now provides exceptional troubleshooting resources, complete CLI reference, real-world integration patterns, and cost-effective alternatives while maintaining focus on learning journey.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
2026-01-10 15:47:26 +01:00 |
|
Florian BRUNIAUX
|
87994bb797
|
feat(guide): add thinking keywords, GitHub Actions examples, and improvement recommendations
Documentation enhancements:
- Add inline thinking keywords section (think, think hard, ultrathink) with usage examples
- Create examples/github-actions/ directory with 3 ready-to-use workflows:
* Auto PR review with inline comments
* Security review on every PR
* Issue triage with label suggestions
- Add comprehensive IMPROVEMENT_RECOMMENDATIONS.md with prioritized action items
Improvements based on zebbern/claude-code-guide analysis:
- Enhanced troubleshooting guidance
- Format enhancements (badges, collapsible tables, C-style comments)
- Security/performance/workflow pitfalls sections
- DeepSeek integration documentation
- One-shot health check scripts
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
2026-01-10 15:26:18 +01:00 |
|