用途：把 AI 辅助生成的代码转化为可掌握的架构文档，适用 Bun + TypeScript 项目（含 Gravito 框架）。触发时机为开发完成需产出技术规格书、优化前需分析架构缺陷、重构前需梳理逻辑。
主要能力：读入核心代码、类型定义与测试文件后，识别主要类与函数职责、追踪数据流向（输入→处理→输出）、检查设计模式，并按检查清单排查 N+1 查询、竞态条件、内存泄漏、类型安全、异常处理、性能瓶颈与安全性问题。每项问题需给出文件位置（文件名:行号）、影响评估与可执行修正建议。
使用方式：先向使用者索取核心代码路径、类型定义路径、测试路径及分析范围（完整或仅特定章节）；用 Read 工具依序读取文件；按 references/analysis-checklist.md 分析，按 references/output-template.md 生成文档，含模块概览、技术规格、关键设计决策、性能与扩展性、边界案例与限制、后续优化建议；输出执行摘要与可直接复制到 docs/architecture/[模块名].md 的 Markdown。文档模板参考 assets/DOCS_ARCH_template.md。针对 Gravito 需注意 Atlas ORM 的 Eager Loading、JOIN 策略与事务隔离级别，Luminosity 的参数验证、中间件顺序与错误处理，以及 Bun 原生 API 使用并避免误用 Node.js 专属 API。
限制：官方资料未提供安装命令、收费信息与具体性能数值；文档语言与注释要求使用繁体中文台湾用语，本文以简体中文整理。