senior-architect-agent

รุ่นปัจจุบัน: v2.0.0 — Knowledge-Graph-Assisted Architecture Passes

Cognitive framework ที่เปลี่ยน AI agents ให้เป็น senior architects — evidence-first system understanding, honest uncertainty mapping, architecture debt and convention assessment, knowledge-graph-assisted dependency mapping, impact and blast radius analysis, และ architecture reasoning ก่อนลงมือ

Skill นี้บังคับให้ agent inspect, map, assess, document, validate, และรายงานระบบที่มีอยู่จริง ก่อนเสนอการเปลี่ยนแปลงสถาปัตยกรรม โดยเริ่มจาก smallest safe architecture pass เสมอ

Core Flow

Intake → Inspect → Classify → Question → Map → Assess → Document → Validate → Report

เลือก smallest safe pass:

Mode เมื่อไหร่ Output
Scan งาน bounded, exploratory, low-risk 1 compact architecture note
Focus 1 module, workflow, หรือ boundary ที่ชัดเจน 1-3 artifacts
Full Whole-system, handoff, 3+ modules interacting, persistence, security, integrations Full output package

เริ่มที่ Scan เสมอ — เลื่อนขึ้นเมื่อ scope, evidence, risk, หรือ handoff needs ต้องการ โดยต้องมี trigger + evidence + risk statement

ใช้เมื่อ

ใช้ ✅ ไม่ใช้ ❌
Agent ต้อง map existing codebase หรือระบบซอฟต์แวร์ งานเป็นไอเดียดิบล้วนๆ — ใช้ $idea-to-architecture-agent แทน
ต้องการหา architecture debt, convention drift, boundary violations, flow conflicts แค่ implementation fix เล็กๆ ที่ไม่มีผลต่อสถาปัตยกรรม
ทีมต้องการ module maps, Mermaid diagrams, handoff notes Output จะกลายเป็น decorative documentation
review การเปลี่ยนแปลงสถาปัตยกรรมก่อน approve

สิ่งที่ skill นี้ทำ

  1. Inspect ระบบจริงก่อน — file search, git history, Mermaid checks, และ codebase graph queries (เมื่อมี MCP)
  2. Map dependencies และ boundaries — optional knowledge-graph-assisted: graph data เร่งหา dependency chains, blast radius, circular dependencies โดย map เข้า evidence taxonomy เดิม (Direct/Inferred) — file reading ชนะเมื่อ graph ขัดแย้ง
  3. Assess — ชี้ debt, drift, boundary violations, flow conflicts ทุก finding ต้องมี evidence, impact, severity, confidence, smallest safe correction
  4. Validate — 3 gates: claim traceability, scope alignment, handoff readiness
  5. Output — architecture overview, module map, data flow, workflow map, debt register, risk register, open questions, ai-agent notes, Mermaid diagrams

การเลือกใช้ Skill ที่เกี่ยวข้อง

Skill ใช้เมื่อ
senior-architect-agent (นี้) ระบบที่มีอยู่, existing + proposed changes, architecture review, handoff
$idea-to-architecture-agent ไอเดียดิบ, product concept, feature request, เป้าหมายธุรกิจที่ยังไม่มี implementation

สิ่งที่รวมในรุ่นนี้ (v2.0.0)

  • ตัด Idea-to-Architecture Mode → route ไป $idea-to-architecture-agent
  • เพิ่ม Assess step — rules/assessment-rules.md, templates/debt-register.md
  • Knowledge-graph-assisted mapping และ assessment (optional) — graph cycles, fan-in outliers, layer violations → signal ป้อน dimension เดิม, ไม่ใช่ finding category ใหม่
  • Rule 0 — default Scan Mode, promotion ต้องมี trigger + evidence + risk
  • 7 rules files, 11 templates, example output

ดูทั้งหมดใน CHANGELOG.md

ตัวอย่าง Output

examples/basic-web-app/output/
├── architecture-overview.md
├── system-boundary.md
├── module-map.md
├── data-flow.md
├── workflow-map.md
├── file-responsibility-map.md
├── debt-register.md
├── risk-register.md
├── diagram.mmd / diagram.svg
├── open-questions.md
└── ai-agent-notes.md

โครงสร้างไฟล์

senior-architect-agent/
├── README.md / SKILL.md / INSTALL.md / CHANGELOG.md / LICENSE
├── assets/visuals/       # infographic, workflow GIF, Mermaid source
├── scripts/              # build tooling (build_core_flow_gif.py)
├── agents/               # interface metadata (openai.yaml)
├── adapters/             # AGENTS.example.md
├── docs/                 # philosophy, workflow, output-spec, diagram-guidelines, model-requirements, anti-patterns
├── rules/                # 7 rule files (inspection, question, assessment, documentation, diagram, anti-overengineering, agent-handoff)
├── templates/            # 11 output templates
└── examples/             # basic-web-app output

ข้อกำหนดโมเดล

ต้องการ long context (128K+ ปกติ, 200K+ สำหรับ multi-service) และ instruction following ที่แข็งแรง 32K พอสำหรับ Scan Mode

ดู Model Requirements

การติดตั้ง

ดู INSTALL.md สำหรับ Codex, Claude Code, Antigravity, AGENTS.md, และ manual

aetox-skills/senior-architect-agent

License

MIT