architecture-best-practices
Installation
SKILL.md
Surface what the community and real-world experience says about how technologies play together. This is the reference layer that maps concrete best practices to the 15-domain Tech Stack Taxonomy and feeds into the Stack Compatibility Oracle.
When to Use
- Evaluating a technology choice before committing to it
- Diagnosing why a stack combination is causing problems
- Feeding the Stack Compatibility Oracle with grounded knowledge
- Reviewing architecture decisions during design phases
- Answering "what could go wrong" before it goes wrong
Query Interface
This skill responds to four query modes:
- Domain query — "What are best practices for Data Storage?" returns all practices for that domain
- Combination query — "Best practices for Next.js + Supabase + Vercel?" returns relevant practices across all domains for that stack
- Problem query — "My API is slow under load" returns relevant practices from Performance, API, Infrastructure, Data Storage domains
- Comparison query — "PostgreSQL vs DynamoDB for this use case?" returns decision criteria with trade-offs