Création de 9 fichiers neufs pour décharger AGENTS.md (1296 lignes →
~130) en documents lazy-loadables, compatibles avec la limite de
contexte 128k de Mistral Vibe (cf. ARCODANGE migration Phase 1,
Tâche 6 du curriculum).
Sept guides ciblés sous documentation/ :
- HISTORY.md : phases historiques 1-9 du développement
- CLI.md : commandes CLI, server lifecycle, config DLC_*
- API.md : endpoints REST, OpenAPI, Greet v1/v2
- OBSERVABILITY.md : OpenTelemetry + Jaeger, sampler types, test
- TROUBLESHOOTING.md : issues connues + pointeurs vers guides spé
- CODE_EXAMPLES.md : snippets endpoint/logging/context, pointeurs ADR
- ROADMAP.md : potential features, architectural improvements
Deux fichiers racine :
- CHANGELOG.md : user-facing, format Keep a Changelog
- AGENT_CHANGELOG.md : décisions structurantes des agents AI
(référencé par AGENTS.md, n'existait pas)
Le contenu est extrait fidèlement d'AGENTS.md sans réinterprétation.
Phase C (réécriture AGENTS.md court) suit dans le commit suivant.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.5 KiB
1.5 KiB
Roadmap & Future Enhancements
Tracking pending features and architectural improvements. Extracted from the original AGENTS.md (Tâche 6 restructure). Status updated continuously — items move to "Completed Features" section once shipped.
Potential Features
- Database integration
- Authentication / Authorization
- Rate limiting
- Metrics and monitoring
- Docker containerization
- ✅ CI/CD pipeline (ADR-0016, ADR-0017)
- Configuration hot reload
- Circuit breakers
Architectural Improvements
- Request validation middleware
- ✅ OpenAPI / Swagger documentation with embedded spec
- Enhanced OpenTelemetry instrumentation
- Metrics collection and visualization
- Health check improvements
- Configuration validation enhancements
Completed Features
- ✅ Graceful shutdown with readiness endpoint
- ✅ OpenTelemetry integration with Jaeger support
- ✅ Configuration management with Viper
- ✅ Comprehensive logging with Zerolog
- ✅ Build system with binary output
- ✅ Complete documentation with commit conventions
- ✅ Version management with runtime info
How to Propose a New Feature
- Open a Gitea issue describing the use case and acceptance criteria
- If the feature implies an architectural decision, draft an ADR (
adr/<NNNN>-<slug>.md) following the template - Reference the ADR + issue in any PR introducing the feature
- Update this roadmap (move from "Potential" to "Completed" when shipped)