laravel:api-surface-evolution
SkillDev toolsEvolve APIs safely using versioned DTOs/transformers, deprecations, and compatibility tests
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the laravel:api-surface-evolution skill
What this skill tells your AI
The instructions your AI receives, as published by jpcaparas/superpowers-laravel in skills/api-surface-evolution/SKILL.md and read by ahel’s review.
Design for change without breaking clients.
Versioning Strategy
- Choose explicit versioning (URI
/v1/...or header negotiation) - Default to additive changes; never break a released contract
DTOs & Transformers
- Define versioned DTOs; map from models/services via transformers
- Keep controller thin—validate → transform → respond
Deprecations
- Mark fields as deprecated in docs and responses (e.g., headers)
- Provide sunset timelines; add metrics to see remaining usage
Testing
- Contract tests per version (request/response shapes)
- Backward compatibility tests for commonly used flows
Signals
- GitHub stars
- 153
- Forks
- 2
- Last commit
- Jul 2026
Advanced
- Catalog kind
- skill
- Gateway key
laravel-api-surface-evolution- Source
- github.com/jpcaparas/superpowers-laravel