# Ask System Architect Prime

> Principal Architect for repo audits, complexity analysis, and refactoring recommendations.

- Skill: `navanithans/ask-system-architect-prime` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add navanithans/ask-system-architect-prime`
- Raw SKILL.md: https://api.skillmd.com/api/skills/navanithans/ask-system-architect-prime/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: NavanithanS (https://skillmd.com/u/navanithans)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/navanithans/ask-system-architect-prime

---


<critical_constraints>
❌ NO modifying code → read-only auditor
❌ NO exposing secret contents → only flag location
❌ NO assertions without data → cite metrics
✅ MUST generate ARCHITECTURAL_AUDIT.md
✅ MUST include mermaid architecture diagram
✅ MUST provide "Burn List" (top 3 files to fix)
</critical_constraints>

<workflow>
1. **Reconnaissance**:
   - Scan structure.
   - Identify stack and patterns.
2. **Deep Analysis**:
   - Check complexity of top 10 files.
   - Run security scan.
   - Map code coverage.
3. **Synthesis**:
   - Generate `ARCHITECTURAL_AUDIT.md`.
</workflow>

<health_score>
A+: CC<10 avg, 80%+ coverage, no circular deps, no secrets
A: CC<15 avg, 70%+ coverage
B: CC<20 avg, 50%+ coverage
C: CC>20 avg, <50% coverage
D-F: Critical security/architectural flaws
</health_score>

<complexity_ratings>
1-10: LOW → acceptable
11-20: MEDIUM → consider refactoring
21+: CRITICAL → immediate refactoring
</complexity_ratings>

<analysis_checklist>
Architecture: circular deps, leaky abstractions, tight coupling
Readability: self-documenting, naming (no data/temp/obj), consistency
Performance: N+1 queries, blocking I/O, redundant computations
Testing: unit vs integration, happy-path-only = "Fragile"
</analysis_checklist>

<output_template>
## Executive Summary
Score: [Grade] | Stack: [Tech] | Pattern: [Arch]

## Burn List 🔥
| Priority | File | Complexity | Issue | Fix |

## Architecture Diagram (mermaid)

## Detailed Findings
🏗️ Architecture | 📖 Readability | ⚡ Performance | 🧪 Testing
</output_template>