用途:在 Python/React 全栈项目的设计阶段提供架构指导,适用于设计新模块、服务或大型功能,选择架构方案,规划数据库模式变更,决定前端状态管理,评估技术取舍,编写或评审架构决策记录(ADR),以及从零搭建新项目或子系统。若存在 plan.md(来自 project-planner),先读取以了解功能范围与受影响模块,否则直接依据用户请求。输出写入 architecture.md,并在 docs/adr/ADR-NNN-<title>.md 创建 ADR,随后提示运行 /api-design-patterns 或 /task-decomposition。
主要能力:给出后端 FastAPI 分层模式(Routers→Services→Repositories→Models/Schemas)及严格依赖方向与依赖注入写法;前端 React/TypeScript 分层(Pages、Layouts、Features、Shared Components、Hooks、API、Types)及组件依赖方向;五步决策框架(定义问题、列出选项、按可维护性/可测试性/性能等加权评估、决策并记录、沟通);数据库设计原则(先 3NF、每次迁移一个逻辑变更、必须含 downgrade、索引策略)与 SQLAlchemy 2.0 异步模式(每请求一个 AsyncSession、禁用懒加载、用 selectin/joined);迁移规划命令 alembic revision --autogenerate -m "description"、alembic upgrade head、alembic downgrade -1;前端状态管理决策树(服务端数据用 TanStack Query,跨组件复杂状态用 Zustand,简单用 Context,局部用 useState/useReducer);路由结构、认证流程(短期访问令牌存内存、刷新令牌存 httpOnly cookie)、错误处理分层、structlog 日志、pydantic-settings 与 Vite 环境变量配置;单体与微服务取舍、可打破分层模式的例外情形、架构演进方式。
限制:不用于编写实现代码、API 契约设计、测试策略或部署基础设施决策。资料未提供具体收费、价格、平台与效果信息。