hoangnguyen0403/specialist-architecture-guard
skills/specialists/specialist-architecture-guard/SKILL.md
Audits PR diffs for architecture boundary violations, design simplicity, dependency drift, and established-pattern mismatches. Use during code review when architecture, layering, or framework conventions may be affected.
$ install --global
skillsauthnpx skillsauth add hoangnguyen0403/agent-skills-standard specialist-architecture-guardInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 12, 2026, 2:42 AM187.4s2 files scanned
SKILL.md
- name:
- specialist-architecture-guard
- description:
- Audits PR diffs for architecture boundary violations, design simplicity, dependency drift, and established-pattern mismatches. Use during code review when architecture, layering, or framework conventions may be affected.
Specialist: Architecture Guard
Priority: P1 (HIGH)
Role
Review code diffs for architecture and design violations only. Skip security, tests, and style unless they affect module boundaries.
Budget
- Tool cap: <= 10 calls.
- File reads: only when diff or supplied context cannot prove finding.
- No sub-agents.
- If no diff or repo context is available, return
BLOCKEDinstead of guessing architecture.
Checklist
- Detect stack and loaded standards from caller context.
- Check layer boundaries: domain not import transport/repository, service not import UI/transport, modules not cross forbidden ownership.
- Check design simplicity: pass-through parameters through 3+ layers, one-implementation interfaces, strategy/factory with one real variant, 4+ layers for one behavior.
- Check dependency drift: new package, framework pattern, config key, or external service lacks justification.
- Check established pattern before flagging: if comparable local code uses same approach, downgrade to Suggestion and cite reference.
Output
### Architecture Review Findings
**Tech Stack:** [stack]
**Layers Touched:** [layers]
#### Violations
- [Severity] [file:line] - [issue + fix]
#### Design Simplicity
- [Severity] [file:line] - [issue + fix]
#### What Looks Good
- [observation]
Severity: Blocker, Major, Minor, Suggestion.
Anti-Patterns
- No hypothetical abstractions without 3+ real cases.
- No broken code snippets.
- No duplicate query when structural context already answers.
Related Skills
hoangnguyen0403/common-operator-profile
testing
VerifiedTrustedCommunity
Infer the requesting operator's technical fluency from message content (never ask directly) and adapt register — business, hybrid, or technical — across SDLC workflow output. Use when starting sdlc, brainstorm-feature, plan-feature, verify-work, publish-notes, or session-report, or whenever a request's phrasing signals a non-technical or cross-stack operator.
524SKILL.mdUpdated Jul 12, 2026
hoangnguyen0403/database-transactions
documentation
VerifiedTrustedCommunity
Define transaction boundaries, locking, and consistency guarantees for multi-step writes. Use when designing atomic operations, retries, idempotency, or concurrent write behavior.
524SKILL.mdUpdated Jun 19, 2026
hoangnguyen0403/database-schema-design
development
VerifiedTrustedCommunity
Design relational or document schemas from access patterns, cardinality, and lifecycle. Use when modeling entities, choosing embed vs normalize, or shaping schema boundaries before implementation.
524SKILL.mdUpdated Jun 19, 2026
hoangnguyen0403/database-query-performance
data-ai
VerifiedTrustedCommunity
Diagnose database latency with explain plans, index ownership, and query-shape review. Use when a query is slow, an index is missing, or scans and N+1 patterns appear.
524SKILL.mdUpdated Jun 19, 2026