senior-architect/SKILL.md
System architecture design, ADRs, dependency analysis, architecture pattern selection (monolith, microservices, CQRS, event sourcing, hexagonal), database and tech stack decision matrices. Use when making architecture decisions or evaluating system design.
npx skillsauth add lidge-jun/cli-jaw-skills senior-architectInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Architecture design guidance: pattern selection, decision documentation, dependency analysis, and system evolution strategies.
# ADR-001: [Decision Title]
## Status
Accepted | Proposed | Deprecated | Superseded by ADR-XXX
## Context
What problem are we facing? What constraints exist?
## Decision
What did we decide and why?
## Consequences
- Positive: [benefits]
- Negative: [trade-offs accepted]
- Risks: [what could go wrong]
Store in: docs/adrs/ or docs/architecture/decisions/
| Requirement | Recommended Pattern | |---|---| | Rapid MVP development | Modular Monolith | | Independent team deployment | Microservices | | Complex domain logic | Domain-Driven Design | | High read/write ratio difference | CQRS | | Audit trail required | Event Sourcing | | Third-party integrations | Hexagonal (Ports & Adapters) |
| Pattern | Key Idea | Trade-off | |---------|----------|-----------| | Modular Monolith | Single deployment, clear module boundaries | Easy start, harder to scale independently | | Microservices | Independent services, own databases | Operational complexity, network latency | | CQRS | Separate read/write models | Complexity increase, eventual consistency | | Event Sourcing | Store events, not state | Full audit trail, replay capability; harder queries | | Hexagonal | Ports & adapters separate core from infra | Testable, swappable; more indirection |
| Signal | Healthy | Unhealthy | |--------|---------|-----------| | Direction | Unidirectional (A → B) | Circular (A → B → C → A) | | Coupling | Interface-based | Implementation-based | | Scope | Narrow (few imports) | Broad (importing internals) |
| Type | Best For | |------|----------| | PostgreSQL | Default for most apps. ACID, complex queries, JSON support | | MongoDB | Flexible schema, document-oriented, rapid prototyping | | Redis | Caching, sessions, real-time features | | DynamoDB | Serverless, auto-scaling, AWS-native | | TimescaleDB | Time-series with SQL |
| Question | Recommendation | |----------|---------------| | SEO required? | Next.js with SSR | | Internal dashboard? | React + Vite | | API-first backend? | FastAPI or Fastify | | Enterprise scale? | NestJS + PostgreSQL | | Rapid prototype? | Next.js API routes | | Real-time needed? | WebSocket layer (Socket.io, ws) |
tools
Use only on the Codex CLI for native image generation or image editing without an API key. Save final PNG files under ~/.cli-jaw/uploads, report web-ready absolute-path markdown, and send to Telegram or Discord only when explicitly requested.
tools
Ranked repository structure map via `cli-jaw map`. Use for codebase overview, structure map, symbol overview, unfamiliar codebase exploration, architecture orientation. Triggers: repo map, structure map, codebase overview, 와꾸, project structure, unfamiliar code.
tools
cli-jaw Design workspace: create, preview, run, and export design pages from the right sidebar. Covers panel UX, direct-write workflow, artifact lifecycle, wireframe generation, design system, and Open Design adapter.
development
MUST USE for infrastructure and delivery work — container builds, deploy pipelines, Kubernetes, Infrastructure as Code, SRE foundations, edge/serverless, ML infrastructure. Triggers: Dockerfile, K8s manifests, CI/CD pipeline, Terraform/IaC, release/deploy, devops/infra/deploy or release_cd task_tags.