Architecture

architecture-decision-records helps capture architectural decisions during Claude Code sessions as structured ADRs. It detects decision moments, records context, alternatives, and rationale, and keeps an ADR log for future maintainers. Useful for Technical Writing and engineering teams that need durable decision history.

improve-codebase-architecture helps you find architectural friction, shallow modules, and deepening opportunities in a codebase. Use it for refactoring reviews, testability improvements, and AI-navigable design decisions, especially when you want the skill to respect CONTEXT.md and docs/adr/ guidance.

migration-architect helps plan zero-downtime database, service, and infrastructure migrations with phased execution, compatibility validation, data reconciliation, and rollback runbooks. Includes scripts for migration plans, compatibility checks, and rollback generation for Software Architecture teams.

senior-architect is a Software Architecture skill for system design, ADRs, stack decisions, scalability reviews, dependency analysis, and architecture diagrams using included Python scripts and references.

cto-advisor is a CTO leadership skill for architecture decisions, technical debt, engineering metrics, technology evaluation, team scaling, and strategic planning. Includes ADR, DORA, evaluation frameworks, plus Python tools for debt analysis and team scaling.

cto-review is a Strategic Planning skill for pressure-testing architecture, scaling cliffs, tech debt, team ramp risk, and build-vs-buy decisions with /cs:cto-review <plan>. It is prompt-first; verify optional referenced analyzer scripts after install.

documentation-and-adrs helps agents write decision-focused technical documentation and ADRs. Use it to capture context, constraints, tradeoffs, rejected options, and consequences for architecture, APIs, infrastructure, auth, and feature changes. It is ideal when you need durable rationale for future engineers and agents, not just a polished summary.

archimate helps you create ArchiMate diagrams in PlantUML with `!include <archimate/Archimate>`, typed element macros, and relationship macros. It fits layered enterprise architecture views for business, application, technology, motivation, and migration planning. Use archimate for Diagramming when you need structured EA notation, not generic cloud or network diagrams.

The kaizen skill guides small, safe code improvements for refactoring, architecture, workflow fixes, error handling, and validation. It favors iterative changes, design-time prevention, and minimal scope. Use it when you want a practical kaizen guide that improves code without over-engineering.

clickhouse-architecture-advisor helps design ClickHouse workloads with workload-aware decisions for ingestion, partitioning, joins, dictionaries, upserts, and pre-aggregation. It is especially useful for Backend Development, observability, SIEM, product analytics, IoT telemetry, and financial pipelines. The skill labels guidance as official, derived, or field.

plan-eng-review is an interactive engineering plan review skill for locking down architecture, data flow, edge cases, test coverage, performance, and rollout risk before coding begins. Use the plan-eng-review skill when you have a design doc or implementation plan and want sharper feedback than a generic review prompt.

The cloud-solution-architect skill helps an agent act like an Azure Cloud Solution Architect for Cloud Architecture decisions. Use it to review designs, choose architecture styles, compare Azure services, and apply design principles, patterns, and best practices with less guesswork than a generic prompt.