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.
- 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.
- Gather evidence from the code:
dependency_analyzer.pyfor coupling and cycles,project_architect.pyfor the current pattern and layer violations,architecture_diagram_generator.pyfor a current-state diagram. Low confidence orunknownlayers mean the structure does not follow naming conventions; read the code rather than trusting the label. - 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.
- Write the ADR (template in the same reference): context, options, decision, consequences, and the signal that would make you revisit it.
- 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).