@rdmind/rdmind 0.0.9-alpha.1 → 0.0.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.knowledge/.ext/.bmad-core/agent-teams/team-all.yaml +15 -0
- package/.knowledge/.ext/.bmad-core/agent-teams/team-fullstack.yaml +19 -0
- package/.knowledge/.ext/.bmad-core/agent-teams/team-ide-minimal.yaml +11 -0
- package/.knowledge/.ext/.bmad-core/agent-teams/team-no-ui.yaml +14 -0
- package/.knowledge/.ext/.bmad-core/agents/analyst.md +84 -0
- package/.knowledge/.ext/.bmad-core/agents/architect.md +85 -0
- package/.knowledge/.ext/.bmad-core/agents/bmad-master.md +110 -0
- package/.knowledge/.ext/.bmad-core/agents/bmad-orchestrator.md +147 -0
- package/.knowledge/.ext/.bmad-core/agents/dev.md +81 -0
- package/.knowledge/.ext/.bmad-core/agents/pm.md +84 -0
- package/.knowledge/.ext/.bmad-core/agents/po.md +79 -0
- package/.knowledge/.ext/.bmad-core/agents/qa.md +90 -0
- package/.knowledge/.ext/.bmad-core/agents/ra.md +74 -0
- package/.knowledge/.ext/.bmad-core/agents/sm.md +65 -0
- package/.knowledge/.ext/.bmad-core/agents/ux-expert.md +69 -0
- package/.knowledge/.ext/.bmad-core/checklists/architect-checklist.md +440 -0
- package/.knowledge/.ext/.bmad-core/checklists/change-checklist.md +184 -0
- package/.knowledge/.ext/.bmad-core/checklists/pm-checklist.md +372 -0
- package/.knowledge/.ext/.bmad-core/checklists/po-master-checklist.md +434 -0
- package/.knowledge/.ext/.bmad-core/checklists/story-dod-checklist.md +96 -0
- package/.knowledge/.ext/.bmad-core/checklists/story-draft-checklist.md +155 -0
- package/.knowledge/.ext/.bmad-core/checklists/trd-checklist.md +226 -0
- package/.knowledge/.ext/.bmad-core/core-config.yaml +22 -0
- package/.knowledge/.ext/.bmad-core/data/bmad-kb.md +809 -0
- package/.knowledge/.ext/.bmad-core/data/brainstorming-techniques.md +38 -0
- package/.knowledge/.ext/.bmad-core/data/elicitation-methods.md +156 -0
- package/.knowledge/.ext/.bmad-core/data/technical-preferences.md +5 -0
- package/.knowledge/.ext/.bmad-core/data/test-levels-framework.md +148 -0
- package/.knowledge/.ext/.bmad-core/data/test-priorities-matrix.md +174 -0
- package/.knowledge/.ext/.bmad-core/enhanced-ide-development-workflow.md +248 -0
- package/.knowledge/.ext/.bmad-core/install-manifest.yaml +512 -0
- package/.knowledge/.ext/.bmad-core/tasks/advanced-elicitation.md +119 -0
- package/.knowledge/.ext/.bmad-core/tasks/analyze-prd.md +123 -0
- package/.knowledge/.ext/.bmad-core/tasks/apply-qa-fixes.md +150 -0
- package/.knowledge/.ext/.bmad-core/tasks/brownfield-create-epic.md +162 -0
- package/.knowledge/.ext/.bmad-core/tasks/brownfield-create-story.md +149 -0
- package/.knowledge/.ext/.bmad-core/tasks/correct-course.md +72 -0
- package/.knowledge/.ext/.bmad-core/tasks/create-brownfield-story.md +314 -0
- package/.knowledge/.ext/.bmad-core/tasks/create-deep-research-prompt.md +280 -0
- package/.knowledge/.ext/.bmad-core/tasks/create-doc.md +103 -0
- package/.knowledge/.ext/.bmad-core/tasks/create-next-story.md +114 -0
- package/.knowledge/.ext/.bmad-core/tasks/document-project.md +345 -0
- package/.knowledge/.ext/.bmad-core/tasks/execute-checklist.md +88 -0
- package/.knowledge/.ext/.bmad-core/tasks/facilitate-brainstorming-session.md +138 -0
- package/.knowledge/.ext/.bmad-core/tasks/generate-ai-frontend-prompt.md +53 -0
- package/.knowledge/.ext/.bmad-core/tasks/index-docs.md +175 -0
- package/.knowledge/.ext/.bmad-core/tasks/kb-mode-interaction.md +77 -0
- package/.knowledge/.ext/.bmad-core/tasks/nfr-assess.md +345 -0
- package/.knowledge/.ext/.bmad-core/tasks/qa-gate.md +163 -0
- package/.knowledge/.ext/.bmad-core/tasks/review-story.md +316 -0
- package/.knowledge/.ext/.bmad-core/tasks/risk-profile.md +355 -0
- package/.knowledge/.ext/.bmad-core/tasks/shard-doc.md +187 -0
- package/.knowledge/.ext/.bmad-core/tasks/test-design.md +176 -0
- package/.knowledge/.ext/.bmad-core/tasks/trace-requirements.md +266 -0
- package/.knowledge/.ext/.bmad-core/tasks/validate-next-story.md +136 -0
- package/.knowledge/.ext/.bmad-core/tasks/validate-trd.md +158 -0
- package/.knowledge/.ext/.bmad-core/templates/architecture-tmpl.yaml +651 -0
- package/.knowledge/.ext/.bmad-core/templates/brainstorming-output-tmpl.yaml +156 -0
- package/.knowledge/.ext/.bmad-core/templates/brownfield-architecture-tmpl.yaml +478 -0
- package/.knowledge/.ext/.bmad-core/templates/brownfield-prd-tmpl.yaml +281 -0
- package/.knowledge/.ext/.bmad-core/templates/competitor-analysis-tmpl.yaml +349 -0
- package/.knowledge/.ext/.bmad-core/templates/front-end-architecture-tmpl.yaml +273 -0
- package/.knowledge/.ext/.bmad-core/templates/front-end-spec-tmpl.yaml +360 -0
- package/.knowledge/.ext/.bmad-core/templates/fullstack-architecture-tmpl.yaml +947 -0
- package/.knowledge/.ext/.bmad-core/templates/market-research-tmpl.yaml +253 -0
- package/.knowledge/.ext/.bmad-core/templates/prd-tmpl.yaml +203 -0
- package/.knowledge/.ext/.bmad-core/templates/project-brief-tmpl.yaml +222 -0
- package/.knowledge/.ext/.bmad-core/templates/qa-gate-tmpl.yaml +103 -0
- package/.knowledge/.ext/.bmad-core/templates/story-tmpl.yaml +138 -0
- package/.knowledge/.ext/.bmad-core/templates/trd-tmpl.yaml +198 -0
- package/.knowledge/.ext/.bmad-core/user-guide.md +530 -0
- package/.knowledge/.ext/.bmad-core/utils/bmad-doc-template.md +327 -0
- package/.knowledge/.ext/.bmad-core/utils/workflow-management.md +71 -0
- package/.knowledge/.ext/.bmad-core/workflows/brownfield-fullstack.yaml +298 -0
- package/.knowledge/.ext/.bmad-core/workflows/brownfield-service.yaml +188 -0
- package/.knowledge/.ext/.bmad-core/workflows/brownfield-ui.yaml +198 -0
- package/.knowledge/.ext/.bmad-core/workflows/greenfield-fullstack.yaml +241 -0
- package/.knowledge/.ext/.bmad-core/workflows/greenfield-service.yaml +207 -0
- package/.knowledge/.ext/.bmad-core/workflows/greenfield-ui.yaml +236 -0
- package/.knowledge/.ext/.bmad-core/working-in-the-brownfield.md +606 -0
- package/.knowledge/.ext/coding/ddd-architecture.md +223 -0
- package/.knowledge/.ext/coding/java-standards.md +308 -0
- package/.knowledge/.ext/coding/mybatis-standards.md +407 -0
- package/.knowledge/.ext/coding/sql-standards.md +263 -0
- package/.knowledge/.ext/coding/thrift-service.md +292 -0
- package/.knowledge/BMAD.md +255 -0
- package/.knowledge/coding.md +135 -0
- package/dist/package.json +4 -3
- package/dist/src/config/extension.js.map +1 -1
- package/dist/src/generated/git-commit.d.ts +2 -2
- package/dist/src/generated/git-commit.js +2 -2
- package/dist/src/generated/git-commit.js.map +1 -1
- package/dist/src/services/McpPromptLoader.js +1 -1
- package/dist/src/services/McpPromptLoader.js.map +1 -1
- package/dist/src/services/prompt-processors/atFileProcessor.js +1 -1
- package/dist/src/services/prompt-processors/atFileProcessor.js.map +1 -1
- package/dist/src/ui/commands/mcpCommand.js.map +1 -1
- package/dist/src/ui/components/ContextSummaryDisplay.js.map +1 -1
- package/dist/src/ui/components/Tips.js +1 -1
- package/dist/src/ui/components/Tips.js.map +1 -1
- package/dist/src/ui/components/messages/ToolConfirmationMessage.test.js.map +1 -1
- package/dist/src/ui/components/messages/ToolGroupMessage.test.js.map +1 -1
- package/dist/src/ui/components/subagents/create/CreationSummary.js.map +1 -1
- package/dist/src/ui/hooks/shellCommandProcessor.test.js.map +1 -1
- package/dist/src/ui/hooks/usePhraseCycler.js +2 -2
- package/dist/src/ui/hooks/usePhraseCycler.js.map +1 -1
- package/dist/src/utils/installationInfo.test.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -3
|
@@ -0,0 +1,440 @@
|
|
|
1
|
+
<!-- Powered by BMAD™ Core -->
|
|
2
|
+
|
|
3
|
+
# 架构师解决方案验证 Checklist
|
|
4
|
+
|
|
5
|
+
这个 checklist 是架构师在开发执行前验证技术设计和架构的完整框架。架构师应该系统性地过每个项目,确保架构健壮、可扩展、安全,并与产品需求保持一致。
|
|
6
|
+
|
|
7
|
+
[[LLM: 初始化指令 - 必需工件
|
|
8
|
+
|
|
9
|
+
在用这个 checklist 之前,确保你能访问:
|
|
10
|
+
|
|
11
|
+
1. architecture.md - 主要架构文档 (检查 docs/architecture.md)
|
|
12
|
+
2. prd.md - 产品需求文档,用于需求对齐 (检查 docs/prd.md)
|
|
13
|
+
3. frontend-architecture.md 或 fe-architecture.md - 如果这是 UI 项目 (检查 docs/frontend-architecture.md)
|
|
14
|
+
4. 架构中引用的任何系统图表
|
|
15
|
+
5. API 文档 (如果有)
|
|
16
|
+
6. 技术栈详情和版本规范
|
|
17
|
+
|
|
18
|
+
重要:如果任何必需文档缺失或无法访问,立即问用户它们的位置或内容,然后再继续。
|
|
19
|
+
|
|
20
|
+
项目类型检测:
|
|
21
|
+
先通过检查确定项目类型:
|
|
22
|
+
|
|
23
|
+
- 架构是否包含前端/UI 组件?
|
|
24
|
+
- 是否有 frontend-architecture.md 文档?
|
|
25
|
+
- PRD 是否提到用户界面或前端需求?
|
|
26
|
+
|
|
27
|
+
如果这是纯后端或纯服务项目:
|
|
28
|
+
|
|
29
|
+
- 跳过标记为 [[FRONTEND ONLY]] 的部分
|
|
30
|
+
- 额外关注 API 设计、服务架构和集成模式
|
|
31
|
+
- 在最终报告里注明由于项目类型跳过了前端部分
|
|
32
|
+
|
|
33
|
+
验证方法:
|
|
34
|
+
对于每个部分,你必须:
|
|
35
|
+
|
|
36
|
+
1. 深度分析 - 别只是打勾,要对照提供的文档彻底分析每个项目
|
|
37
|
+
2. 基于证据 - 验证时引用文档中的具体部分或引用
|
|
38
|
+
3. 批判性思维 - 质疑假设并识别缺口,不只是确认存在的内容
|
|
39
|
+
4. 风险评估 - 考虑每个架构决策可能出现的问题
|
|
40
|
+
|
|
41
|
+
执行模式:
|
|
42
|
+
问用户想怎么搞 checklist:
|
|
43
|
+
|
|
44
|
+
- 逐部分 (交互模式) - 审查每个部分,展示发现,在继续前获得确认
|
|
45
|
+
- 一次性 (全面模式) - 完成完整分析并在最后展示综合报告]]
|
|
46
|
+
|
|
47
|
+
## 1. 需求对齐
|
|
48
|
+
|
|
49
|
+
[[LLM: 在评估这个部分之前,花点时间从 PRD 中完全理解产品的目的和目标。要解决的核心问题是什么?用户是谁?关键成功因素是什么?在验证对齐时记住这些。对于每个项目,别只是检查是否提到 - 要验证架构提供了具体的技术解决方案。]]
|
|
50
|
+
|
|
51
|
+
### 1.1 功能需求覆盖
|
|
52
|
+
|
|
53
|
+
- [ ] 架构支持 PRD 中的所有功能需求
|
|
54
|
+
- [ ] 所有 epic 和 story 的技术方法都已解决
|
|
55
|
+
- [ ] 考虑了边界情况和性能场景
|
|
56
|
+
- [ ] 所有必需的集成都已考虑
|
|
57
|
+
- [ ] 用户旅程得到技术架构支持
|
|
58
|
+
|
|
59
|
+
### 1.2 非功能需求对齐
|
|
60
|
+
|
|
61
|
+
- [ ] 性能需求有具体解决方案
|
|
62
|
+
- [ ] 可扩展性考虑有文档记录和方法
|
|
63
|
+
- [ ] 安全需求有相应的技术控制
|
|
64
|
+
- [ ] 可靠性和弹性方法已定义
|
|
65
|
+
- [ ] 合规需求有技术实现
|
|
66
|
+
|
|
67
|
+
### 1.3 技术约束遵循
|
|
68
|
+
|
|
69
|
+
- [ ] PRD 中的所有技术约束都得到满足
|
|
70
|
+
- [ ] 遵循平台/语言要求
|
|
71
|
+
- [ ] 适应基础设施约束
|
|
72
|
+
- [ ] 解决第三方服务约束
|
|
73
|
+
- [ ] 遵循组织技术标准
|
|
74
|
+
|
|
75
|
+
## 2. 架构基础
|
|
76
|
+
|
|
77
|
+
[[LLM: 架构清晰度对成功实现至关重要。在审查这个部分时,想象你在向新开发者解释系统。是否有任何可能导致误解的歧义?AI 代理能否在没有困惑的情况下实现这个架构?寻找具体的图表、组件定义和清晰的交互模式。]]
|
|
78
|
+
|
|
79
|
+
### 2.1 架构清晰度
|
|
80
|
+
|
|
81
|
+
- [ ] 架构用清晰的图表记录
|
|
82
|
+
- [ ] 主要组件及其职责已定义
|
|
83
|
+
- [ ] 组件交互和依赖关系已映射
|
|
84
|
+
- [ ] 数据流清晰说明
|
|
85
|
+
- [ ] 每个组件的技术选择已指定
|
|
86
|
+
|
|
87
|
+
### 2.2 关注点分离
|
|
88
|
+
|
|
89
|
+
- [ ] UI、业务逻辑和数据层之间有清晰边界
|
|
90
|
+
- [ ] 组件间职责清晰划分
|
|
91
|
+
- [ ] 组件间接口定义良好
|
|
92
|
+
- [ ] 组件遵循单一职责原则
|
|
93
|
+
- [ ] 横切关注点 (日志、认证等) 得到适当处理
|
|
94
|
+
|
|
95
|
+
### 2.3 设计模式和最佳实践
|
|
96
|
+
|
|
97
|
+
- [ ] 采用适当的设计模式
|
|
98
|
+
- [ ] 遵循行业最佳实践
|
|
99
|
+
- [ ] 避免反模式
|
|
100
|
+
- [ ] 整个架构风格一致
|
|
101
|
+
- [ ] 模式使用有文档记录和解释
|
|
102
|
+
|
|
103
|
+
### 2.4 模块化和可维护性
|
|
104
|
+
|
|
105
|
+
- [ ] 系统分为内聚、松耦合的模块
|
|
106
|
+
- [ ] 组件可以独立开发和测试
|
|
107
|
+
- [ ] 变更可以本地化到特定组件
|
|
108
|
+
- [ ] 代码组织促进可发现性
|
|
109
|
+
- [ ] 架构专门为 AI 代理实现设计
|
|
110
|
+
|
|
111
|
+
## 3. 技术栈和决策
|
|
112
|
+
|
|
113
|
+
[[LLM: 技术选择有长期影响。对于每个技术决策,考虑:这是能工作的最简单解决方案吗?我们过度工程了吗?这会扩展吗?维护影响是什么?所选版本有安全漏洞吗?验证具体版本已定义,不是范围。]]
|
|
114
|
+
|
|
115
|
+
### 3.1 技术选择
|
|
116
|
+
|
|
117
|
+
- [ ] 所选技术满足所有需求
|
|
118
|
+
- [ ] 技术版本具体定义 (不是范围)
|
|
119
|
+
- [ ] 技术选择有清晰理由证明
|
|
120
|
+
- [ ] 考虑的替代方案有优缺点文档
|
|
121
|
+
- [ ] 所选栈组件配合良好
|
|
122
|
+
|
|
123
|
+
### 3.2 前端架构 [[FRONTEND ONLY]]
|
|
124
|
+
|
|
125
|
+
[[LLM: 如果这是纯后端或纯服务项目,跳过整个部分。只有在项目包含用户界面时才评估。]]
|
|
126
|
+
|
|
127
|
+
- [ ] UI 框架和库具体选择
|
|
128
|
+
- [ ] 状态管理方法已定义
|
|
129
|
+
- [ ] 组件结构和组织已指定
|
|
130
|
+
- [ ] 响应式/自适应设计方法已概述
|
|
131
|
+
- [ ] 构建和打包策略已确定
|
|
132
|
+
|
|
133
|
+
### 3.3 后端架构
|
|
134
|
+
|
|
135
|
+
- [ ] API 设计和标准已定义
|
|
136
|
+
- [ ] 服务组织和边界清晰
|
|
137
|
+
- [ ] 认证和授权方法已指定
|
|
138
|
+
- [ ] 错误处理策略已概述
|
|
139
|
+
- [ ] 后端扩展方法已定义
|
|
140
|
+
|
|
141
|
+
### 3.4 数据架构
|
|
142
|
+
|
|
143
|
+
- [ ] 数据模型完全定义
|
|
144
|
+
- [ ] 数据库技术有理由选择
|
|
145
|
+
- [ ] 数据访问模式已文档化
|
|
146
|
+
- [ ] 数据迁移/种子方法已指定
|
|
147
|
+
- [ ] 数据备份和恢复策略已概述
|
|
148
|
+
|
|
149
|
+
## 4. 前端设计和实现 [[FRONTEND ONLY]]
|
|
150
|
+
|
|
151
|
+
[[LLM: 对于纯后端项目,应该跳过整个部分。只有在项目包含用户界面时才评估。评估时,确保主架构文档和前端特定架构文档之间的一致性。]]
|
|
152
|
+
|
|
153
|
+
### 4.1 前端理念和模式
|
|
154
|
+
|
|
155
|
+
- [ ] 框架和核心库与主架构文档一致
|
|
156
|
+
- [ ] 组件架构 (如原子设计) 清晰描述
|
|
157
|
+
- [ ] 状态管理策略适合应用复杂度
|
|
158
|
+
- [ ] 数据流模式一致且清晰
|
|
159
|
+
- [ ] 样式方法已定义且工具已指定
|
|
160
|
+
|
|
161
|
+
### 4.2 前端结构和组织
|
|
162
|
+
|
|
163
|
+
- [ ] 目录结构用 ASCII 图表清晰文档化
|
|
164
|
+
- [ ] 组件组织遵循既定模式
|
|
165
|
+
- [ ] 文件命名约定明确
|
|
166
|
+
- [ ] 结构支持所选框架的最佳实践
|
|
167
|
+
- [ ] 新组件放置位置的清晰指导
|
|
168
|
+
|
|
169
|
+
### 4.3 Component Design
|
|
170
|
+
|
|
171
|
+
- [ ] Component template/specification format is defined
|
|
172
|
+
- [ ] Component props, state, and events are well-documented
|
|
173
|
+
- [ ] Shared/foundational components are identified
|
|
174
|
+
- [ ] Component reusability patterns are established
|
|
175
|
+
- [ ] Accessibility requirements are built into component design
|
|
176
|
+
|
|
177
|
+
### 4.4 Frontend-Backend Integration
|
|
178
|
+
|
|
179
|
+
- [ ] API interaction layer is clearly defined
|
|
180
|
+
- [ ] HTTP client setup and configuration documented
|
|
181
|
+
- [ ] Error handling for API calls is comprehensive
|
|
182
|
+
- [ ] Service definitions follow consistent patterns
|
|
183
|
+
- [ ] Authentication integration with backend is clear
|
|
184
|
+
|
|
185
|
+
### 4.5 Routing & Navigation
|
|
186
|
+
|
|
187
|
+
- [ ] Routing strategy and library are specified
|
|
188
|
+
- [ ] Route definitions table is comprehensive
|
|
189
|
+
- [ ] Route protection mechanisms are defined
|
|
190
|
+
- [ ] Deep linking considerations addressed
|
|
191
|
+
- [ ] Navigation patterns are consistent
|
|
192
|
+
|
|
193
|
+
### 4.6 Frontend Performance
|
|
194
|
+
|
|
195
|
+
- [ ] Image optimization strategies defined
|
|
196
|
+
- [ ] Code splitting approach documented
|
|
197
|
+
- [ ] Lazy loading patterns established
|
|
198
|
+
- [ ] Re-render optimization techniques specified
|
|
199
|
+
- [ ] Performance monitoring approach defined
|
|
200
|
+
|
|
201
|
+
## 5. RESILIENCE & OPERATIONAL READINESS
|
|
202
|
+
|
|
203
|
+
[[LLM: Production systems fail in unexpected ways. As you review this section, think about Murphy's Law - what could go wrong? Consider real-world scenarios: What happens during peak load? How does the system behave when a critical service is down? Can the operations team diagnose issues at 3 AM? Look for specific resilience patterns, not just mentions of "error handling".]]
|
|
204
|
+
|
|
205
|
+
### 5.1 Error Handling & Resilience
|
|
206
|
+
|
|
207
|
+
- [ ] Error handling strategy is comprehensive
|
|
208
|
+
- [ ] Retry policies are defined where appropriate
|
|
209
|
+
- [ ] Circuit breakers or fallbacks are specified for critical services
|
|
210
|
+
- [ ] Graceful degradation approaches are defined
|
|
211
|
+
- [ ] System can recover from partial failures
|
|
212
|
+
|
|
213
|
+
### 5.2 Monitoring & Observability
|
|
214
|
+
|
|
215
|
+
- [ ] Logging strategy is defined
|
|
216
|
+
- [ ] Monitoring approach is specified
|
|
217
|
+
- [ ] Key metrics for system health are identified
|
|
218
|
+
- [ ] Alerting thresholds and strategies are outlined
|
|
219
|
+
- [ ] Debugging and troubleshooting capabilities are built in
|
|
220
|
+
|
|
221
|
+
### 5.3 Performance & Scaling
|
|
222
|
+
|
|
223
|
+
- [ ] Performance bottlenecks are identified and addressed
|
|
224
|
+
- [ ] Caching strategy is defined where appropriate
|
|
225
|
+
- [ ] Load balancing approach is specified
|
|
226
|
+
- [ ] Horizontal and vertical scaling strategies are outlined
|
|
227
|
+
- [ ] Resource sizing recommendations are provided
|
|
228
|
+
|
|
229
|
+
### 5.4 Deployment & DevOps
|
|
230
|
+
|
|
231
|
+
- [ ] Deployment strategy is defined
|
|
232
|
+
- [ ] CI/CD pipeline approach is outlined
|
|
233
|
+
- [ ] Environment strategy (dev, staging, prod) is specified
|
|
234
|
+
- [ ] Infrastructure as Code approach is defined
|
|
235
|
+
- [ ] Rollback and recovery procedures are outlined
|
|
236
|
+
|
|
237
|
+
## 6. SECURITY & COMPLIANCE
|
|
238
|
+
|
|
239
|
+
[[LLM: Security is not optional. Review this section with a hacker's mindset - how could someone exploit this system? Also consider compliance: Are there industry-specific regulations that apply? GDPR? HIPAA? PCI? Ensure the architecture addresses these proactively. Look for specific security controls, not just general statements.]]
|
|
240
|
+
|
|
241
|
+
### 6.1 Authentication & Authorization
|
|
242
|
+
|
|
243
|
+
- [ ] Authentication mechanism is clearly defined
|
|
244
|
+
- [ ] Authorization model is specified
|
|
245
|
+
- [ ] Role-based access control is outlined if required
|
|
246
|
+
- [ ] Session management approach is defined
|
|
247
|
+
- [ ] Credential management is addressed
|
|
248
|
+
|
|
249
|
+
### 6.2 Data Security
|
|
250
|
+
|
|
251
|
+
- [ ] Data encryption approach (at rest and in transit) is specified
|
|
252
|
+
- [ ] Sensitive data handling procedures are defined
|
|
253
|
+
- [ ] Data retention and purging policies are outlined
|
|
254
|
+
- [ ] Backup encryption is addressed if required
|
|
255
|
+
- [ ] Data access audit trails are specified if required
|
|
256
|
+
|
|
257
|
+
### 6.3 API & Service Security
|
|
258
|
+
|
|
259
|
+
- [ ] API security controls are defined
|
|
260
|
+
- [ ] Rate limiting and throttling approaches are specified
|
|
261
|
+
- [ ] Input validation strategy is outlined
|
|
262
|
+
- [ ] CSRF/XSS prevention measures are addressed
|
|
263
|
+
- [ ] Secure communication protocols are specified
|
|
264
|
+
|
|
265
|
+
### 6.4 Infrastructure Security
|
|
266
|
+
|
|
267
|
+
- [ ] Network security design is outlined
|
|
268
|
+
- [ ] Firewall and security group configurations are specified
|
|
269
|
+
- [ ] Service isolation approach is defined
|
|
270
|
+
- [ ] Least privilege principle is applied
|
|
271
|
+
- [ ] Security monitoring strategy is outlined
|
|
272
|
+
|
|
273
|
+
## 7. IMPLEMENTATION GUIDANCE
|
|
274
|
+
|
|
275
|
+
[[LLM: Clear implementation guidance prevents costly mistakes. As you review this section, imagine you're a developer starting on day one. Do they have everything they need to be productive? Are coding standards clear enough to maintain consistency across the team? Look for specific examples and patterns.]]
|
|
276
|
+
|
|
277
|
+
### 7.1 Coding Standards & Practices
|
|
278
|
+
|
|
279
|
+
- [ ] Coding standards are defined
|
|
280
|
+
- [ ] Documentation requirements are specified
|
|
281
|
+
- [ ] Testing expectations are outlined
|
|
282
|
+
- [ ] Code organization principles are defined
|
|
283
|
+
- [ ] Naming conventions are specified
|
|
284
|
+
|
|
285
|
+
### 7.2 Testing Strategy
|
|
286
|
+
|
|
287
|
+
- [ ] Unit testing approach is defined
|
|
288
|
+
- [ ] Integration testing strategy is outlined
|
|
289
|
+
- [ ] E2E testing approach is specified
|
|
290
|
+
- [ ] Performance testing requirements are outlined
|
|
291
|
+
- [ ] Security testing approach is defined
|
|
292
|
+
|
|
293
|
+
### 7.3 Frontend Testing [[FRONTEND ONLY]]
|
|
294
|
+
|
|
295
|
+
[[LLM: Skip this subsection for backend-only projects.]]
|
|
296
|
+
|
|
297
|
+
- [ ] Component testing scope and tools defined
|
|
298
|
+
- [ ] UI integration testing approach specified
|
|
299
|
+
- [ ] Visual regression testing considered
|
|
300
|
+
- [ ] Accessibility testing tools identified
|
|
301
|
+
- [ ] Frontend-specific test data management addressed
|
|
302
|
+
|
|
303
|
+
### 7.4 Development Environment
|
|
304
|
+
|
|
305
|
+
- [ ] Local development environment setup is documented
|
|
306
|
+
- [ ] Required tools and configurations are specified
|
|
307
|
+
- [ ] Development workflows are outlined
|
|
308
|
+
- [ ] Source control practices are defined
|
|
309
|
+
- [ ] Dependency management approach is specified
|
|
310
|
+
|
|
311
|
+
### 7.5 Technical Documentation
|
|
312
|
+
|
|
313
|
+
- [ ] API documentation standards are defined
|
|
314
|
+
- [ ] Architecture documentation requirements are specified
|
|
315
|
+
- [ ] Code documentation expectations are outlined
|
|
316
|
+
- [ ] System diagrams and visualizations are included
|
|
317
|
+
- [ ] Decision records for key choices are included
|
|
318
|
+
|
|
319
|
+
## 8. DEPENDENCY & INTEGRATION MANAGEMENT
|
|
320
|
+
|
|
321
|
+
[[LLM: Dependencies are often the source of production issues. For each dependency, consider: What happens if it's unavailable? Is there a newer version with security patches? Are we locked into a vendor? What's our contingency plan? Verify specific versions and fallback strategies.]]
|
|
322
|
+
|
|
323
|
+
### 8.1 External Dependencies
|
|
324
|
+
|
|
325
|
+
- [ ] All external dependencies are identified
|
|
326
|
+
- [ ] Versioning strategy for dependencies is defined
|
|
327
|
+
- [ ] Fallback approaches for critical dependencies are specified
|
|
328
|
+
- [ ] Licensing implications are addressed
|
|
329
|
+
- [ ] Update and patching strategy is outlined
|
|
330
|
+
|
|
331
|
+
### 8.2 Internal Dependencies
|
|
332
|
+
|
|
333
|
+
- [ ] Component dependencies are clearly mapped
|
|
334
|
+
- [ ] Build order dependencies are addressed
|
|
335
|
+
- [ ] Shared services and utilities are identified
|
|
336
|
+
- [ ] Circular dependencies are eliminated
|
|
337
|
+
- [ ] Versioning strategy for internal components is defined
|
|
338
|
+
|
|
339
|
+
### 8.3 Third-Party Integrations
|
|
340
|
+
|
|
341
|
+
- [ ] All third-party integrations are identified
|
|
342
|
+
- [ ] Integration approaches are defined
|
|
343
|
+
- [ ] Authentication with third parties is addressed
|
|
344
|
+
- [ ] Error handling for integration failures is specified
|
|
345
|
+
- [ ] Rate limits and quotas are considered
|
|
346
|
+
|
|
347
|
+
## 9. AI AGENT IMPLEMENTATION SUITABILITY
|
|
348
|
+
|
|
349
|
+
[[LLM: This architecture may be implemented by AI agents. Review with extreme clarity in mind. Are patterns consistent? Is complexity minimized? Would an AI agent make incorrect assumptions? Remember: explicit is better than implicit. Look for clear file structures, naming conventions, and implementation patterns.]]
|
|
350
|
+
|
|
351
|
+
### 9.1 Modularity for AI Agents
|
|
352
|
+
|
|
353
|
+
- [ ] Components are sized appropriately for AI agent implementation
|
|
354
|
+
- [ ] Dependencies between components are minimized
|
|
355
|
+
- [ ] Clear interfaces between components are defined
|
|
356
|
+
- [ ] Components have singular, well-defined responsibilities
|
|
357
|
+
- [ ] File and code organization optimized for AI agent understanding
|
|
358
|
+
|
|
359
|
+
### 9.2 Clarity & Predictability
|
|
360
|
+
|
|
361
|
+
- [ ] Patterns are consistent and predictable
|
|
362
|
+
- [ ] Complex logic is broken down into simpler steps
|
|
363
|
+
- [ ] Architecture avoids overly clever or obscure approaches
|
|
364
|
+
- [ ] Examples are provided for unfamiliar patterns
|
|
365
|
+
- [ ] Component responsibilities are explicit and clear
|
|
366
|
+
|
|
367
|
+
### 9.3 Implementation Guidance
|
|
368
|
+
|
|
369
|
+
- [ ] Detailed implementation guidance is provided
|
|
370
|
+
- [ ] Code structure templates are defined
|
|
371
|
+
- [ ] Specific implementation patterns are documented
|
|
372
|
+
- [ ] Common pitfalls are identified with solutions
|
|
373
|
+
- [ ] References to similar implementations are provided when helpful
|
|
374
|
+
|
|
375
|
+
### 9.4 Error Prevention & Handling
|
|
376
|
+
|
|
377
|
+
- [ ] Design reduces opportunities for implementation errors
|
|
378
|
+
- [ ] Validation and error checking approaches are defined
|
|
379
|
+
- [ ] Self-healing mechanisms are incorporated where possible
|
|
380
|
+
- [ ] Testing patterns are clearly defined
|
|
381
|
+
- [ ] Debugging guidance is provided
|
|
382
|
+
|
|
383
|
+
## 10. ACCESSIBILITY IMPLEMENTATION [[FRONTEND ONLY]]
|
|
384
|
+
|
|
385
|
+
[[LLM: Skip this section for backend-only projects. Accessibility is a core requirement for any user interface.]]
|
|
386
|
+
|
|
387
|
+
### 10.1 Accessibility Standards
|
|
388
|
+
|
|
389
|
+
- [ ] Semantic HTML usage is emphasized
|
|
390
|
+
- [ ] ARIA implementation guidelines provided
|
|
391
|
+
- [ ] Keyboard navigation requirements defined
|
|
392
|
+
- [ ] Focus management approach specified
|
|
393
|
+
- [ ] Screen reader compatibility addressed
|
|
394
|
+
|
|
395
|
+
### 10.2 Accessibility Testing
|
|
396
|
+
|
|
397
|
+
- [ ] Accessibility testing tools identified
|
|
398
|
+
- [ ] Testing process integrated into workflow
|
|
399
|
+
- [ ] Compliance targets (WCAG level) specified
|
|
400
|
+
- [ ] Manual testing procedures defined
|
|
401
|
+
- [ ] Automated testing approach outlined
|
|
402
|
+
|
|
403
|
+
[[LLM: 最终验证报告生成
|
|
404
|
+
|
|
405
|
+
现在你已经完成了 checklist,生成一个包含以下内容的综合验证报告:
|
|
406
|
+
|
|
407
|
+
1. 执行摘要
|
|
408
|
+
- 整体架构就绪度 (高/中/低)
|
|
409
|
+
- 识别的关键风险
|
|
410
|
+
- 架构的关键优势
|
|
411
|
+
- 项目类型 (全栈/前端/后端) 和评估的部分
|
|
412
|
+
|
|
413
|
+
2. 部分分析
|
|
414
|
+
- 每个主要部分的通过率 (通过项目百分比)
|
|
415
|
+
- 最令人担忧的失败或缺口
|
|
416
|
+
- 需要立即关注的部分
|
|
417
|
+
- 注意由于项目类型跳过的任何部分
|
|
418
|
+
|
|
419
|
+
3. 风险评估
|
|
420
|
+
- 按严重程度排序的前 5 个风险
|
|
421
|
+
- 每个风险的缓解建议
|
|
422
|
+
- 解决问题的 timeline 影响
|
|
423
|
+
|
|
424
|
+
4. 建议
|
|
425
|
+
- 开发前必须修复的项目
|
|
426
|
+
- 为更好质量应该修复的项目
|
|
427
|
+
- 锦上添花的改进
|
|
428
|
+
|
|
429
|
+
5. AI 实现就绪性
|
|
430
|
+
- AI 代理实现的特定关注点
|
|
431
|
+
- 需要额外澄清的领域
|
|
432
|
+
- 需要解决的复杂度热点
|
|
433
|
+
|
|
434
|
+
6. 前端特定评估 (如果适用)
|
|
435
|
+
- 前端架构完整性
|
|
436
|
+
- 主架构和前端架构文档间的一致性
|
|
437
|
+
- UI/UX 规范覆盖
|
|
438
|
+
- 组件设计清晰度
|
|
439
|
+
|
|
440
|
+
展示报告后,问用户是否想要任何特定部分的详细分析,特别是有警告或失败的部分。]]
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
<!-- Powered by BMAD™ Core -->
|
|
2
|
+
|
|
3
|
+
# Change Navigation Checklist
|
|
4
|
+
|
|
5
|
+
**目的:** 当在BMad工作流程中发现重大变更(转向、技术问题、缺失需求、失败故事)时,系统性地指导选定的代理和用户完成所需的分析和规划。
|
|
6
|
+
|
|
7
|
+
**说明:** 与用户一起审查每个项目。对已完成/确认的项目标记 `[x]`,不适用的标记 `[N/A]`,或添加讨论要点的注释。
|
|
8
|
+
|
|
9
|
+
[[LLM: 初始化说明 - CHANGE NAVIGATION
|
|
10
|
+
|
|
11
|
+
开发过程中的变更是不可避免的,但我们如何处理这些变更决定了项目的成功或失败。
|
|
12
|
+
|
|
13
|
+
在开始之前,请理解:
|
|
14
|
+
|
|
15
|
+
1. 这个 checklist 适用于影响项目方向的重大变更
|
|
16
|
+
2. 故事内部的微调不需要这个流程
|
|
17
|
+
3. 目标是在适应新现实的同时最小化浪费的工作
|
|
18
|
+
4. 用户的认同至关重要 - 他们必须理解并批准变更
|
|
19
|
+
|
|
20
|
+
所需上下文:
|
|
21
|
+
|
|
22
|
+
- 触发变更的故事或问题
|
|
23
|
+
- 当前项目状态(已完成的故事、当前史诗)
|
|
24
|
+
- 访问 PRD、架构和其他关键文档
|
|
25
|
+
- 了解剩余计划工作
|
|
26
|
+
|
|
27
|
+
方法:
|
|
28
|
+
这是一个与用户的交互过程。一起完成每个部分,讨论影响和选项。用户做最终决定,但提供技术可行性和影响的专家指导。
|
|
29
|
+
|
|
30
|
+
记住:变更是改进的机会,不是失败。专业和建设性地处理它们。]]
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 1. 理解触发因素和上下文
|
|
35
|
+
|
|
36
|
+
[[LLM: 首先充分理解出了什么问题以及原因。不要急于跳到解决方案。提出探索性问题:
|
|
37
|
+
|
|
38
|
+
- 到底是什么触发了这次审查?
|
|
39
|
+
- 这是偶发问题还是系统性问题的表现?
|
|
40
|
+
- 这个问题能否更早被预见?
|
|
41
|
+
- 哪些假设是错误的?
|
|
42
|
+
|
|
43
|
+
要具体和客观,不要带有责备倾向。]]
|
|
44
|
+
|
|
45
|
+
- [ ] **识别触发故事:** 明确识别暴露问题的故事(或多个故事)。
|
|
46
|
+
- [ ] **定义问题:** 准确阐述核心问题。
|
|
47
|
+
- [ ] 这是技术限制/死胡同吗?
|
|
48
|
+
- [ ] 这是新发现的需求吗?
|
|
49
|
+
- [ ] 这是对现有需求的根本误解吗?
|
|
50
|
+
- [ ] 这是基于反馈或新信息的必要转向吗?
|
|
51
|
+
- [ ] 这是需要新方法的失败/废弃故事吗?
|
|
52
|
+
- [ ] **评估初始影响:** 描述立即观察到的后果(例如,进度受阻、功能错误、技术不可行)。
|
|
53
|
+
- [ ] **收集证据:** 记录支持问题定义的具体日志、错误消息、用户反馈或分析。
|
|
54
|
+
|
|
55
|
+
## 2. 史诗影响评估
|
|
56
|
+
|
|
57
|
+
[[LLM: 变更会在项目结构中产生连锁反应。系统性地评估:
|
|
58
|
+
|
|
59
|
+
1. 我们能否通过修改来挽救当前的史诗?
|
|
60
|
+
2. 考虑到这个变更,未来的史诗是否还有意义?
|
|
61
|
+
3. 我们是在创建还是消除依赖关系?
|
|
62
|
+
4. 史诗序列是否需要重新排序?
|
|
63
|
+
|
|
64
|
+
考虑即时和下游的影响。]]
|
|
65
|
+
|
|
66
|
+
- [ ] **分析当前史诗:**
|
|
67
|
+
- [ ] 包含触发故事的当前史诗还能完成吗?
|
|
68
|
+
- [ ] 当前史诗需要修改吗(故事变更、添加、删除)?
|
|
69
|
+
- [ ] 当前史诗应该被放弃还是从根本上重新定义?
|
|
70
|
+
- [ ] **分析未来史诗:**
|
|
71
|
+
- [ ] 审查所有剩余的规划史诗。
|
|
72
|
+
- [ ] 这个问题需要对未来史诗中的规划故事进行变更吗?
|
|
73
|
+
- [ ] 这个问题会使任何未来史诗失效吗?
|
|
74
|
+
- [ ] 这个问题是否需要创建全新的史诗?
|
|
75
|
+
- [ ] 未来史诗的顺序/优先级应该改变吗?
|
|
76
|
+
- [ ] **总结史诗影响:** 简要记录对项目史诗结构和流程的整体影响。
|
|
77
|
+
|
|
78
|
+
## 3. 文档冲突和影响分析
|
|
79
|
+
|
|
80
|
+
[[LLM: 文档驱动BMad中的开发。检查每个工件:
|
|
81
|
+
|
|
82
|
+
1. 这个变更是否使已记录的决定失效?
|
|
83
|
+
2. 架构假设仍然有效吗?
|
|
84
|
+
3. 用户流程需要重新思考吗?
|
|
85
|
+
4. 技术约束与文档记录的不同吗?
|
|
86
|
+
|
|
87
|
+
要彻底 - 遗漏的冲突会导致未来的问题。]]
|
|
88
|
+
|
|
89
|
+
- [ ] **审查PRD:**
|
|
90
|
+
- [ ] 这个问题是否与PRD中声明的核心目标或需求冲突?
|
|
91
|
+
- [ ] 基于新的理解,PRD需要澄清或更新吗?
|
|
92
|
+
- [ ] **审查架构文档:**
|
|
93
|
+
- [ ] 这个问题是否与已记录的架构冲突(组件、模式、技术选择)?
|
|
94
|
+
- [ ] 特定的组件/图表/部分是否受到影响?
|
|
95
|
+
- [ ] 技术列表需要更新吗?
|
|
96
|
+
- [ ] 数据模型或模式需要修订吗?
|
|
97
|
+
- [ ] 外部API集成是否受到影响?
|
|
98
|
+
- [ ] **审查前端规范(如适用):**
|
|
99
|
+
- [ ] 这个问题是否与前端架构、组件库选择或UI/UX设计冲突?
|
|
100
|
+
- [ ] 特定的前端组件或用户流程是否受到影响?
|
|
101
|
+
- [ ] **审查其他工件(如适用):**
|
|
102
|
+
- [ ] 考虑对部署脚本、IaC、监控设置等的影响。
|
|
103
|
+
- [ ] **总结工件影响:** 列出所有需要更新的工件和所需变更的性质。
|
|
104
|
+
|
|
105
|
+
## 4. 前进路径评估
|
|
106
|
+
|
|
107
|
+
[[LLM: 清晰地呈现选项的优缺点。对于每条路径:
|
|
108
|
+
|
|
109
|
+
1. 需要多少工作量?
|
|
110
|
+
2. 哪些工作会被浪费?
|
|
111
|
+
3. 我们要承担什么风险?
|
|
112
|
+
4. 这如何影响时间线?
|
|
113
|
+
5. 长期来看是否可持续?
|
|
114
|
+
|
|
115
|
+
要诚实地面对权衡。很少有完美的解决方案。]]
|
|
116
|
+
|
|
117
|
+
- [ ] **选项1:直接调整/集成:**
|
|
118
|
+
- [ ] 能否通过修改或添加现有计划中的后续故事来解决这个问题?
|
|
119
|
+
- [ ] 明确这些调整的范围和具体内容。
|
|
120
|
+
- [ ] 评估这个方案的可行性、工作量和风险。
|
|
121
|
+
- [ ] **选项2:撤销已完成的工作:**
|
|
122
|
+
- [ ] 撤销已完成的工作是否能大大简化问题的解决?
|
|
123
|
+
- [ ] 确定需要撤销的具体工作内容和代码提交。
|
|
124
|
+
- [ ] 评估撤销工作所需的工作量。
|
|
125
|
+
- [ ] 评估撤销的影响(浪费的工作量、对数据的影响)。
|
|
126
|
+
- [ ] 对比直接调整方案,看哪个更划算。
|
|
127
|
+
- [ ] **选项3:PRD MVP审查和重新规划:**
|
|
128
|
+
- [ ] 考虑到这个问题和限制条件,原来的PRD MVP还能实现吗?
|
|
129
|
+
- [ ] MVP的范围是否需要缩小(删除功能/史诗)?
|
|
130
|
+
- [ ] 核心MVP目标是否需要修改?
|
|
131
|
+
- [ ] 是否需要其他方法来实现原始MVP的目标?
|
|
132
|
+
- [ ] **极端情况:** 这个问题是否需要彻底重新规划,或者可能需要写新的PRD V2(由PM处理)?
|
|
133
|
+
- [ ] **选择推荐方案:** 基于评估结果,确定最可行的解决方案。
|
|
134
|
+
|
|
135
|
+
## 5. Sprint 变更提案组件
|
|
136
|
+
|
|
137
|
+
[[LLM: 提案必须可操作且清晰。确保:
|
|
138
|
+
|
|
139
|
+
1. 用通俗易懂的语言解释问题
|
|
140
|
+
2. 尽可能量化影响
|
|
141
|
+
3. 推荐方案有明确的理由
|
|
142
|
+
4. 下一步具体且分配到人
|
|
143
|
+
5. 定义变更的成功标准
|
|
144
|
+
|
|
145
|
+
这个提案将指导所有后续工作。]]
|
|
146
|
+
|
|
147
|
+
(确保提案中包含前面章节中所有达成一致的内容)
|
|
148
|
+
|
|
149
|
+
- [ ] **问题总结:** 用简单明了的话说清楚问题是什么。
|
|
150
|
+
- [ ] **史诗影响总结:** 说明哪些史诗会受到影响。
|
|
151
|
+
- [ ] **文档更新需求:** 列出需要修改的文档。
|
|
152
|
+
- [ ] **推荐方案:** 选择的解决方案和选择理由。
|
|
153
|
+
- [ ] **PRD MVP影响:** 如果有范围或目标的变更,要说明。
|
|
154
|
+
- [ ] **行动计划:** 后续故事和更新的具体步骤。
|
|
155
|
+
- [ ] **人员交接计划:** 确定需要哪些角色参与(PM、Arch、Design Arch、PO)。
|
|
156
|
+
|
|
157
|
+
## 6. 最终审查和交接
|
|
158
|
+
|
|
159
|
+
[[LLM: 变更需要协调配合。在结束前确认:
|
|
160
|
+
|
|
161
|
+
1. 用户是否完全同意这个计划?
|
|
162
|
+
2. 所有相关方是否都了解影响?
|
|
163
|
+
3. 与其他代理的交接是否清楚?
|
|
164
|
+
4. 如果变更失败,是否有回退计划?
|
|
165
|
+
5. 如何验证变更是否成功?
|
|
166
|
+
|
|
167
|
+
要获得明确批准 - 默许同意会带来问题。
|
|
168
|
+
|
|
169
|
+
最终报告:
|
|
170
|
+
完成checklist后,提供简洁的总结:
|
|
171
|
+
|
|
172
|
+
- 什么变了,为什么变
|
|
173
|
+
- 我们要怎么处理
|
|
174
|
+
- 谁需要做什么
|
|
175
|
+
- 什么时候能知道是否成功
|
|
176
|
+
|
|
177
|
+
保持行动导向和前瞻性。]]
|
|
178
|
+
|
|
179
|
+
- [ ] **检查清单:** 确认所有相关项目都已讨论过。
|
|
180
|
+
- [ ] **检查Sprint变更提案:** 确保提案准确反映了讨论和决定。
|
|
181
|
+
- [ ] **用户确认:** 获得用户对提案的明确同意。
|
|
182
|
+
- [ ] **确认后续安排:** 重申交接计划和相关人员要做的具体工作。
|
|
183
|
+
|
|
184
|
+
---
|