Agent skill · duc01226
architecture-scalability-review
[Architecture] Use when grading project architecture and scalability quality for greenfield init or brownfield audit: build/CI scalability, distributed-monolith risk, module isolation, dependency discipline, loose coupling, horizontal scaling, DRY, abstraction, clean architecture, observability, and delivery.
What it needs
About 7k tokens when loaded.
What this skill does
Quick Summary Goal: Grade a project or planned architecture against the full architecture + scalability quality scorecard, routing deep checks to the existing owner skills instead of duplicating them — so the project earns an evidence-backed /20 verdict (STRONG / NEEDS WORK / HIGH RISK) before scale or delivery hardens the decisions. Summary: This skill is the scorecard OWNER, not the deep owner — it scores 10 areas 0-2 (/20), then routes sibling-owned depth (architecture-design/review, domain-analysis, performance-review, production-readiness-review, security-review, linter-setup, scaffold) via the Ownership Matrix; NEVER expand into a sibling's checklist. Scoring is evidence-gated — file:line/command/artifact proof or explicit N/A - reason, else 0; then 7 pass/fail gates (G1-G7) overlay the score without changing the /20 math. Before emitting, self-audit every grade against the 11 thinking red flags (architecture-knowledge.md §20.3) — a deduction for unevidenced scale, a tool named before the requirement, or a recommendation whose sacrifice you cannot state is re-derived or dropped, NEVER reworded. A — VERIFY row or section banner in architecture-knowledge.md §3/§8/§9/§10 is UNVERIFIED — it can never be the sole basis for a deduction; confirm against the named source or the project's own docs. Two conditional advisory gates ride along — Technique Applicability + Scenario Stress — emitting guidance ONLY; NEVER mutate the /20 score, verdict band, or gate pass/fail. Runs in mode=init (planned greenfield architecture) or mode=audit (existing brownfield source/config/CI/ADR evidence). Workflow (run in order): 1. Resolve mode=init or mode=audit + target scope. 2. Load project context and evidence. 3. Read references/scorecard.md. 4. Score all 10 areas 0-2 with evidence. 5. Run pass/fail gates (G1-G7). 6. Emit the architecture scalability review report under plans/reports/. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills duc01226/architecture-scalability-review--97de5a