📝 docs: add agent configuration ADR and compact CHANGELOG

- Add adr/0010-agent-configuration-relationship.md with complete agent config
- Update CHANGELOG.md to be compact and iterative (last 5 entries only)
- Fix documentation links to reference valid Mistral Vibe resources
- Document workflow constraints and decision making process

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
This commit is contained in:
2026-04-04 20:03:30 +02:00
parent e9f3b63406
commit d29d7a221a
2 changed files with 250 additions and 0 deletions

100
CHANGELOG.md Normal file
View File

@@ -0,0 +1,100 @@
# DanceLessonsCoach Agent Improvement Log
This file tracks the agent's contributions and decisions. Kept compact and iterative.
## Current Focus (2026-04-04)
### Active Configuration
- **Agent**: DanceLessonsCoachProgrammer
- **Location**: `/Users/gabrielradureau/Work/Vibe/.mistral/dancelessonscoachprogrammer-agent.toml`
- **Status**: Fully operational with workflow constraints
### Recent Decisions
- ✅ Use existing `cli` system prompt with custom overrides
- ✅ Enable web tools for research (web_search, web_fetch)
- ✅ Restrict git commands (no add/commit/push/merge/rebase)
- ✅ Require ADR documentation for all architectural decisions
## Workflow Constraints
### Always Ask Before
- Adding libraries/frameworks
- Major architectural changes
- Breaking changes
### Always Check
- `adr/` folder for existing decisions
- Roadmap alignment
- BDD scenario coverage
### Always Document
- New ADRs in `adr/` folder
- Feature changes in CHANGELOG.md
- Test scenarios in `features/`
## Agent Session Guide
### Starting a Session
```bash
cd /Users/gabrielradureau/Work/Vibe/DanceLessonsCoach
vibe start --agent dancelessonscoachprogrammer
```
### Example Workflow
```
🤖 "Need to add library X. Approve?"
👤 "Yes, document in ADR first"
🤖 Creates adr/00XX-library-x.md
🤖 Implements with BDD tests
🤖 Updates CHANGELOG.md
```
## Compact History (Last 5 Entries)
### 2026-04-04
- Configured agent with workflow constraints
- Enabled web research tools
- Restricted git operations
- Documented in adr/0010-agent-configuration-relationship.md
### 2026-04-04
- Added bdd_testing skill (updated to match validated implementation)
- Added commit_message skill (Gitmoji validation)
- Added skill_creator skill (framework)
### 2026-04-04
- Implemented BDD testing with Godog
- Created features/greet.feature and features/health.feature
- Added pkg/bdd/ with test server and steps
### 2026-04-04
- Added comprehensive ADR documentation
- Created adr/0001-0009 covering all major decisions
- Enhanced AGENTS.md with complete project documentation
### 2026-04-04
- Established project structure
- Implemented core Greet service
- Added Chi router and Zerolog logging
- Created CLI and web server interfaces
## Maintenance
**Compaction Rule**: Keep only last 5 entries. Older history archived in git.
**Archiving**: When compaction needed:
```bash
git log --oneline -- CHANGELOG.md > CHANGELOG_archive.md
echo "## Compact History (Last 5 Entries)" > CHANGELOG.md
# Add last 5 entries from git history
git log -5 --pretty=format:"### %ad%n- %s%n" -- CHANGELOG.md >> CHANGELOG.md
```
## References
- **Agent Config**: `/Users/gabrielradureau/Work/Vibe/.mistral/dancelessonscoachprogrammer-agent.toml`
- **ADR Pattern**: `/adr/README.md`
- **BDD Guide**: `/pkg/bdd/README.md`
- **Project Docs**: `/AGENTS.md`
- **Mistral Vibe Docs**: https://docs.mistral.ai/mistral-vibe/introduction
- **Mistral Vibe GitHub**: https://github.com/mistralai/mistral-vibe