hoangnguyen0403/common-system-design
agents/skills/common/common-system-design/SKILL.md
Enforce separation of concerns, dependency inversion, and resilience patterns across layered and distributed architectures. Use when designing new features, evaluating module boundaries, selecting architectural patterns, or resolving scalability bottlenecks.
$ install --global
skillsauthnpx skillsauth add hoangnguyen0403/agent-skills-standard common-system-designInstall 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: Apr 24, 2026, 8:00 AM54.6s4 files scanned
SKILL.md
- name:
- common-system-design
- description:
- Enforce separation of concerns, dependency inversion, and resilience patterns across layered and distributed architectures. Use when designing new features, evaluating module boundaries, selecting architectural patterns, or resolving scalability bottlenecks.
System Design & Architecture Standards
Priority: P0 (FOUNDATIONAL)
Workflow: Evaluate Architecture for New Feature
- Identify bounded contexts and module boundaries
- Define dependency direction (outer layers depend on inner)
- Select communication pattern (sync REST, async event, or hybrid)
- Validate against CAP trade-offs for distributed components
- Document decision in Architecture Decision Record (ADR)
Architectural Principles
- SoC: Divide into distinct sections per concern.
- SSOT: One source, reference elsewhere.
- Fail Fast: Fail visibly when errors occur.
- Graceful Degradation: Core functional even if secondary fails.
Modularity & Coupling
- High Cohesion: Related functionality in one module.
- Loose Coupling: Use interfaces for communication.
- DI: Inject dependencies, don't hardcode.
See implementation examples for dependency flow diagrams.
Common Patterns
- Layered: Presentation -> Logic -> Data.
- Event-Driven: Async communication between decoupled components.
- Clean/Hexagonal: Core logic independent of frameworks.
- Statelessness: Favor stateless for scaling/testing.
Distributed Systems
- CAP: Trade-off Consistency/Availability/Partition tolerance. See CAP & Consistency Patterns.
- Idempotency: Operations repeatable without side effects. See Idempotency Patterns.
- Circuit Breaker: Fail fast on failing services. See Resilience Patterns.
- Eventual Consistency: Design for async data sync. See CAP & Consistency Patterns.
Documentation & Evolution
- Design Docs: Write specs before major implementations.
- Versioning: Version APIs/schemas for backward compatibility.
- Extensibility: Use Strategy/Factory for future changes.
References
- Distributed Systems & CAP Theorem
- Resilience Patterns (Circuit Breaker, Bulkhead, Retry)
Anti-Patterns
- No god classes: Single Responsibility — one reason to change per module.
- No synchronous coupling: Prefer events or queues for cross-service calls.
- No premature abstraction: Design for current load; scale when proven needed.
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