Florian BRUNIAUX
0630fcd883
feat: add configuration management and MCP secrets workflows ( closes #16204 )
...
Major additions to address critical gaps in Claude Code configuration:
## New Documentation Sections
1. Section 3.2.1 "Version Control & Backup" (guide/ultimate-guide.md:4085)
- Configuration hierarchy: global → project → local
- Git strategy for ~/.claude (symlinks approach)
- Backup strategies: Git remote, cloud sync, cron
- Multi-machine sync workflows
- Disaster recovery procedures
- Documented .claude/settings.local.json (previously undocumented)
2. Section 8.3.1 "MCP Secrets Management" (guide/ultimate-guide.md:8113)
- Three practical approaches: OS Keychain, .env, Secret Vaults
- Secrets rotation workflow
- Pre-commit secret detection
- Verification checklist
- Best practices summary
## New Templates
1. sync-claude-config.sh (examples/scripts/)
- Commands: setup, sync, backup, restore, validate
- .env parsing + envsubst for variable substitution
- Git repo creation with symlinks
- Validation checks (secrets not in Git)
2. pre-commit-secrets.sh (examples/hooks/bash/)
- Detects 10+ secret patterns (OpenAI, GitHub, AWS, etc.)
- Whitelist system for false positives
- Clear error messages with remediation steps
3. settings.local.json.example (examples/config/)
- Machine-specific overrides template
- Example use cases and patterns
## Resource Evaluation
- Added docs/resource-evaluations/ratinaud-config-management-evaluation.md
- Score: 5/5 (CRITICAL)
- Validated via 3 Perplexity searches + technical-writer agent challenge
- Community demand: GitHub #16204 + brianlovin/claude-config
## Updated References
- machine-readable/reference.yaml: 22 new entries
- Configuration management sections
- MCP secrets workflows
- Community resources (Ratinaud, brianlovin, GitHub issue)
## Impact
- Security: Pre-commit hook prevents secret leaks
- Productivity: Multi-machine sync reduces manual reconfig
- Team coordination: Onboarding workflow for ~/.claude setup
- Disaster recovery: Backup/restore strategies documented
Credits:
- Martin Ratinaud (504 sessions, LinkedIn post)
- brianlovin/claude-config (community example)
- GitHub Issue #16204 (community request)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 18:17:42 +01:00
Florian BRUNIAUX
c84c56bfbd
docs: add AI Traceability & Attribution guide
...
Comprehensive documentation on AI code attribution and disclosure:
- New guide: guide/ai-traceability.md (~640 lines)
- LLVM "Human-in-the-Loop" policy (Assisted-by trailer)
- Ghostty mandatory disclosure pattern
- Fedora contributor accountability framework
- git-ai tool documentation
- PromptPwnd security vulnerability
- Four-level disclosure spectrum
- Implementation guides (solo, team, enterprise)
- Templates: examples/config/
- CONTRIBUTING-ai-disclosure.md
- PULL_REQUEST_TEMPLATE-ai.md
- Cross-references added to:
- ultimate-guide.md (after Co-Authored-By section)
- learning-with-ai.md (after Vibe Coding Trap)
- security-hardening.md (See Also)
- guide/README.md (table of contents)
- reference.yaml: 14 new entries for AI traceability topics
Source: Vibe coding needs git blame (Piotr Migdał, Jan 2026)
+ Perplexity research on LLVM, Ghostty, Fedora policies
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-24 20:11:53 +01:00
Florian BRUNIAUX
09ac9d381d
docs: add doobidoo/mcp-memory-service documentation (semantic memory)
...
- Add comprehensive section in ultimate-guide.md (L.6385-6523)
- Document 3 backends: sqlite_vec, cloudflare, hybrid
- List 12 MCP tools with descriptions
- Add environment variables reference
- Include multi-client sync patterns (same machine vs multi-device)
- Add disclaimer: under testing, not yet validated in production
- Update reference.yaml with 8 new entries
- Add to cheatsheet.md and mcp.json template
Complements Serena (key-value) with semantic search capabilities.
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-23 14:25:35 +01:00
Florian BRUNIAUX
846e2e6a1b
docs(mcp): add grepai semantic search and call graph documentation
...
- Add grepai section in ultimate-guide.md (Section 8.3)
- Privacy-first semantic code search using Ollama embeddings
- Call graph analysis: trace callers, callees, dependency graphs
- Combined workflow with Serena for exploration + editing
- Setup instructions and MCP tools reference
- Update decision tree and comparison table to include grepai
- Add grepai config to examples/config/mcp.json
- Document changes in CHANGELOG.md [Unreleased]
Source: https://github.com/yoanbernabeu/grepai
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:56:18 +01:00
Florian BRUNIAUX
b2acc9b115
feat: add Learning Paths, examples, and project governance files
...
### New Content
- Learning Paths section in README (Junior/Senior/Power User/PM tracks)
- examples/ folder with 18 ready-to-use templates:
- 4 agents (code-reviewer, test-writer, security-auditor, refactoring)
- 2 skills (TDD workflow, security checklist)
- 3 commands (commit, review-pr, generate-tests)
- 4 hooks (bash + PowerShell for security, formatting)
- 3 config templates (settings, MCP, gitignore)
- 2 memory templates (project + personal CLAUDE.md)
### Governance
- CHANGELOG.md: Version history (1.0.0 → 1.1.0 → Unreleased)
- CONTRIBUTING.md: Contribution guidelines for community
### Documentation
- llms.txt: Updated structure with new files/folders
This update makes the guide more actionable with concrete templates
and provides clear learning paths for different skill levels.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-10 14:25:22 +01:00
