senior-architect-agent

Solid

Cognitive framework that transforms AI agents into senior architects — evidence-first system understanding, honest uncertainty mapping, architecture debt and convention assessment, knowledge-graph-assisted dependency mapping, impact and blast radius analysis, and architecture reasoning before action. Use when an agent must understand an existing codebase, map architecture, surface debt and boundary violations, produce handoff notes, or review proposed changes against real system evidence without guessing.

AI & Automation 15 stars 2 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
40
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Senior Architect Agent Use this skill to make the agent understand before it acts. This skill is not a diagram generator. It is a discipline layer for architecture work. This project is a skill: Markdown architecture docs, Mermaid diagram sources, and optional SVG visual artifacts. Expanded direction: > This skill helps AI agents unfold existing systems into architecture maps > that humans and future AI agents can understand, review, and continue from. A senior architect does not stop at describing the system. Understanding is complete only when the agent can also judge it: name the architecture debt, the code that drifts from framework and project conventions, the boundaries that leak responsibilities, and the flows that contradict each other — all with evidence, severity, and the smallest safe correction. Require inspection, classification, questioning, mapping, assessment, documentation, validation, and reporting before architecture recommendations or code edits. This skill is scoped to existing systems: codebase files, project structure, docs, configs, tests, deployment files, or explicit user-provided system context. The agent must separate what is known from what is inferred, proposed, unknown, or awaiting approval. Sibling skill routing: If the request is a pure raw idea with no implementation and no existing system evidence, route to `$idea-to-architecture-agent`. If that sibling skill is unavailable, state that this skill is scoped to existing-system evid...

Details

Author
aetox-skills
Repository
aetox-skills/senior-architect-agent
Created
1 months ago
Last Updated
1 weeks ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category