aio-architect-referencelisted

# Software Architecture Reference An encyclopedia of 137 in-depth architecture articles. Each article is 3,000-5,000 words covering the problem, core concept, real-world practices (Google, AWS, Microsoft), implementation guidance, trade-offs, common mistakes, and connections to other patterns. ## Scripts ```bash SA="${CLAUDE_PLUGIN_ROOT}/scripts" ``` ## Commands ### Search — Find patterns by meaning ```bash npx tsx "$SA/search-patterns.ts" "<natural language query>" --top 5 --json ``` Examples: - `"how to handle database failures gracefully"` - `"scaling read-heavy workloads"` - `"breaking apart a legacy system"` - `"ensuring data consistency across services"` The search uses semantic embeddings — it understands meaning, not just keywords. ### List — Browse the catalog ```bash bash "$SA/list-patterns.sh" # All 137 patterns by volume bash "$SA/list-patterns.sh" --volume 4 # Volume 4: Resilience bash "$SA/list-patterns.sh" --search "event" # Keyword filter bash "$SA/list-patterns.sh" --count # Quick count ``` ### Read — Full article After finding a pattern via search or list, read the full article: ``` ${CLAUDE_PLUGIN_ROOT}/volume-NN-name/pattern-name.md ``` **Always read the full article.** These are not summaries — they are comprehensive guides with real-world examples, implementation details, and trade-off analysis. ### Compare — Side by side ```bash bash "$SA/compare-patterns.sh" "circuit-breaker" "bulkhead" ba