@techierathore/techieflow 1.0.0

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 (151) hide show
  1. package/.claude/commands/TechieFlow/agents/analyst.md +97 -0
  2. package/.claude/commands/TechieFlow/agents/architect.md +84 -0
  3. package/.claude/commands/TechieFlow/agents/flow-master.md +217 -0
  4. package/.claude/commands/TechieFlow/agents/verifier.md +72 -0
  5. package/.claude/commands/TechieFlow/tasks/_metrics-emit-gate.md +138 -0
  6. package/.claude/commands/TechieFlow/tasks/_smoke-test-policy.md +98 -0
  7. package/.claude/commands/TechieFlow/tasks/_status-update-gate.md +78 -0
  8. package/.claude/commands/TechieFlow/tasks/_yolo-mode.md +77 -0
  9. package/.claude/commands/TechieFlow/tasks/advanced-elicitation.md +117 -0
  10. package/.claude/commands/TechieFlow/tasks/amend-docs.md +149 -0
  11. package/.claude/commands/TechieFlow/tasks/author-brd.md +79 -0
  12. package/.claude/commands/TechieFlow/tasks/build-phase.md +231 -0
  13. package/.claude/commands/TechieFlow/tasks/create-deep-research-prompt.md +278 -0
  14. package/.claude/commands/TechieFlow/tasks/create-doc.md +101 -0
  15. package/.claude/commands/TechieFlow/tasks/day1-brownfield.md +507 -0
  16. package/.claude/commands/TechieFlow/tasks/day1-greenfield.md +224 -0
  17. package/.claude/commands/TechieFlow/tasks/devguide.md +224 -0
  18. package/.claude/commands/TechieFlow/tasks/document-project.md +343 -0
  19. package/.claude/commands/TechieFlow/tasks/execute-checklist.md +86 -0
  20. package/.claude/commands/TechieFlow/tasks/facilitate-brainstorming-session.md +136 -0
  21. package/.claude/commands/TechieFlow/tasks/fix-issues.md +134 -0
  22. package/.claude/commands/TechieFlow/tasks/generate-html.md +115 -0
  23. package/.claude/commands/TechieFlow/tasks/handoff-phase.md +126 -0
  24. package/.claude/commands/TechieFlow/tasks/index-docs.md +173 -0
  25. package/.claude/commands/TechieFlow/tasks/kb-mode-interaction.md +75 -0
  26. package/.claude/commands/TechieFlow/tasks/log-miss.md +160 -0
  27. package/.claude/commands/TechieFlow/tasks/metrics-report.md +143 -0
  28. package/.claude/commands/TechieFlow/tasks/mockups.md +122 -0
  29. package/.claude/commands/TechieFlow/tasks/productguide.md +105 -0
  30. package/.claude/commands/TechieFlow/tasks/refresh-status.md +135 -0
  31. package/.claude/commands/TechieFlow/tasks/render-workflow-docs.md +117 -0
  32. package/.claude/commands/TechieFlow/tasks/shard-doc.md +185 -0
  33. package/.claude/commands/TechieFlow/tasks/split-brd.md +131 -0
  34. package/.claude/commands/TechieFlow/tasks/triage-issues.md +157 -0
  35. package/.claude/commands/TechieFlow/tasks/verify-phase.md +579 -0
  36. package/.claude/commands/generate-html.md +124 -0
  37. package/.codex/config.toml +46 -0
  38. package/.codex/hooks.json +63 -0
  39. package/.codex/rules/techieflow.rules +8 -0
  40. package/.opencode/command/generate-html.md +129 -0
  41. package/.opencode/plugin/techieflow.js +350 -0
  42. package/.tfcore/TOKEN-GUIDE.md +59 -0
  43. package/.tfcore/agents/analyst.md +97 -0
  44. package/.tfcore/agents/architect.md +84 -0
  45. package/.tfcore/agents/flow-master.md +217 -0
  46. package/.tfcore/agents/verifier.md +72 -0
  47. package/.tfcore/checklists/architect-checklist.md +438 -0
  48. package/.tfcore/core-config.yaml +47 -0
  49. package/.tfcore/data/brainstorming-techniques.md +36 -0
  50. package/.tfcore/data/elicitation-methods.md +154 -0
  51. package/.tfcore/data/techieflow-kb.md +807 -0
  52. package/.tfcore/data/technical-preferences.md +3 -0
  53. package/.tfcore/enhanced-ide-development-workflow.md +248 -0
  54. package/.tfcore/hooks/block-git.sh +301 -0
  55. package/.tfcore/hooks/codex-adapter.py +248 -0
  56. package/.tfcore/hooks/guard-artifacts.sh +101 -0
  57. package/.tfcore/hooks/guard-status-html.sh +102 -0
  58. package/.tfcore/hooks/guard-status.sh +124 -0
  59. package/.tfcore/hooks/guard-verify.sh +108 -0
  60. package/.tfcore/hooks/metrics-session.sh +129 -0
  61. package/.tfcore/hooks/session-pointer.sh +52 -0
  62. package/.tfcore/hooks/sweep-artifacts.sh +198 -0
  63. package/.tfcore/install-manifest.yaml +231 -0
  64. package/.tfcore/routing.yaml +105 -0
  65. package/.tfcore/tasks/_metrics-emit-gate.md +138 -0
  66. package/.tfcore/tasks/_smoke-test-policy.md +98 -0
  67. package/.tfcore/tasks/_status-update-gate.md +78 -0
  68. package/.tfcore/tasks/_yolo-mode.md +77 -0
  69. package/.tfcore/tasks/advanced-elicitation.md +117 -0
  70. package/.tfcore/tasks/amend-docs.md +149 -0
  71. package/.tfcore/tasks/author-brd.md +79 -0
  72. package/.tfcore/tasks/build-phase.md +231 -0
  73. package/.tfcore/tasks/create-deep-research-prompt.md +278 -0
  74. package/.tfcore/tasks/create-doc.md +101 -0
  75. package/.tfcore/tasks/day1-brownfield.md +507 -0
  76. package/.tfcore/tasks/day1-greenfield.md +224 -0
  77. package/.tfcore/tasks/devguide.md +224 -0
  78. package/.tfcore/tasks/document-project.md +343 -0
  79. package/.tfcore/tasks/execute-checklist.md +86 -0
  80. package/.tfcore/tasks/facilitate-brainstorming-session.md +136 -0
  81. package/.tfcore/tasks/fix-issues.md +134 -0
  82. package/.tfcore/tasks/generate-html.md +115 -0
  83. package/.tfcore/tasks/handoff-phase.md +126 -0
  84. package/.tfcore/tasks/index-docs.md +173 -0
  85. package/.tfcore/tasks/kb-mode-interaction.md +75 -0
  86. package/.tfcore/tasks/log-miss.md +160 -0
  87. package/.tfcore/tasks/metrics-report.md +143 -0
  88. package/.tfcore/tasks/mockups.md +122 -0
  89. package/.tfcore/tasks/productguide.md +105 -0
  90. package/.tfcore/tasks/refresh-status.md +135 -0
  91. package/.tfcore/tasks/render-workflow-docs.md +117 -0
  92. package/.tfcore/tasks/shard-doc.md +185 -0
  93. package/.tfcore/tasks/split-brd.md +131 -0
  94. package/.tfcore/tasks/triage-issues.md +157 -0
  95. package/.tfcore/tasks/verify-phase.md +579 -0
  96. package/.tfcore/telemetry/SCHEMA.md +678 -0
  97. package/.tfcore/telemetry/install-metrics.sh +390 -0
  98. package/.tfcore/telemetry/pre-commit +94 -0
  99. package/.tfcore/telemetry/tf-metrics.sh +1415 -0
  100. package/.tfcore/templates/architecture-tmpl.yaml +650 -0
  101. package/.tfcore/templates/brainstorming-output-tmpl.yaml +156 -0
  102. package/.tfcore/templates/brownfield-architecture-tmpl.yaml +476 -0
  103. package/.tfcore/templates/competitor-analysis-tmpl.yaml +306 -0
  104. package/.tfcore/templates/front-end-architecture-tmpl.yaml +218 -0
  105. package/.tfcore/templates/fullstack-architecture-tmpl.yaml +823 -0
  106. package/.tfcore/templates/market-research-tmpl.yaml +252 -0
  107. package/.tfcore/templates/project-brief-tmpl.yaml +221 -0
  108. package/.tfcore/templates/v4custom/app-agents-md-tmpl.md +61 -0
  109. package/.tfcore/templates/v4custom/app-architecture-tmpl.md +127 -0
  110. package/.tfcore/templates/v4custom/app-brd-tmpl.md +204 -0
  111. package/.tfcore/templates/v4custom/app-checklist-tmpl.md +90 -0
  112. package/.tfcore/templates/v4custom/app-claude-md-tmpl.md +33 -0
  113. package/.tfcore/templates/v4custom/app-devguide-tmpl.md +167 -0
  114. package/.tfcore/templates/v4custom/app-editorconfig-tmpl.editorconfig +44 -0
  115. package/.tfcore/templates/v4custom/app-library-feedback-tmpl.md +31 -0
  116. package/.tfcore/templates/v4custom/app-productguide-tmpl.md +54 -0
  117. package/.tfcore/templates/v4custom/app-project-status-tmpl.md +98 -0
  118. package/.tfcore/templates/v4custom/app-uidesign-tmpl.md +48 -0
  119. package/.tfcore/templates/v4custom/app-usageguide-tmpl.md +67 -0
  120. package/.tfcore/templates/v4custom/build-invocation-ladder.md +190 -0
  121. package/.tfcore/templates/v4custom/html-render-shell.md +502 -0
  122. package/.tfcore/templates/v4custom/metrics-report-template.md +273 -0
  123. package/.tfcore/templates/v4custom/opencode-operating-contract.md +56 -0
  124. package/.tfcore/user-guide.md +633 -0
  125. package/.tfcore/utils/techieflow-doc-template.md +325 -0
  126. package/.tfcore/utils/tf-assets.sh +310 -0
  127. package/.tfcore/utils/tf-codex-bind.py +196 -0
  128. package/.tfcore/utils/tf-codex-telemetry.py +60 -0
  129. package/.tfcore/utils/tf-emit.sh +1075 -0
  130. package/.tfcore/utils/tf-gitignore-audit.sh +281 -0
  131. package/.tfcore/utils/tf-goal.sh +421 -0
  132. package/.tfcore/utils/tf-harness.sh +160 -0
  133. package/.tfcore/utils/tf-mockup-parity.mjs +555 -0
  134. package/.tfcore/utils/tf-mockup-parity.sh +65 -0
  135. package/.tfcore/utils/tf-opencode-audit.py +126 -0
  136. package/.tfcore/utils/tf-perf.sh +241 -0
  137. package/.tfcore/utils/tf-render-html.py +715 -0
  138. package/.tfcore/utils/tf-render-html.sh +28 -0
  139. package/.tfcore/utils/tf-routing-bind.sh +216 -0
  140. package/.tfcore/utils/tf-routing.sh +247 -0
  141. package/.tfcore/utils/tf-yolo.sh +119 -0
  142. package/.tfcore/working-in-the-brownfield.md +606 -0
  143. package/LICENSE +201 -0
  144. package/README.md +1212 -0
  145. package/WORKFLOW.html +1986 -0
  146. package/docs/TechieFlow-Installation.md +299 -0
  147. package/opencode.jsonc +929 -0
  148. package/package.json +60 -0
  149. package/scripts/install.mjs +992 -0
  150. package/scripts/test-install.mjs +505 -0
  151. package/scripts/validate.mjs +155 -0
@@ -0,0 +1,438 @@
1
+ # Architect Solution Validation Checklist
2
+
3
+ This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
4
+
5
+ [[LLM: INITIALIZATION INSTRUCTIONS - REQUIRED ARTIFACTS
6
+
7
+ Before proceeding with this checklist, ensure you have access to:
8
+
9
+ 1. architecture.md - The primary architecture document (check docs/architecture.md)
10
+ 2. prd.md - Product Requirements Document for requirements alignment (check docs/prd.md)
11
+ 3. frontend-architecture.md or fe-architecture.md - If this is a UI project (check docs/frontend-architecture.md)
12
+ 4. Any system diagrams referenced in the architecture
13
+ 5. API documentation if available
14
+ 6. Technology stack details and version specifications
15
+
16
+ IMPORTANT: If any required documents are missing or inaccessible, immediately ask the user for their location or content before proceeding.
17
+
18
+ PROJECT TYPE DETECTION:
19
+ First, determine the project type by checking:
20
+
21
+ - Does the architecture include a frontend/UI component?
22
+ - Is there a frontend-architecture.md document?
23
+ - Does the PRD mention user interfaces or frontend requirements?
24
+
25
+ If this is a backend-only or service-only project:
26
+
27
+ - Skip sections marked with [[FRONTEND ONLY]]
28
+ - Focus extra attention on API design, service architecture, and integration patterns
29
+ - Note in your final report that frontend sections were skipped due to project type
30
+
31
+ VALIDATION APPROACH:
32
+ For each section, you must:
33
+
34
+ 1. Deep Analysis - Don't just check boxes, thoroughly analyze each item against the provided documentation
35
+ 2. Evidence-Based - Cite specific sections or quotes from the documents when validating
36
+ 3. Critical Thinking - Question assumptions and identify gaps, not just confirm what's present
37
+ 4. Risk Assessment - Consider what could go wrong with each architectural decision
38
+
39
+ EXECUTION MODE:
40
+ Ask the user if they want to work through the checklist:
41
+
42
+ - Section by section (interactive mode) - Review each section, present findings, get confirmation before proceeding
43
+ - All at once (comprehensive mode) - Complete full analysis and present comprehensive report at end]]
44
+
45
+ ## 1. REQUIREMENTS ALIGNMENT
46
+
47
+ [[LLM: Before evaluating this section, take a moment to fully understand the product's purpose and goals from the PRD. What is the core problem being solved? Who are the users? What are the critical success factors? Keep these in mind as you validate alignment. For each item, don't just check if it's mentioned - verify that the architecture provides a concrete technical solution.]]
48
+
49
+ ### 1.1 Functional Requirements Coverage
50
+
51
+ - [ ] Architecture supports all functional requirements in the PRD
52
+ - [ ] Technical approaches for all epics and stories are addressed
53
+ - [ ] Edge cases and performance scenarios are considered
54
+ - [ ] All required integrations are accounted for
55
+ - [ ] User journeys are supported by the technical architecture
56
+
57
+ ### 1.2 Non-Functional Requirements Alignment
58
+
59
+ - [ ] Performance requirements are addressed with specific solutions
60
+ - [ ] Scalability considerations are documented with approach
61
+ - [ ] Security requirements have corresponding technical controls
62
+ - [ ] Reliability and resilience approaches are defined
63
+ - [ ] Compliance requirements have technical implementations
64
+
65
+ ### 1.3 Technical Constraints Adherence
66
+
67
+ - [ ] All technical constraints from PRD are satisfied
68
+ - [ ] Platform/language requirements are followed
69
+ - [ ] Infrastructure constraints are accommodated
70
+ - [ ] Third-party service constraints are addressed
71
+ - [ ] Organizational technical standards are followed
72
+
73
+ ## 2. ARCHITECTURE FUNDAMENTALS
74
+
75
+ [[LLM: Architecture clarity is crucial for successful implementation. As you review this section, visualize the system as if you were explaining it to a new developer. Are there any ambiguities that could lead to misinterpretation? Would an AI agent be able to implement this architecture without confusion? Look for specific diagrams, component definitions, and clear interaction patterns.]]
76
+
77
+ ### 2.1 Architecture Clarity
78
+
79
+ - [ ] Architecture is documented with clear diagrams
80
+ - [ ] Major components and their responsibilities are defined
81
+ - [ ] Component interactions and dependencies are mapped
82
+ - [ ] Data flows are clearly illustrated
83
+ - [ ] Technology choices for each component are specified
84
+
85
+ ### 2.2 Separation of Concerns
86
+
87
+ - [ ] Clear boundaries between UI, business logic, and data layers
88
+ - [ ] Responsibilities are cleanly divided between components
89
+ - [ ] Interfaces between components are well-defined
90
+ - [ ] Components adhere to single responsibility principle
91
+ - [ ] Cross-cutting concerns (logging, auth, etc.) are properly addressed
92
+
93
+ ### 2.3 Design Patterns & Best Practices
94
+
95
+ - [ ] Appropriate design patterns are employed
96
+ - [ ] Industry best practices are followed
97
+ - [ ] Anti-patterns are avoided
98
+ - [ ] Consistent architectural style throughout
99
+ - [ ] Pattern usage is documented and explained
100
+
101
+ ### 2.4 Modularity & Maintainability
102
+
103
+ - [ ] System is divided into cohesive, loosely-coupled modules
104
+ - [ ] Components can be developed and tested independently
105
+ - [ ] Changes can be localized to specific components
106
+ - [ ] Code organization promotes discoverability
107
+ - [ ] Architecture specifically designed for AI agent implementation
108
+
109
+ ## 3. TECHNICAL STACK & DECISIONS
110
+
111
+ [[LLM: Technology choices have long-term implications. For each technology decision, consider: Is this the simplest solution that could work? Are we over-engineering? Will this scale? What are the maintenance implications? Are there security vulnerabilities in the chosen versions? Verify that specific versions are defined, not ranges.]]
112
+
113
+ ### 3.1 Technology Selection
114
+
115
+ - [ ] Selected technologies meet all requirements
116
+ - [ ] Technology versions are specifically defined (not ranges)
117
+ - [ ] Technology choices are justified with clear rationale
118
+ - [ ] Alternatives considered are documented with pros/cons
119
+ - [ ] Selected stack components work well together
120
+
121
+ ### 3.2 Frontend Architecture [[FRONTEND ONLY]]
122
+
123
+ [[LLM: Skip this entire section if this is a backend-only or service-only project. Only evaluate if the project includes a user interface.]]
124
+
125
+ - [ ] UI framework and libraries are specifically selected
126
+ - [ ] State management approach is defined
127
+ - [ ] Component structure and organization is specified
128
+ - [ ] Responsive/adaptive design approach is outlined
129
+ - [ ] Build and bundling strategy is determined
130
+
131
+ ### 3.3 Backend Architecture
132
+
133
+ - [ ] API design and standards are defined
134
+ - [ ] Service organization and boundaries are clear
135
+ - [ ] Authentication and authorization approach is specified
136
+ - [ ] Error handling strategy is outlined
137
+ - [ ] Backend scaling approach is defined
138
+
139
+ ### 3.4 Data Architecture
140
+
141
+ - [ ] Data models are fully defined
142
+ - [ ] Database technologies are selected with justification
143
+ - [ ] Data access patterns are documented
144
+ - [ ] Data migration/seeding approach is specified
145
+ - [ ] Data backup and recovery strategies are outlined
146
+
147
+ ## 4. FRONTEND DESIGN & IMPLEMENTATION [[FRONTEND ONLY]]
148
+
149
+ [[LLM: This entire section should be skipped for backend-only projects. Only evaluate if the project includes a user interface. When evaluating, ensure alignment between the main architecture document and the frontend-specific architecture document.]]
150
+
151
+ ### 4.1 Frontend Philosophy & Patterns
152
+
153
+ - [ ] Framework & Core Libraries align with main architecture document
154
+ - [ ] Component Architecture (e.g., Atomic Design) is clearly described
155
+ - [ ] State Management Strategy is appropriate for application complexity
156
+ - [ ] Data Flow patterns are consistent and clear
157
+ - [ ] Styling Approach is defined and tooling specified
158
+
159
+ ### 4.2 Frontend Structure & Organization
160
+
161
+ - [ ] Directory structure is clearly documented with ASCII diagram
162
+ - [ ] Component organization follows stated patterns
163
+ - [ ] File naming conventions are explicit
164
+ - [ ] Structure supports chosen framework's best practices
165
+ - [ ] Clear guidance on where new components should be placed
166
+
167
+ ### 4.3 Component Design
168
+
169
+ - [ ] Component template/specification format is defined
170
+ - [ ] Component props, state, and events are well-documented
171
+ - [ ] Shared/foundational components are identified
172
+ - [ ] Component reusability patterns are established
173
+ - [ ] Accessibility requirements are built into component design
174
+
175
+ ### 4.4 Frontend-Backend Integration
176
+
177
+ - [ ] API interaction layer is clearly defined
178
+ - [ ] HTTP client setup and configuration documented
179
+ - [ ] Error handling for API calls is comprehensive
180
+ - [ ] Service definitions follow consistent patterns
181
+ - [ ] Authentication integration with backend is clear
182
+
183
+ ### 4.5 Routing & Navigation
184
+
185
+ - [ ] Routing strategy and library are specified
186
+ - [ ] Route definitions table is comprehensive
187
+ - [ ] Route protection mechanisms are defined
188
+ - [ ] Deep linking considerations addressed
189
+ - [ ] Navigation patterns are consistent
190
+
191
+ ### 4.6 Frontend Performance
192
+
193
+ - [ ] Image optimization strategies defined
194
+ - [ ] Code splitting approach documented
195
+ - [ ] Lazy loading patterns established
196
+ - [ ] Re-render optimization techniques specified
197
+ - [ ] Performance monitoring approach defined
198
+
199
+ ## 5. RESILIENCE & OPERATIONAL READINESS
200
+
201
+ [[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".]]
202
+
203
+ ### 5.1 Error Handling & Resilience
204
+
205
+ - [ ] Error handling strategy is comprehensive
206
+ - [ ] Retry policies are defined where appropriate
207
+ - [ ] Circuit breakers or fallbacks are specified for critical services
208
+ - [ ] Graceful degradation approaches are defined
209
+ - [ ] System can recover from partial failures
210
+
211
+ ### 5.2 Monitoring & Observability
212
+
213
+ - [ ] Logging strategy is defined
214
+ - [ ] Monitoring approach is specified
215
+ - [ ] Key metrics for system health are identified
216
+ - [ ] Alerting thresholds and strategies are outlined
217
+ - [ ] Debugging and troubleshooting capabilities are built in
218
+
219
+ ### 5.3 Performance & Scaling
220
+
221
+ - [ ] Performance bottlenecks are identified and addressed
222
+ - [ ] Caching strategy is defined where appropriate
223
+ - [ ] Load balancing approach is specified
224
+ - [ ] Horizontal and vertical scaling strategies are outlined
225
+ - [ ] Resource sizing recommendations are provided
226
+
227
+ ### 5.4 Deployment & DevOps
228
+
229
+ - [ ] Deployment strategy is defined
230
+ - [ ] CI/CD pipeline approach is outlined
231
+ - [ ] Environment strategy (dev, staging, prod) is specified
232
+ - [ ] Infrastructure as Code approach is defined
233
+ - [ ] Rollback and recovery procedures are outlined
234
+
235
+ ## 6. SECURITY & COMPLIANCE
236
+
237
+ [[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.]]
238
+
239
+ ### 6.1 Authentication & Authorization
240
+
241
+ - [ ] Authentication mechanism is clearly defined
242
+ - [ ] Authorization model is specified
243
+ - [ ] Role-based access control is outlined if required
244
+ - [ ] Session management approach is defined
245
+ - [ ] Credential management is addressed
246
+
247
+ ### 6.2 Data Security
248
+
249
+ - [ ] Data encryption approach (at rest and in transit) is specified
250
+ - [ ] Sensitive data handling procedures are defined
251
+ - [ ] Data retention and purging policies are outlined
252
+ - [ ] Backup encryption is addressed if required
253
+ - [ ] Data access audit trails are specified if required
254
+
255
+ ### 6.3 API & Service Security
256
+
257
+ - [ ] API security controls are defined
258
+ - [ ] Rate limiting and throttling approaches are specified
259
+ - [ ] Input validation strategy is outlined
260
+ - [ ] CSRF/XSS prevention measures are addressed
261
+ - [ ] Secure communication protocols are specified
262
+
263
+ ### 6.4 Infrastructure Security
264
+
265
+ - [ ] Network security design is outlined
266
+ - [ ] Firewall and security group configurations are specified
267
+ - [ ] Service isolation approach is defined
268
+ - [ ] Least privilege principle is applied
269
+ - [ ] Security monitoring strategy is outlined
270
+
271
+ ## 7. IMPLEMENTATION GUIDANCE
272
+
273
+ [[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.]]
274
+
275
+ ### 7.1 Coding Standards & Practices
276
+
277
+ - [ ] Coding standards are defined
278
+ - [ ] Documentation requirements are specified
279
+ - [ ] Testing expectations are outlined
280
+ - [ ] Code organization principles are defined
281
+ - [ ] Naming conventions are specified
282
+
283
+ ### 7.2 Testing Strategy
284
+
285
+ - [ ] Unit testing approach is defined
286
+ - [ ] Integration testing strategy is outlined
287
+ - [ ] E2E testing approach is specified
288
+ - [ ] Performance testing requirements are outlined
289
+ - [ ] Security testing approach is defined
290
+
291
+ ### 7.3 Frontend Testing [[FRONTEND ONLY]]
292
+
293
+ [[LLM: Skip this subsection for backend-only projects.]]
294
+
295
+ - [ ] Component testing scope and tools defined
296
+ - [ ] UI integration testing approach specified
297
+ - [ ] Visual regression testing considered
298
+ - [ ] Accessibility testing tools identified
299
+ - [ ] Frontend-specific test data management addressed
300
+
301
+ ### 7.4 Development Environment
302
+
303
+ - [ ] Local development environment setup is documented
304
+ - [ ] Required tools and configurations are specified
305
+ - [ ] Development workflows are outlined
306
+ - [ ] Source control practices are defined
307
+ - [ ] Dependency management approach is specified
308
+
309
+ ### 7.5 Technical Documentation
310
+
311
+ - [ ] API documentation standards are defined
312
+ - [ ] Architecture documentation requirements are specified
313
+ - [ ] Code documentation expectations are outlined
314
+ - [ ] System diagrams and visualizations are included
315
+ - [ ] Decision records for key choices are included
316
+
317
+ ## 8. DEPENDENCY & INTEGRATION MANAGEMENT
318
+
319
+ [[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.]]
320
+
321
+ ### 8.1 External Dependencies
322
+
323
+ - [ ] All external dependencies are identified
324
+ - [ ] Versioning strategy for dependencies is defined
325
+ - [ ] Fallback approaches for critical dependencies are specified
326
+ - [ ] Licensing implications are addressed
327
+ - [ ] Update and patching strategy is outlined
328
+
329
+ ### 8.2 Internal Dependencies
330
+
331
+ - [ ] Component dependencies are clearly mapped
332
+ - [ ] Build order dependencies are addressed
333
+ - [ ] Shared services and utilities are identified
334
+ - [ ] Circular dependencies are eliminated
335
+ - [ ] Versioning strategy for internal components is defined
336
+
337
+ ### 8.3 Third-Party Integrations
338
+
339
+ - [ ] All third-party integrations are identified
340
+ - [ ] Integration approaches are defined
341
+ - [ ] Authentication with third parties is addressed
342
+ - [ ] Error handling for integration failures is specified
343
+ - [ ] Rate limits and quotas are considered
344
+
345
+ ## 9. AI AGENT IMPLEMENTATION SUITABILITY
346
+
347
+ [[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.]]
348
+
349
+ ### 9.1 Modularity for AI Agents
350
+
351
+ - [ ] Components are sized appropriately for AI agent implementation
352
+ - [ ] Dependencies between components are minimized
353
+ - [ ] Clear interfaces between components are defined
354
+ - [ ] Components have singular, well-defined responsibilities
355
+ - [ ] File and code organization optimized for AI agent understanding
356
+
357
+ ### 9.2 Clarity & Predictability
358
+
359
+ - [ ] Patterns are consistent and predictable
360
+ - [ ] Complex logic is broken down into simpler steps
361
+ - [ ] Architecture avoids overly clever or obscure approaches
362
+ - [ ] Examples are provided for unfamiliar patterns
363
+ - [ ] Component responsibilities are explicit and clear
364
+
365
+ ### 9.3 Implementation Guidance
366
+
367
+ - [ ] Detailed implementation guidance is provided
368
+ - [ ] Code structure templates are defined
369
+ - [ ] Specific implementation patterns are documented
370
+ - [ ] Common pitfalls are identified with solutions
371
+ - [ ] References to similar implementations are provided when helpful
372
+
373
+ ### 9.4 Error Prevention & Handling
374
+
375
+ - [ ] Design reduces opportunities for implementation errors
376
+ - [ ] Validation and error checking approaches are defined
377
+ - [ ] Self-healing mechanisms are incorporated where possible
378
+ - [ ] Testing patterns are clearly defined
379
+ - [ ] Debugging guidance is provided
380
+
381
+ ## 10. ACCESSIBILITY IMPLEMENTATION [[FRONTEND ONLY]]
382
+
383
+ [[LLM: Skip this section for backend-only projects. Accessibility is a core requirement for any user interface.]]
384
+
385
+ ### 10.1 Accessibility Standards
386
+
387
+ - [ ] Semantic HTML usage is emphasized
388
+ - [ ] ARIA implementation guidelines provided
389
+ - [ ] Keyboard navigation requirements defined
390
+ - [ ] Focus management approach specified
391
+ - [ ] Screen reader compatibility addressed
392
+
393
+ ### 10.2 Accessibility Testing
394
+
395
+ - [ ] Accessibility testing tools identified
396
+ - [ ] Testing process integrated into workflow
397
+ - [ ] Compliance targets (WCAG level) specified
398
+ - [ ] Manual testing procedures defined
399
+ - [ ] Automated testing approach outlined
400
+
401
+ [[LLM: FINAL VALIDATION REPORT GENERATION
402
+
403
+ Now that you've completed the checklist, generate a comprehensive validation report that includes:
404
+
405
+ 1. Executive Summary
406
+ - Overall architecture readiness (High/Medium/Low)
407
+ - Critical risks identified
408
+ - Key strengths of the architecture
409
+ - Project type (Full-stack/Frontend/Backend) and sections evaluated
410
+
411
+ 2. Section Analysis
412
+ - Pass rate for each major section (percentage of items passed)
413
+ - Most concerning failures or gaps
414
+ - Sections requiring immediate attention
415
+ - Note any sections skipped due to project type
416
+
417
+ 3. Risk Assessment
418
+ - Top 5 risks by severity
419
+ - Mitigation recommendations for each
420
+ - Timeline impact of addressing issues
421
+
422
+ 4. Recommendations
423
+ - Must-fix items before development
424
+ - Should-fix items for better quality
425
+ - Nice-to-have improvements
426
+
427
+ 5. AI Implementation Readiness
428
+ - Specific concerns for AI agent implementation
429
+ - Areas needing additional clarification
430
+ - Complexity hotspots to address
431
+
432
+ 6. Frontend-Specific Assessment (if applicable)
433
+ - Frontend architecture completeness
434
+ - Alignment between main and frontend architecture docs
435
+ - UI/UX specification coverage
436
+ - Component design clarity
437
+
438
+ After presenting the report, ask the user if they would like detailed analysis of any specific section, especially those with warnings or failures.]]
@@ -0,0 +1,47 @@
1
+ markdownExploder: true
2
+ # NOTE (custom solo-dev flow): the qa/prd/devStory keys below are stock TechieFlow v4 values kept
3
+ # only for the unused stock agents (qa, sm, po, dev story flow). The custom workflow uses
4
+ # docs/{AppName}-BRD.md / docs/{AppName}-Architecture.md (set in customTechnicalDocuments by
5
+ # the day-1 tasks) and bans dated docs/qa result files — per-REQ status lives in each
6
+ # checklist's Requirements Status table.
7
+ qa:
8
+ qaLocation: docs/qa
9
+ prd:
10
+ prdFile: docs/prd.md
11
+ prdVersion: v4
12
+ prdSharded: false
13
+ prdShardedLocation: docs/prd
14
+ epicFilePattern: epic-{n}*.md
15
+ architecture:
16
+ architectureFile: docs/architecture.md
17
+ architectureVersion: v4
18
+ architectureSharded: false
19
+ architectureShardedLocation: docs/architecture
20
+ customTechnicalDocuments: null
21
+ # devLoadAlwaysFiles: the day-1 tasks rewrite this list with the project's concrete paths
22
+ # (docs/{AppName}-Coding-Standards.md + docs/{AppName}-Architecture.md). Empty until then —
23
+ # the stock paths (docs/architecture/coding-standards.md etc.) never exist in this flow.
24
+ devLoadAlwaysFiles: []
25
+ devDebugLog: .ai/debug-log.md
26
+ devStoryLocation: docs/stories
27
+ slashPrefix: TechieFlow
28
+ # artifactRetentionDays: 7 # sweep-artifacts.sh (SessionStart) deletes run material under
29
+ # # tests/.artifacts/ and .verify/ older than this; 0 disables the age sweep
30
+ # runtimeVerification: per-app, OPT-IN. Only set the heads this app actually ships.
31
+ # The verifier/devguide/smoke gates drive Blazor with headless Playwright and the MAUI
32
+ # Windows head with FlaUI/Appium-Win (unchanged). For MAUI Android / iOS / Mac Catalyst
33
+ # they drive the RUNNING UI via an Appium WebDriver endpoint and feed the SAME screenshots +
34
+ # element tree into the data-render (§4a) and visual-truth (§4b) gates. The WSL side only needs
35
+ # the HTTP url — no adb/emulator/Xcode in WSL. An absent/unreachable endpoint degrades that head
36
+ # to `⚠ STATIC-ONLY` (never a faked pass). One-time host setup: WORKFLOW.html §0b.
37
+ # runtimeVerification:
38
+ # appium:
39
+ # android:
40
+ # url: http://localhost:4723 # Win11 mirrored networking ON → localhost reaches the Windows-host Appium
41
+ # avd: Pixel_API_34 # the AVD to boot
42
+ # launch: winrun "powershell -File start-android-verify.ps1" # how the verifier boots emulator + Appium itself
43
+ # ios:
44
+ # url: http://192.168.1.50:4723 # the LAN Mac (stable IP via DHCP reservation); Appium bound to 0.0.0.0
45
+ # simulator: "iPhone 15"
46
+ # maccatalyst:
47
+ # url: http://192.168.1.50:4723 # same Mac, mac2 driver
@@ -0,0 +1,36 @@
1
+ # Brainstorming Techniques Data
2
+
3
+ ## Creative Expansion
4
+
5
+ 1. **What If Scenarios**: Ask one provocative question, get their response, then ask another
6
+ 2. **Analogical Thinking**: Give one example analogy, ask them to find 2-3 more
7
+ 3. **Reversal/Inversion**: Pose the reverse question, let them work through it
8
+ 4. **First Principles Thinking**: Ask "What are the fundamentals?" and guide them to break it down
9
+
10
+ ## Structured Frameworks
11
+
12
+ 5. **SCAMPER Method**: Go through one letter at a time, wait for their ideas before moving to next
13
+ 6. **Six Thinking Hats**: Present one hat, ask for their thoughts, then move to next hat
14
+ 7. **Mind Mapping**: Start with central concept, ask them to suggest branches
15
+
16
+ ## Collaborative Techniques
17
+
18
+ 8. **"Yes, And..." Building**: They give idea, you "yes and" it, they "yes and" back - alternate
19
+ 9. **Brainwriting/Round Robin**: They suggest idea, you build on it, ask them to build on yours
20
+ 10. **Random Stimulation**: Give one random prompt/word, ask them to make connections
21
+
22
+ ## Deep Exploration
23
+
24
+ 11. **Five Whys**: Ask "why" and wait for their answer before asking next "why"
25
+ 12. **Morphological Analysis**: Ask them to list parameters first, then explore combinations together
26
+ 13. **Provocation Technique (PO)**: Give one provocative statement, ask them to extract useful ideas
27
+
28
+ ## Advanced Techniques
29
+
30
+ 14. **Forced Relationships**: Connect two unrelated concepts and ask them to find the bridge
31
+ 15. **Assumption Reversal**: Challenge their core assumptions and ask them to build from there
32
+ 16. **Role Playing**: Ask them to brainstorm from different stakeholder perspectives
33
+ 17. **Time Shifting**: "How would you solve this in 1995? 2030?"
34
+ 18. **Resource Constraints**: "What if you had only $10 and 1 hour?"
35
+ 19. **Metaphor Mapping**: Use extended metaphors to explore solutions
36
+ 20. **Question Storming**: Generate questions instead of answers first
@@ -0,0 +1,154 @@
1
+ # Elicitation Methods Data
2
+
3
+ ## Core Reflective Methods
4
+
5
+ **Expand or Contract for Audience**
6
+
7
+ - Ask whether to 'expand' (add detail, elaborate) or 'contract' (simplify, clarify)
8
+ - Identify specific target audience if relevant
9
+ - Tailor content complexity and depth accordingly
10
+
11
+ **Explain Reasoning (CoT Step-by-Step)**
12
+
13
+ - Walk through the step-by-step thinking process
14
+ - Reveal underlying assumptions and decision points
15
+ - Show how conclusions were reached from current role's perspective
16
+
17
+ **Critique and Refine**
18
+
19
+ - Review output for flaws, inconsistencies, or improvement areas
20
+ - Identify specific weaknesses from role's expertise
21
+ - Suggest refined version reflecting domain knowledge
22
+
23
+ ## Structural Analysis Methods
24
+
25
+ **Analyze Logical Flow and Dependencies**
26
+
27
+ - Examine content structure for logical progression
28
+ - Check internal consistency and coherence
29
+ - Identify and validate dependencies between elements
30
+ - Confirm effective ordering and sequencing
31
+
32
+ **Assess Alignment with Overall Goals**
33
+
34
+ - Evaluate content contribution to stated objectives
35
+ - Identify any misalignments or gaps
36
+ - Interpret alignment from specific role's perspective
37
+ - Suggest adjustments to better serve goals
38
+
39
+ ## Risk and Challenge Methods
40
+
41
+ **Identify Potential Risks and Unforeseen Issues**
42
+
43
+ - Brainstorm potential risks from role's expertise
44
+ - Identify overlooked edge cases or scenarios
45
+ - Anticipate unintended consequences
46
+ - Highlight implementation challenges
47
+
48
+ **Challenge from Critical Perspective**
49
+
50
+ - Adopt critical stance on current content
51
+ - Play devil's advocate from specified viewpoint
52
+ - Argue against proposal highlighting weaknesses
53
+ - Apply YAGNI principles when appropriate (scope trimming)
54
+
55
+ ## Creative Exploration Methods
56
+
57
+ **Tree of Thoughts Deep Dive**
58
+
59
+ - Break problem into discrete "thoughts" or intermediate steps
60
+ - Explore multiple reasoning paths simultaneously
61
+ - Use self-evaluation to classify each path as "sure", "likely", or "impossible"
62
+ - Apply search algorithms (BFS/DFS) to find optimal solution paths
63
+
64
+ **Hindsight is 20/20: The 'If Only...' Reflection**
65
+
66
+ - Imagine retrospective scenario based on current content
67
+ - Identify the one "if only we had known/done X..." insight
68
+ - Describe imagined consequences humorously or dramatically
69
+ - Extract actionable learnings for current context
70
+
71
+ ## Multi-Persona Collaboration Methods
72
+
73
+ **Agile Team Perspective Shift**
74
+
75
+ - Rotate through different Scrum team member viewpoints
76
+ - Product Owner: Focus on user value and business impact
77
+ - Scrum Master: Examine process flow and team dynamics
78
+ - Developer: Assess technical implementation and complexity
79
+ - QA: Identify testing scenarios and quality concerns
80
+
81
+ **Stakeholder Round Table**
82
+
83
+ - Convene virtual meeting with multiple personas
84
+ - Each persona contributes unique perspective on content
85
+ - Identify conflicts and synergies between viewpoints
86
+ - Synthesize insights into actionable recommendations
87
+
88
+ **Meta-Prompting Analysis**
89
+
90
+ - Step back to analyze the structure and logic of current approach
91
+ - Question the format and methodology being used
92
+ - Suggest alternative frameworks or mental models
93
+ - Optimize the elicitation process itself
94
+
95
+ ## Advanced 2025 Techniques
96
+
97
+ **Self-Consistency Validation**
98
+
99
+ - Generate multiple reasoning paths for same problem
100
+ - Compare consistency across different approaches
101
+ - Identify most reliable and robust solution
102
+ - Highlight areas where approaches diverge and why
103
+
104
+ **ReWOO (Reasoning Without Observation)**
105
+
106
+ - Separate parametric reasoning from tool-based actions
107
+ - Create reasoning plan without external dependencies
108
+ - Identify what can be solved through pure reasoning
109
+ - Optimize for efficiency and reduced token usage
110
+
111
+ **Persona-Pattern Hybrid**
112
+
113
+ - Combine specific role expertise with elicitation pattern
114
+ - Architect + Risk Analysis: Deep technical risk assessment
115
+ - UX Expert + User Journey: End-to-end experience critique
116
+ - PM + Stakeholder Analysis: Multi-perspective impact review
117
+
118
+ **Emergent Collaboration Discovery**
119
+
120
+ - Allow multiple perspectives to naturally emerge
121
+ - Identify unexpected insights from persona interactions
122
+ - Explore novel combinations of viewpoints
123
+ - Capture serendipitous discoveries from multi-agent thinking
124
+
125
+ ## Game-Based Elicitation Methods
126
+
127
+ **Red Team vs Blue Team**
128
+
129
+ - Red Team: Attack the proposal, find vulnerabilities
130
+ - Blue Team: Defend and strengthen the approach
131
+ - Competitive analysis reveals blind spots
132
+ - Results in more robust, battle-tested solutions
133
+
134
+ **Innovation Tournament**
135
+
136
+ - Pit multiple alternative approaches against each other
137
+ - Score each approach across different criteria
138
+ - Crowd-source evaluation from different personas
139
+ - Identify winning combination of features
140
+
141
+ **Escape Room Challenge**
142
+
143
+ - Present content as constraints to work within
144
+ - Find creative solutions within tight limitations
145
+ - Identify minimum viable approach
146
+ - Discover innovative workarounds and optimizations
147
+
148
+ ## Process Control
149
+
150
+ **Proceed / No Further Actions**
151
+
152
+ - Acknowledge choice to finalize current work
153
+ - Accept output as-is or move to next step
154
+ - Prepare to continue without additional elicitation