Agent skill · duc01226
workflow-architecture-audit
[Workflow] Use when activating the Architecture Audit workflow to review the whole project's architecture, run an architecture health check, or check production readiness/scalability in one pass — read-only, produces one consolidated Architecture Health Report.
What it needs
About 11k tokens when loaded.
What this skill does
Quick Summary Goal: [Workflow] Audit the WHOLE project's architecture, scalability, and production readiness in ONE read-only pass and synthesize a single consolidated Architecture Health Report — three sub-scores and one combined verdict. Findings only; every validated fix routes to a FOLLOW-UP /plan or feature workflow. Summary: READ-ONLY audit — produces findings + ONE consolidated Architecture Health Report (3 sub-scores + 1 combined verdict); NEVER applies fixes: every validated fix routes to a FOLLOW-UP /plan or feature workflow. Core engine architecture-review-full runs INLINE (it owns the parallel fan-out + all-return barrier); this workflow declares NO workflow-level parallel groups. FINAL /why-review gate (step 3) = the machine-visible guarantee no audit finding ships unvalidated — every PRIOR step routes its output into it; docs-update runs AFTER the gate and self-validates its own doc diff. Main steps in order: 1 Scout scope → 2 Architecture-Review-Full (fan out 3 non-overlapping reviewers → progressive dedup synthesis → per-face /why-review fix → Finalize verdict) → 3 Why-Review FINAL gate → 4 Docs-Update → 5 Workflow-End → 6 Watzup. Workflow: 1. Scout — locate the modules, boundaries, and hotspots that scope the audit (whole project / current diff / specific path). → On completion, hand its scope map forward to the final /why-review (step 3) so the audit scope itself is validated (nothing in-scope missed, nothing out-of-scope pulled in). 2. Architecture-Review-Full — the core step: runs INLINE (it spawns sub-agents), fans out three non-overlapping reviewers behind an all-return barrier, then PROGRESSIVELY synthesizes each face into ONE report file (status IN PROGRESS → VALIDATING → FINISHED): dedup, a fix-report-per-review /why-review gate that walks each of the three faces, and a Finalize step that locks the combined verdict. → On completion, hand the FINISHED consolidated report forward to the final /why-review (step 3) for report-level validation. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills duc01226/workflow-architecture-audit--2ea9d2