@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.
Files changed (109) hide show
  1. package/.knowledge/.ext/.bmad-core/agent-teams/team-all.yaml +15 -0
  2. package/.knowledge/.ext/.bmad-core/agent-teams/team-fullstack.yaml +19 -0
  3. package/.knowledge/.ext/.bmad-core/agent-teams/team-ide-minimal.yaml +11 -0
  4. package/.knowledge/.ext/.bmad-core/agent-teams/team-no-ui.yaml +14 -0
  5. package/.knowledge/.ext/.bmad-core/agents/analyst.md +84 -0
  6. package/.knowledge/.ext/.bmad-core/agents/architect.md +85 -0
  7. package/.knowledge/.ext/.bmad-core/agents/bmad-master.md +110 -0
  8. package/.knowledge/.ext/.bmad-core/agents/bmad-orchestrator.md +147 -0
  9. package/.knowledge/.ext/.bmad-core/agents/dev.md +81 -0
  10. package/.knowledge/.ext/.bmad-core/agents/pm.md +84 -0
  11. package/.knowledge/.ext/.bmad-core/agents/po.md +79 -0
  12. package/.knowledge/.ext/.bmad-core/agents/qa.md +90 -0
  13. package/.knowledge/.ext/.bmad-core/agents/ra.md +74 -0
  14. package/.knowledge/.ext/.bmad-core/agents/sm.md +65 -0
  15. package/.knowledge/.ext/.bmad-core/agents/ux-expert.md +69 -0
  16. package/.knowledge/.ext/.bmad-core/checklists/architect-checklist.md +440 -0
  17. package/.knowledge/.ext/.bmad-core/checklists/change-checklist.md +184 -0
  18. package/.knowledge/.ext/.bmad-core/checklists/pm-checklist.md +372 -0
  19. package/.knowledge/.ext/.bmad-core/checklists/po-master-checklist.md +434 -0
  20. package/.knowledge/.ext/.bmad-core/checklists/story-dod-checklist.md +96 -0
  21. package/.knowledge/.ext/.bmad-core/checklists/story-draft-checklist.md +155 -0
  22. package/.knowledge/.ext/.bmad-core/checklists/trd-checklist.md +226 -0
  23. package/.knowledge/.ext/.bmad-core/core-config.yaml +22 -0
  24. package/.knowledge/.ext/.bmad-core/data/bmad-kb.md +809 -0
  25. package/.knowledge/.ext/.bmad-core/data/brainstorming-techniques.md +38 -0
  26. package/.knowledge/.ext/.bmad-core/data/elicitation-methods.md +156 -0
  27. package/.knowledge/.ext/.bmad-core/data/technical-preferences.md +5 -0
  28. package/.knowledge/.ext/.bmad-core/data/test-levels-framework.md +148 -0
  29. package/.knowledge/.ext/.bmad-core/data/test-priorities-matrix.md +174 -0
  30. package/.knowledge/.ext/.bmad-core/enhanced-ide-development-workflow.md +248 -0
  31. package/.knowledge/.ext/.bmad-core/install-manifest.yaml +512 -0
  32. package/.knowledge/.ext/.bmad-core/tasks/advanced-elicitation.md +119 -0
  33. package/.knowledge/.ext/.bmad-core/tasks/analyze-prd.md +123 -0
  34. package/.knowledge/.ext/.bmad-core/tasks/apply-qa-fixes.md +150 -0
  35. package/.knowledge/.ext/.bmad-core/tasks/brownfield-create-epic.md +162 -0
  36. package/.knowledge/.ext/.bmad-core/tasks/brownfield-create-story.md +149 -0
  37. package/.knowledge/.ext/.bmad-core/tasks/correct-course.md +72 -0
  38. package/.knowledge/.ext/.bmad-core/tasks/create-brownfield-story.md +314 -0
  39. package/.knowledge/.ext/.bmad-core/tasks/create-deep-research-prompt.md +280 -0
  40. package/.knowledge/.ext/.bmad-core/tasks/create-doc.md +103 -0
  41. package/.knowledge/.ext/.bmad-core/tasks/create-next-story.md +114 -0
  42. package/.knowledge/.ext/.bmad-core/tasks/document-project.md +345 -0
  43. package/.knowledge/.ext/.bmad-core/tasks/execute-checklist.md +88 -0
  44. package/.knowledge/.ext/.bmad-core/tasks/facilitate-brainstorming-session.md +138 -0
  45. package/.knowledge/.ext/.bmad-core/tasks/generate-ai-frontend-prompt.md +53 -0
  46. package/.knowledge/.ext/.bmad-core/tasks/index-docs.md +175 -0
  47. package/.knowledge/.ext/.bmad-core/tasks/kb-mode-interaction.md +77 -0
  48. package/.knowledge/.ext/.bmad-core/tasks/nfr-assess.md +345 -0
  49. package/.knowledge/.ext/.bmad-core/tasks/qa-gate.md +163 -0
  50. package/.knowledge/.ext/.bmad-core/tasks/review-story.md +316 -0
  51. package/.knowledge/.ext/.bmad-core/tasks/risk-profile.md +355 -0
  52. package/.knowledge/.ext/.bmad-core/tasks/shard-doc.md +187 -0
  53. package/.knowledge/.ext/.bmad-core/tasks/test-design.md +176 -0
  54. package/.knowledge/.ext/.bmad-core/tasks/trace-requirements.md +266 -0
  55. package/.knowledge/.ext/.bmad-core/tasks/validate-next-story.md +136 -0
  56. package/.knowledge/.ext/.bmad-core/tasks/validate-trd.md +158 -0
  57. package/.knowledge/.ext/.bmad-core/templates/architecture-tmpl.yaml +651 -0
  58. package/.knowledge/.ext/.bmad-core/templates/brainstorming-output-tmpl.yaml +156 -0
  59. package/.knowledge/.ext/.bmad-core/templates/brownfield-architecture-tmpl.yaml +478 -0
  60. package/.knowledge/.ext/.bmad-core/templates/brownfield-prd-tmpl.yaml +281 -0
  61. package/.knowledge/.ext/.bmad-core/templates/competitor-analysis-tmpl.yaml +349 -0
  62. package/.knowledge/.ext/.bmad-core/templates/front-end-architecture-tmpl.yaml +273 -0
  63. package/.knowledge/.ext/.bmad-core/templates/front-end-spec-tmpl.yaml +360 -0
  64. package/.knowledge/.ext/.bmad-core/templates/fullstack-architecture-tmpl.yaml +947 -0
  65. package/.knowledge/.ext/.bmad-core/templates/market-research-tmpl.yaml +253 -0
  66. package/.knowledge/.ext/.bmad-core/templates/prd-tmpl.yaml +203 -0
  67. package/.knowledge/.ext/.bmad-core/templates/project-brief-tmpl.yaml +222 -0
  68. package/.knowledge/.ext/.bmad-core/templates/qa-gate-tmpl.yaml +103 -0
  69. package/.knowledge/.ext/.bmad-core/templates/story-tmpl.yaml +138 -0
  70. package/.knowledge/.ext/.bmad-core/templates/trd-tmpl.yaml +198 -0
  71. package/.knowledge/.ext/.bmad-core/user-guide.md +530 -0
  72. package/.knowledge/.ext/.bmad-core/utils/bmad-doc-template.md +327 -0
  73. package/.knowledge/.ext/.bmad-core/utils/workflow-management.md +71 -0
  74. package/.knowledge/.ext/.bmad-core/workflows/brownfield-fullstack.yaml +298 -0
  75. package/.knowledge/.ext/.bmad-core/workflows/brownfield-service.yaml +188 -0
  76. package/.knowledge/.ext/.bmad-core/workflows/brownfield-ui.yaml +198 -0
  77. package/.knowledge/.ext/.bmad-core/workflows/greenfield-fullstack.yaml +241 -0
  78. package/.knowledge/.ext/.bmad-core/workflows/greenfield-service.yaml +207 -0
  79. package/.knowledge/.ext/.bmad-core/workflows/greenfield-ui.yaml +236 -0
  80. package/.knowledge/.ext/.bmad-core/working-in-the-brownfield.md +606 -0
  81. package/.knowledge/.ext/coding/ddd-architecture.md +223 -0
  82. package/.knowledge/.ext/coding/java-standards.md +308 -0
  83. package/.knowledge/.ext/coding/mybatis-standards.md +407 -0
  84. package/.knowledge/.ext/coding/sql-standards.md +263 -0
  85. package/.knowledge/.ext/coding/thrift-service.md +292 -0
  86. package/.knowledge/BMAD.md +255 -0
  87. package/.knowledge/coding.md +135 -0
  88. package/dist/package.json +4 -3
  89. package/dist/src/config/extension.js.map +1 -1
  90. package/dist/src/generated/git-commit.d.ts +2 -2
  91. package/dist/src/generated/git-commit.js +2 -2
  92. package/dist/src/generated/git-commit.js.map +1 -1
  93. package/dist/src/services/McpPromptLoader.js +1 -1
  94. package/dist/src/services/McpPromptLoader.js.map +1 -1
  95. package/dist/src/services/prompt-processors/atFileProcessor.js +1 -1
  96. package/dist/src/services/prompt-processors/atFileProcessor.js.map +1 -1
  97. package/dist/src/ui/commands/mcpCommand.js.map +1 -1
  98. package/dist/src/ui/components/ContextSummaryDisplay.js.map +1 -1
  99. package/dist/src/ui/components/Tips.js +1 -1
  100. package/dist/src/ui/components/Tips.js.map +1 -1
  101. package/dist/src/ui/components/messages/ToolConfirmationMessage.test.js.map +1 -1
  102. package/dist/src/ui/components/messages/ToolGroupMessage.test.js.map +1 -1
  103. package/dist/src/ui/components/subagents/create/CreationSummary.js.map +1 -1
  104. package/dist/src/ui/hooks/shellCommandProcessor.test.js.map +1 -1
  105. package/dist/src/ui/hooks/usePhraseCycler.js +2 -2
  106. package/dist/src/ui/hooks/usePhraseCycler.js.map +1 -1
  107. package/dist/src/utils/installationInfo.test.js.map +1 -1
  108. package/dist/tsconfig.tsbuildinfo +1 -1
  109. 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
+ ---