senior-architect

Installation
SKILL.md

Senior Architect

Architecture design and analysis tools for making informed technical decisions: visualize system structure, analyze dependencies and coupling, detect architectural patterns, and run decision workflows for databases, patterns, and monolith-vs-microservices trade-offs.

Decision Workflow

The value of this skill is the decision and its record; the tools supply evidence.

  1. Frame the decision: one question (for example "split billing out of the monolith?"), the constraints (team size, deployment cadence, data consistency, budget) and who decides.
  2. Gather evidence from the code: dependency_analyzer.py for coupling and cycles, project_architect.py for the current pattern and layer violations, architecture_diagram_generator.py for a current-state diagram. Low confidence or unknown layers mean the structure does not follow naming conventions; read the code rather than trusting the label.
  3. Run the matching workflow in references/decision_workflows.md: database selection, pattern selection, or monolith vs microservices. Write down at least two real options and the cost of each.
  4. Write the ADR (template in the same reference): context, options, decision, consequences, and the signal that would make you revisit it.
  5. Done when the ADR is accepted by the people who will own the result, and the evidence it cites can be regenerated by rerunning the tools.

Not this skill: cloud-provider service design (see engineering/aws-solution-architect, engineering/azure-cloud-architect, engineering/gcp-cloud-architect), choosing between frameworks or vendors (see engineering/tech-stack-evaluator), and backend implementation (see engineering/senior-backend).

Core Capabilities

Installs
245
GitHub Stars
1.2K
First Seen
Jan 24, 2026