API versioning: breaking/non-breaking changes, deprecation headers, sunset, v2 introduction. Go/Gin, NestJS, Fastify, GraphQL.
The English summary is being prepared. Showing the original description.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
Guía para versionar APIs en backends Educabot (Go + TS) consumidas por web (React+Vite) y mobile (React Native).
| Estrategia | Ejemplo | Veredicto |
|---|---|---|
| URL path | /v1/users | Default Educabot — visible, cacheable, fácil |
| Header | API-Version: 2026-01-15 | Complemento opcional (date-based pinning) |
| Query param | /users?version=2 | Evitar — ensucia URLs, problemas caché |
| Content negotiation | Accept: vnd.educabot.v2+json | Evitar — over-engineering |
Solo MAJOR cambia URL (/v1 → /v2). MINOR/PATCH transparentes.
Non-breaking (no requiere v2): agregar campo opcional request/response, nuevo endpoint, nuevo enum value (si clientes toleran desconocidos), relajar validaciones, required → opcional.
Breaking (requiere v2): remover campo response, cambiar tipo, renombrar campo/endpoint, cambiar status codes, opcional → required, cambiar formato fechas/IDs/paginación, cambiar semántica, endurecer validaciones.
Deprecation: true + Sunset: <date> + Link: <migration-docs> + Warning: 299410 Gone con body apuntando a docs| Contexto | Ventana |
|---|---|
| Web (React) | 6 meses |
| Mobile (RN) | 12 meses + minimum-version forcing |
| API externa | 12+ meses |
| Backend interno | Semanas (coordinando deploys) |
Max 2 majors vivas en paralelo. Nunca 3+.
→ Read references/implementation-by-framework.md for implementation patterns per framework (Go, NestJS, Fastify, OpenAPI, GraphQL, Mobile)
→ Read references/anti-patterns-and-checklist.md for anti-patterns list and v2 introduction checklist
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Plan, design, and implement A/B tests and experiments with statistical rigor. Covers hypothesis frameworks, sample sizing, metrics, and result analysis.
The English summary is being prepared. Showing the original description.
Web/mobile accessibility decision guide: WCAG 2.2 AA, ARIA, keyboard nav, focus management, contrast, testing. Use for: a11y, accessibility, wcag, aria, screen reader, keyboard, contrast.
The English summary is being prepared. Showing the original description.
Generate, iterate, and scale ad creative for paid advertising across Google, Meta, LinkedIn, and X. Covers platform specs, creative frameworks, and quality validation.
The English summary is being prepared. Showing the original description.
Musica interactiva para juegos: layering vertical, re-secuenciacion horizontal, stingers, reglas de transicion con sync points, y mapeo de estados de gameplay a musica. Usar para: musica adaptativa, sistema de musica dinamica, transiciones musicales, combat music.
The English summary is being prepared. Showing the original description.
Design multi-agent systems, create agent architectures, define communication patterns, and build autonomous agent workflows with structured evaluation frameworks.
The English summary is being prepared. Showing the original description.
Inter-agent communication protocol for C-suite agent teams. Defines invocation syntax, loop prevention, isolation rules, response formats, and quality loops.
The English summary is being prepared. Showing the original description.