@techierathore/techieflow 1.0.2 → 1.0.4

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 (204) hide show
  1. package/.claude/commands/TechieFlow/agents/analyst.md +5 -13
  2. package/.claude/commands/TechieFlow/agents/architect.md +1 -16
  3. package/.claude/commands/TechieFlow/agents/flow-master.md +42 -215
  4. package/.claude/commands/TechieFlow/agents/verifier.md +24 -64
  5. package/.claude/commands/TechieFlow/tasks/_metrics-emit-gate.md +24 -117
  6. package/.claude/commands/TechieFlow/tasks/_owner-language.md +26 -0
  7. package/.claude/commands/TechieFlow/tasks/_smoke-test-policy.md +20 -84
  8. package/.claude/commands/TechieFlow/tasks/_status-update-gate.md +10 -74
  9. package/.claude/commands/TechieFlow/tasks/_yolo-mode.md +20 -58
  10. package/.claude/commands/TechieFlow/tasks/amend-docs.md +21 -143
  11. package/.claude/commands/TechieFlow/tasks/build-phase.md +14 -224
  12. package/.claude/commands/TechieFlow/tasks/create-deep-research-prompt.md +4 -0
  13. package/.claude/commands/TechieFlow/tasks/create-doc.md +4 -0
  14. package/.claude/commands/TechieFlow/tasks/create-project-brief.md +22 -0
  15. package/.claude/commands/TechieFlow/tasks/day1-brownfield.md +31 -505
  16. package/.claude/commands/TechieFlow/tasks/day1-greenfield.md +28 -213
  17. package/.claude/commands/TechieFlow/tasks/deploy-checklist.md +19 -0
  18. package/.claude/commands/TechieFlow/tasks/devguide.md +10 -219
  19. package/.claude/commands/TechieFlow/tasks/facilitate-brainstorming-session.md +4 -0
  20. package/.claude/commands/TechieFlow/tasks/fix-issues.md +10 -129
  21. package/.claude/commands/TechieFlow/tasks/generate-html.md +5 -1
  22. package/.claude/commands/TechieFlow/tasks/handoff-phase.md +18 -16
  23. package/.claude/commands/TechieFlow/tasks/log-miss.md +19 -158
  24. package/.claude/commands/TechieFlow/tasks/metrics-report.md +3 -1
  25. package/.claude/commands/TechieFlow/tasks/mockups.md +12 -117
  26. package/.claude/commands/TechieFlow/tasks/refresh-status.md +9 -130
  27. package/.claude/commands/TechieFlow/tasks/split-brd.md +10 -126
  28. package/.claude/commands/TechieFlow/tasks/triage-and-fix.md +14 -0
  29. package/.claude/commands/TechieFlow/tasks/triage-issues.md +11 -152
  30. package/.claude/commands/TechieFlow/tasks/verify-phase.md +36 -572
  31. package/.opencode/plugin/techieflow.js +40 -13
  32. package/.tfcore/agents/analyst.md +5 -13
  33. package/.tfcore/agents/architect.md +1 -16
  34. package/.tfcore/agents/flow-master.md +42 -215
  35. package/.tfcore/agents/verifier.md +24 -64
  36. package/.tfcore/core-config.yaml +10 -0
  37. package/.tfcore/hooks/block-git.sh +4 -4
  38. package/.tfcore/hooks/guard-artifacts.sh +2 -2
  39. package/.tfcore/hooks/guard-build.sh +76 -0
  40. package/.tfcore/hooks/guard-db.sh +90 -0
  41. package/.tfcore/hooks/guard-metrics.sh +68 -0
  42. package/.tfcore/hooks/guard-status-html.sh +116 -71
  43. package/.tfcore/hooks/guard-status.sh +43 -16
  44. package/.tfcore/hooks/guard-verify-deps.sh +124 -0
  45. package/.tfcore/hooks/guard-verify.sh +70 -48
  46. package/.tfcore/hooks/sweep-artifacts.sh +2 -2
  47. package/.tfcore/install-manifest.yaml +0 -18
  48. package/.tfcore/routing.yaml +86 -14
  49. package/.tfcore/standards/coding-standards-core.md +61 -0
  50. package/.tfcore/standards/coding-standards-dotnet.md +93 -0
  51. package/.tfcore/tasks/_metrics-emit-gate.md +24 -117
  52. package/.tfcore/tasks/_owner-language.md +26 -0
  53. package/.tfcore/tasks/_smoke-test-policy.md +20 -84
  54. package/.tfcore/tasks/_status-update-gate.md +10 -74
  55. package/.tfcore/tasks/_yolo-mode.md +20 -58
  56. package/.tfcore/tasks/amend-docs.md +21 -143
  57. package/.tfcore/tasks/build-phase.md +14 -224
  58. package/.tfcore/tasks/create-deep-research-prompt.md +4 -0
  59. package/.tfcore/tasks/create-doc.md +4 -0
  60. package/.tfcore/tasks/create-project-brief.md +22 -0
  61. package/.tfcore/tasks/day1-brownfield.md +31 -505
  62. package/.tfcore/tasks/day1-greenfield.md +28 -213
  63. package/.tfcore/tasks/deploy-checklist.md +19 -0
  64. package/.tfcore/tasks/devguide.md +10 -219
  65. package/.tfcore/tasks/facilitate-brainstorming-session.md +4 -0
  66. package/.tfcore/tasks/fix-issues.md +10 -129
  67. package/.tfcore/tasks/generate-html.md +5 -1
  68. package/.tfcore/tasks/handoff-phase.md +18 -16
  69. package/.tfcore/tasks/log-miss.md +19 -158
  70. package/.tfcore/tasks/metrics-report.md +3 -1
  71. package/.tfcore/tasks/mockups.md +12 -117
  72. package/.tfcore/tasks/refresh-status.md +9 -130
  73. package/.tfcore/tasks/split-brd.md +10 -126
  74. package/.tfcore/tasks/triage-and-fix.md +14 -0
  75. package/.tfcore/tasks/triage-issues.md +11 -152
  76. package/.tfcore/tasks/verify-phase.md +36 -572
  77. package/.tfcore/telemetry/SCHEMA.md +100 -8
  78. package/.tfcore/telemetry/tf-metrics.sh +564 -32
  79. package/.tfcore/templates/stack-defaults/dotnet.md +35 -0
  80. package/.tfcore/templates/stack-questions.md +77 -0
  81. package/.tfcore/templates/v4custom/app-agents-md-tmpl.md +3 -4
  82. package/.tfcore/templates/v4custom/app-architecture-tmpl.md +107 -115
  83. package/.tfcore/templates/v4custom/app-brd-tmpl.md +108 -184
  84. package/.tfcore/templates/v4custom/app-brief-tmpl.md +65 -0
  85. package/.tfcore/templates/v4custom/app-checklist-tmpl.md +48 -73
  86. package/.tfcore/templates/v4custom/app-claude-md-tmpl.md +1 -1
  87. package/.tfcore/templates/v4custom/app-coding-standards-tmpl.md +52 -0
  88. package/.tfcore/templates/v4custom/app-decision-request-tmpl.md +85 -0
  89. package/.tfcore/templates/v4custom/app-deployment-checklist-tmpl.md +86 -0
  90. package/.tfcore/templates/v4custom/app-devguide-tmpl.md +69 -146
  91. package/.tfcore/templates/v4custom/app-library-feedback-tmpl.md +86 -31
  92. package/.tfcore/templates/v4custom/app-phases-tmpl.md +35 -0
  93. package/.tfcore/templates/v4custom/app-productguide-tmpl.md +38 -35
  94. package/.tfcore/templates/v4custom/app-project-status-tmpl.md +63 -73
  95. package/.tfcore/templates/v4custom/app-uidesign-tmpl.md +62 -37
  96. package/.tfcore/templates/v4custom/app-usageguide-tmpl.md +69 -54
  97. package/.tfcore/templates/v4custom/build-invocation-ladder.md +17 -180
  98. package/.tfcore/templates/v4custom/build-subagent-prompt.md +17 -0
  99. package/.tfcore/templates/v4custom/html-render-shell.md +1 -1
  100. package/.tfcore/templates/v4custom/metrics-report-template.md +2 -2
  101. package/.tfcore/user-guide.md +0 -23
  102. package/.tfcore/utils/__pycache__/tf-brd-status.cpython-312.pyc +0 -0
  103. package/.tfcore/utils/__pycache__/tf-checklist-edit.cpython-312.pyc +0 -0
  104. package/.tfcore/utils/__pycache__/tf-codex-bind.cpython-312.pyc +0 -0
  105. package/.tfcore/utils/__pycache__/tf-codex-telemetry.cpython-312.pyc +0 -0
  106. package/.tfcore/utils/__pycache__/tf-day1-files.cpython-312.pyc +0 -0
  107. package/.tfcore/utils/__pycache__/tf-devguide-list.cpython-312.pyc +0 -0
  108. package/.tfcore/utils/__pycache__/tf-doc-check.cpython-312.pyc +0 -0
  109. package/.tfcore/utils/__pycache__/tf-log-miss.cpython-312.pyc +0 -0
  110. package/.tfcore/utils/__pycache__/tf-misses-md.cpython-312.pyc +0 -0
  111. package/.tfcore/utils/__pycache__/tf-mockups-locate.cpython-312.pyc +0 -0
  112. package/.tfcore/utils/__pycache__/tf-opencode-audit.cpython-312.pyc +0 -0
  113. package/.tfcore/utils/__pycache__/tf-perf-grade.cpython-312.pyc +0 -0
  114. package/.tfcore/utils/__pycache__/tf-render-html.cpython-312.pyc +0 -0
  115. package/.tfcore/utils/__pycache__/tf-split-brd.cpython-312.pyc +0 -0
  116. package/.tfcore/utils/__pycache__/tf-status-facts.cpython-312.pyc +0 -0
  117. package/.tfcore/utils/__pycache__/tf-triage.cpython-312.pyc +0 -0
  118. package/.tfcore/utils/__pycache__/tf-verify-list.cpython-312.pyc +0 -0
  119. package/.tfcore/utils/__pycache__/tf-verify-verdict.cpython-312.pyc +0 -0
  120. package/.tfcore/utils/tf-brd-status.py +176 -0
  121. package/.tfcore/utils/tf-brd-status.sh +19 -0
  122. package/.tfcore/utils/tf-build-list.py +211 -0
  123. package/.tfcore/utils/tf-build-list.sh +21 -0
  124. package/.tfcore/utils/tf-build.sh +143 -0
  125. package/.tfcore/utils/tf-cdp-relay.ps1 +64 -0
  126. package/.tfcore/utils/tf-checklist-edit.py +133 -0
  127. package/.tfcore/utils/tf-day1-files.py +208 -0
  128. package/.tfcore/utils/tf-day1-files.sh +20 -0
  129. package/.tfcore/utils/tf-devguide-list.py +249 -0
  130. package/.tfcore/utils/tf-devguide-list.sh +18 -0
  131. package/.tfcore/utils/tf-doc-check.py +1369 -0
  132. package/.tfcore/utils/tf-doc-check.sh +29 -0
  133. package/.tfcore/utils/tf-emit.sh +545 -18
  134. package/.tfcore/utils/tf-fix-close.sh +115 -0
  135. package/.tfcore/utils/tf-gitignore-audit.sh +50 -3
  136. package/.tfcore/utils/tf-goal.sh +284 -66
  137. package/.tfcore/utils/tf-harness.sh +4 -9
  138. package/.tfcore/utils/tf-log-miss.py +197 -0
  139. package/.tfcore/utils/tf-log-miss.sh +14 -0
  140. package/.tfcore/utils/tf-misses-md.py +208 -0
  141. package/.tfcore/utils/tf-misses-md.sh +14 -0
  142. package/.tfcore/utils/tf-mockups-locate.py +66 -0
  143. package/.tfcore/utils/tf-mockups-locate.sh +18 -0
  144. package/.tfcore/utils/tf-model-pick.sh +475 -0
  145. package/.tfcore/utils/tf-opencode-audit.py +23 -7
  146. package/.tfcore/utils/tf-perf-grade.py +97 -0
  147. package/.tfcore/utils/tf-perf-grade.sh +12 -0
  148. package/.tfcore/utils/tf-phase.sh +92 -0
  149. package/.tfcore/utils/tf-render-html.py +20 -0
  150. package/.tfcore/utils/tf-routing-bind.sh +97 -6
  151. package/.tfcore/utils/tf-routing.sh +13 -7
  152. package/.tfcore/utils/tf-selfcheck.sh +323 -0
  153. package/.tfcore/utils/tf-split-brd.py +309 -0
  154. package/.tfcore/utils/tf-split-brd.sh +22 -0
  155. package/.tfcore/utils/tf-status-evidence.sh +68 -0
  156. package/.tfcore/utils/tf-status-facts.py +358 -0
  157. package/.tfcore/utils/tf-status-facts.sh +20 -0
  158. package/.tfcore/utils/tf-triage.py +243 -0
  159. package/.tfcore/utils/tf-triage.sh +16 -0
  160. package/.tfcore/utils/tf-verify-boot.sh +250 -0
  161. package/.tfcore/utils/tf-verify-emit.sh +110 -0
  162. package/.tfcore/utils/tf-verify-env.sh +88 -0
  163. package/.tfcore/utils/tf-verify-list.py +270 -0
  164. package/.tfcore/utils/tf-verify-list.sh +13 -0
  165. package/.tfcore/utils/tf-verify-screens.mjs +355 -0
  166. package/.tfcore/utils/tf-verify-screens.sh +31 -0
  167. package/.tfcore/utils/tf-verify-tests.sh +166 -0
  168. package/.tfcore/utils/tf-verify-verdict.py +292 -0
  169. package/.tfcore/utils/tf-verify-verdict.sh +15 -0
  170. package/.tfcore/utils/tf-yolo.sh +59 -0
  171. package/README.md +120 -1145
  172. package/docs/TechieFlow-Installation.md +1 -5
  173. package/opencode.jsonc +37 -33
  174. package/package.json +1 -5
  175. package/scripts/install.mjs +56 -46
  176. package/.claude/commands/TechieFlow/tasks/advanced-elicitation.md +0 -117
  177. package/.claude/commands/TechieFlow/tasks/author-brd.md +0 -79
  178. package/.claude/commands/TechieFlow/tasks/document-project.md +0 -343
  179. package/.claude/commands/TechieFlow/tasks/execute-checklist.md +0 -86
  180. package/.claude/commands/TechieFlow/tasks/index-docs.md +0 -173
  181. package/.claude/commands/TechieFlow/tasks/kb-mode-interaction.md +0 -75
  182. package/.claude/commands/TechieFlow/tasks/shard-doc.md +0 -185
  183. package/.codex/config.toml +0 -46
  184. package/.codex/hooks.json +0 -63
  185. package/.codex/rules/techieflow.rules +0 -8
  186. package/.tfcore/hooks/codex-adapter.py +0 -248
  187. package/.tfcore/tasks/advanced-elicitation.md +0 -117
  188. package/.tfcore/tasks/author-brd.md +0 -79
  189. package/.tfcore/tasks/document-project.md +0 -343
  190. package/.tfcore/tasks/execute-checklist.md +0 -86
  191. package/.tfcore/tasks/index-docs.md +0 -173
  192. package/.tfcore/tasks/kb-mode-interaction.md +0 -75
  193. package/.tfcore/tasks/shard-doc.md +0 -185
  194. package/.tfcore/templates/architecture-tmpl.yaml +0 -650
  195. package/.tfcore/templates/brownfield-architecture-tmpl.yaml +0 -476
  196. package/.tfcore/templates/competitor-analysis-tmpl.yaml +0 -306
  197. package/.tfcore/templates/front-end-architecture-tmpl.yaml +0 -218
  198. package/.tfcore/templates/fullstack-architecture-tmpl.yaml +0 -823
  199. package/.tfcore/templates/market-research-tmpl.yaml +0 -252
  200. package/.tfcore/templates/project-brief-tmpl.yaml +0 -221
  201. package/.tfcore/utils/techieflow-doc-template.md +0 -325
  202. package/.tfcore/utils/tf-codex-bind.py +0 -196
  203. package/.tfcore/utils/tf-codex-telemetry.py +0 -60
  204. package/WORKFLOW.html +0 -1986
@@ -1,306 +0,0 @@
1
- template:
2
- id: competitor-analysis-template-v2
3
- name: Competitive Analysis Report
4
- version: 2.0
5
- output:
6
- format: markdown
7
- filename: docs/competitor-analysis.md
8
- title: "Competitive Analysis Report: {{project_product_name}}"
9
-
10
- workflow:
11
- mode: interactive
12
- elicitation: advanced-elicitation
13
- custom_elicitation:
14
- title: "Competitive Analysis Elicitation Actions"
15
- options:
16
- - "Deep dive on a specific competitor's strategy"
17
- - "Analyze competitive dynamics in a specific segment"
18
- - "War game competitive responses to your moves"
19
- - "Explore partnership vs. competition scenarios"
20
- - "Stress test differentiation claims"
21
- - "Analyze disruption potential (yours or theirs)"
22
- - "Compare to competition in adjacent markets"
23
- - "Generate win/loss analysis insights"
24
- - "If only we had known about [competitor X's plan]..."
25
- - "Proceed to next section"
26
-
27
- sections:
28
- - id: executive-summary
29
- title: Executive Summary
30
- instruction: Provide high-level competitive insights, main threats and opportunities, and recommended strategic actions. Write this section LAST after completing all analysis.
31
-
32
- - id: analysis-scope
33
- title: Analysis Scope & Methodology
34
- instruction: This template guides comprehensive competitor analysis. Start by understanding the user's competitive intelligence needs and strategic objectives. Help them identify and prioritize competitors before diving into detailed analysis.
35
- sections:
36
- - id: analysis-purpose
37
- title: Analysis Purpose
38
- instruction: |
39
- Define the primary purpose:
40
- - New market entry assessment
41
- - Product positioning strategy
42
- - Feature gap analysis
43
- - Pricing strategy development
44
- - Partnership/acquisition targets
45
- - Competitive threat assessment
46
- - id: competitor-categories
47
- title: Competitor Categories Analyzed
48
- instruction: |
49
- List categories included:
50
- - Direct Competitors: Same product/service, same target market
51
- - Indirect Competitors: Different product, same need/problem
52
- - Potential Competitors: Could enter market easily
53
- - Substitute Products: Alternative solutions
54
- - Aspirational Competitors: Best-in-class examples
55
- - id: research-methodology
56
- title: Research Methodology
57
- instruction: |
58
- Describe approach:
59
- - Information sources used
60
- - Analysis timeframe
61
- - Confidence levels
62
- - Limitations
63
-
64
- - id: competitive-landscape
65
- title: Competitive Landscape Overview
66
- sections:
67
- - id: market-structure
68
- title: Market Structure
69
- instruction: |
70
- Describe the competitive environment:
71
- - Number of active competitors
72
- - Market concentration (fragmented/consolidated)
73
- - Competitive dynamics
74
- - Recent market entries/exits
75
- - id: prioritization-matrix
76
- title: Competitor Prioritization Matrix
77
- instruction: |
78
- Help categorize competitors by market share and strategic threat level
79
-
80
- Create a 2x2 matrix:
81
- - Priority 1 (Core Competitors): High Market Share + High Threat
82
- - Priority 2 (Emerging Threats): Low Market Share + High Threat
83
- - Priority 3 (Established Players): High Market Share + Low Threat
84
- - Priority 4 (Monitor Only): Low Market Share + Low Threat
85
-
86
- - id: competitor-profiles
87
- title: Individual Competitor Profiles
88
- instruction: Create detailed profiles for each Priority 1 and Priority 2 competitor. For Priority 3 and 4, create condensed profiles.
89
- repeatable: true
90
- sections:
91
- - id: competitor
92
- title: "{{competitor_name}} - Priority {{priority_level}}"
93
- sections:
94
- - id: company-overview
95
- title: Company Overview
96
- template: |
97
- - **Founded:** {{year_founders}}
98
- - **Headquarters:** {{location}}
99
- - **Company Size:** {{employees_revenue}}
100
- - **Funding:** {{total_raised_investors}}
101
- - **Leadership:** {{key_executives}}
102
- - id: business-model
103
- title: Business Model & Strategy
104
- template: |
105
- - **Revenue Model:** {{revenue_model}}
106
- - **Target Market:** {{customer_segments}}
107
- - **Value Proposition:** {{value_promise}}
108
- - **Go-to-Market Strategy:** {{gtm_approach}}
109
- - **Strategic Focus:** {{current_priorities}}
110
- - id: product-analysis
111
- title: Product/Service Analysis
112
- template: |
113
- - **Core Offerings:** {{main_products}}
114
- - **Key Features:** {{standout_capabilities}}
115
- - **User Experience:** {{ux_assessment}}
116
- - **Technology Stack:** {{tech_stack}}
117
- - **Pricing:** {{pricing_model}}
118
- - id: strengths-weaknesses
119
- title: Strengths & Weaknesses
120
- sections:
121
- - id: strengths
122
- title: Strengths
123
- type: bullet-list
124
- template: "- {{strength}}"
125
- - id: weaknesses
126
- title: Weaknesses
127
- type: bullet-list
128
- template: "- {{weakness}}"
129
- - id: market-position
130
- title: Market Position & Performance
131
- template: |
132
- - **Market Share:** {{market_share_estimate}}
133
- - **Customer Base:** {{customer_size_notables}}
134
- - **Growth Trajectory:** {{growth_trend}}
135
- - **Recent Developments:** {{key_news}}
136
-
137
- - id: comparative-analysis
138
- title: Comparative Analysis
139
- sections:
140
- - id: feature-comparison
141
- title: Feature Comparison Matrix
142
- instruction: Create a detailed comparison table of key features across competitors
143
- type: table
144
- columns:
145
- [
146
- "Feature Category",
147
- "{{your_company}}",
148
- "{{competitor_1}}",
149
- "{{competitor_2}}",
150
- "{{competitor_3}}",
151
- ]
152
- rows:
153
- - category: "Core Functionality"
154
- items:
155
- - ["Feature A", "{{status}}", "{{status}}", "{{status}}", "{{status}}"]
156
- - ["Feature B", "{{status}}", "{{status}}", "{{status}}", "{{status}}"]
157
- - category: "User Experience"
158
- items:
159
- - ["Mobile App", "{{rating}}", "{{rating}}", "{{rating}}", "{{rating}}"]
160
- - ["Onboarding Time", "{{time}}", "{{time}}", "{{time}}", "{{time}}"]
161
- - category: "Integration & Ecosystem"
162
- items:
163
- - [
164
- "API Availability",
165
- "{{availability}}",
166
- "{{availability}}",
167
- "{{availability}}",
168
- "{{availability}}",
169
- ]
170
- - ["Third-party Integrations", "{{number}}", "{{number}}", "{{number}}", "{{number}}"]
171
- - category: "Pricing & Plans"
172
- items:
173
- - ["Starting Price", "{{price}}", "{{price}}", "{{price}}", "{{price}}"]
174
- - ["Free Tier", "{{yes_no}}", "{{yes_no}}", "{{yes_no}}", "{{yes_no}}"]
175
- - id: swot-comparison
176
- title: SWOT Comparison
177
- instruction: Create SWOT analysis for your solution vs. top competitors
178
- sections:
179
- - id: your-solution
180
- title: Your Solution
181
- template: |
182
- - **Strengths:** {{strengths}}
183
- - **Weaknesses:** {{weaknesses}}
184
- - **Opportunities:** {{opportunities}}
185
- - **Threats:** {{threats}}
186
- - id: vs-competitor
187
- title: "vs. {{main_competitor}}"
188
- template: |
189
- - **Competitive Advantages:** {{your_advantages}}
190
- - **Competitive Disadvantages:** {{their_advantages}}
191
- - **Differentiation Opportunities:** {{differentiation}}
192
- - id: positioning-map
193
- title: Positioning Map
194
- instruction: |
195
- Describe competitor positions on key dimensions
196
-
197
- Create a positioning description using 2 key dimensions relevant to the market, such as:
198
- - Price vs. Features
199
- - Ease of Use vs. Power
200
- - Specialization vs. Breadth
201
- - Self-Serve vs. High-Touch
202
-
203
- - id: strategic-analysis
204
- title: Strategic Analysis
205
- sections:
206
- - id: competitive-advantages
207
- title: Competitive Advantages Assessment
208
- sections:
209
- - id: sustainable-advantages
210
- title: Sustainable Advantages
211
- instruction: |
212
- Identify moats and defensible positions:
213
- - Network effects
214
- - Switching costs
215
- - Brand strength
216
- - Technology barriers
217
- - Regulatory advantages
218
- - id: vulnerable-points
219
- title: Vulnerable Points
220
- instruction: |
221
- Where competitors could be challenged:
222
- - Weak customer segments
223
- - Missing features
224
- - Poor user experience
225
- - High prices
226
- - Limited geographic presence
227
- - id: blue-ocean
228
- title: Blue Ocean Opportunities
229
- instruction: |
230
- Identify uncontested market spaces
231
-
232
- List opportunities to create new market space:
233
- - Underserved segments
234
- - Unaddressed use cases
235
- - New business models
236
- - Geographic expansion
237
- - Different value propositions
238
-
239
- - id: strategic-recommendations
240
- title: Strategic Recommendations
241
- sections:
242
- - id: differentiation-strategy
243
- title: Differentiation Strategy
244
- instruction: |
245
- How to position against competitors:
246
- - Unique value propositions to emphasize
247
- - Features to prioritize
248
- - Segments to target
249
- - Messaging and positioning
250
- - id: competitive-response
251
- title: Competitive Response Planning
252
- sections:
253
- - id: offensive-strategies
254
- title: Offensive Strategies
255
- instruction: |
256
- How to gain market share:
257
- - Target competitor weaknesses
258
- - Win competitive deals
259
- - Capture their customers
260
- - id: defensive-strategies
261
- title: Defensive Strategies
262
- instruction: |
263
- How to protect your position:
264
- - Strengthen vulnerable areas
265
- - Build switching costs
266
- - Deepen customer relationships
267
- - id: partnership-ecosystem
268
- title: Partnership & Ecosystem Strategy
269
- instruction: |
270
- Potential collaboration opportunities:
271
- - Complementary players
272
- - Channel partners
273
- - Technology integrations
274
- - Strategic alliances
275
-
276
- - id: monitoring-plan
277
- title: Monitoring & Intelligence Plan
278
- sections:
279
- - id: key-competitors
280
- title: Key Competitors to Track
281
- instruction: Priority list with rationale
282
- - id: monitoring-metrics
283
- title: Monitoring Metrics
284
- instruction: |
285
- What to track:
286
- - Product updates
287
- - Pricing changes
288
- - Customer wins/losses
289
- - Funding/M&A activity
290
- - Market messaging
291
- - id: intelligence-sources
292
- title: Intelligence Sources
293
- instruction: |
294
- Where to gather ongoing intelligence:
295
- - Company websites/blogs
296
- - Customer reviews
297
- - Industry reports
298
- - Social media
299
- - Patent filings
300
- - id: update-cadence
301
- title: Update Cadence
302
- instruction: |
303
- Recommended review schedule:
304
- - Weekly: {{weekly_items}}
305
- - Monthly: {{monthly_items}}
306
- - Quarterly: {{quarterly_analysis}}
@@ -1,218 +0,0 @@
1
- template:
2
- id: frontend-architecture-template-v2
3
- name: Frontend Architecture Document
4
- version: 2.0
5
- output:
6
- format: markdown
7
- filename: docs/ui-architecture.md
8
- title: "{{project_name}} Frontend Architecture Document"
9
-
10
- workflow:
11
- mode: interactive
12
- elicitation: advanced-elicitation
13
-
14
- sections:
15
- - id: template-framework-selection
16
- title: Template and Framework Selection
17
- instruction: |
18
- Review provided documents including PRD, UX-UI Specification, and main Architecture Document. Focus on extracting technical implementation details needed for AI frontend tools and developer agents. Ask the user for any of these documents if you are unable to locate and were not provided.
19
-
20
- Before proceeding with frontend architecture design, check if the project is using a frontend starter template or existing codebase:
21
-
22
- 1. Review the PRD, main architecture document, and brainstorming brief for mentions of:
23
- - Frontend starter templates (e.g., Create React App, Next.js, Vite, Vue CLI, Angular CLI, etc.)
24
- - UI kit or component library starters
25
- - Existing frontend projects being used as a foundation
26
- - Admin dashboard templates or other specialized starters
27
- - Design system implementations
28
-
29
- 2. If a frontend starter template or existing project is mentioned:
30
- - Ask the user to provide access via one of these methods:
31
- - Link to the starter template documentation
32
- - Upload/attach the project files (for small projects)
33
- - Share a link to the project repository
34
- - Analyze the starter/existing project to understand:
35
- - Pre-installed dependencies and versions
36
- - Folder structure and file organization
37
- - Built-in components and utilities
38
- - Styling approach (CSS modules, styled-components, Tailwind, etc.)
39
- - State management setup (if any)
40
- - Routing configuration
41
- - Testing setup and patterns
42
- - Build and development scripts
43
- - Use this analysis to ensure your frontend architecture aligns with the starter's patterns
44
-
45
- 3. If no frontend starter is mentioned but this is a new UI, ensure we know what the ui language and framework is:
46
- - Based on the framework choice, suggest appropriate starters:
47
- - React: Create React App, Next.js, Vite + React
48
- - Vue: Vue CLI, Nuxt.js, Vite + Vue
49
- - Angular: Angular CLI
50
- - Or suggest popular UI templates if applicable
51
- - Explain benefits specific to frontend development
52
-
53
- 4. If the user confirms no starter template will be used:
54
- - Note that all tooling, bundling, and configuration will need manual setup
55
- - Proceed with frontend architecture from scratch
56
-
57
- Document the starter template decision and any constraints it imposes before proceeding.
58
- sections:
59
- - id: changelog
60
- title: Change Log
61
- type: table
62
- columns: [Date, Version, Description, Author]
63
- instruction: Track document versions and changes
64
-
65
- - id: frontend-tech-stack
66
- title: Frontend Tech Stack
67
- instruction: Extract from main architecture's Technology Stack Table. This section MUST remain synchronized with the main architecture document.
68
- elicit: true
69
- sections:
70
- - id: tech-stack-table
71
- title: Technology Stack Table
72
- type: table
73
- columns: [Category, Technology, Version, Purpose, Rationale]
74
- instruction: Fill in appropriate technology choices based on the selected framework and project requirements.
75
- rows:
76
- - ["Framework", "{{framework}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
77
- - ["UI Library", "{{ui_library}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
78
- - [
79
- "State Management",
80
- "{{state_management}}",
81
- "{{version}}",
82
- "{{purpose}}",
83
- "{{why_chosen}}",
84
- ]
85
- - ["Routing", "{{routing_library}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
86
- - ["Build Tool", "{{build_tool}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
87
- - ["Styling", "{{styling_solution}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
88
- - ["Testing", "{{test_framework}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
89
- - [
90
- "Component Library",
91
- "{{component_lib}}",
92
- "{{version}}",
93
- "{{purpose}}",
94
- "{{why_chosen}}",
95
- ]
96
- - ["Form Handling", "{{form_library}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
97
- - ["Animation", "{{animation_lib}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
98
- - ["Dev Tools", "{{dev_tools}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
99
-
100
- - id: project-structure
101
- title: Project Structure
102
- instruction: Define exact directory structure for AI tools based on the chosen framework. Be specific about where each type of file goes. Generate a structure that follows the framework's best practices and conventions.
103
- elicit: true
104
- type: code
105
- language: plaintext
106
-
107
- - id: component-standards
108
- title: Component Standards
109
- instruction: Define exact patterns for component creation based on the chosen framework.
110
- elicit: true
111
- sections:
112
- - id: component-template
113
- title: Component Template
114
- instruction: Generate a minimal but complete component template following the framework's best practices. Include TypeScript types, proper imports, and basic structure.
115
- type: code
116
- language: typescript
117
- - id: naming-conventions
118
- title: Naming Conventions
119
- instruction: Provide naming conventions specific to the chosen framework for components, files, services, state management, and other architectural elements.
120
-
121
- - id: state-management
122
- title: State Management
123
- instruction: Define state management patterns based on the chosen framework.
124
- elicit: true
125
- sections:
126
- - id: store-structure
127
- title: Store Structure
128
- instruction: Generate the state management directory structure appropriate for the chosen framework and selected state management solution.
129
- type: code
130
- language: plaintext
131
- - id: state-template
132
- title: State Management Template
133
- instruction: Provide a basic state management template/example following the framework's recommended patterns. Include TypeScript types and common operations like setting, updating, and clearing state.
134
- type: code
135
- language: typescript
136
-
137
- - id: api-integration
138
- title: API Integration
139
- instruction: Define API service patterns based on the chosen framework.
140
- elicit: true
141
- sections:
142
- - id: service-template
143
- title: Service Template
144
- instruction: Provide an API service template that follows the framework's conventions. Include proper TypeScript types, error handling, and async patterns.
145
- type: code
146
- language: typescript
147
- - id: api-client-config
148
- title: API Client Configuration
149
- instruction: Show how to configure the HTTP client for the chosen framework, including authentication interceptors/middleware and error handling.
150
- type: code
151
- language: typescript
152
-
153
- - id: routing
154
- title: Routing
155
- instruction: Define routing structure and patterns based on the chosen framework.
156
- elicit: true
157
- sections:
158
- - id: route-configuration
159
- title: Route Configuration
160
- instruction: Provide routing configuration appropriate for the chosen framework. Include protected route patterns, lazy loading where applicable, and authentication guards/middleware.
161
- type: code
162
- language: typescript
163
-
164
- - id: styling-guidelines
165
- title: Styling Guidelines
166
- instruction: Define styling approach based on the chosen framework.
167
- elicit: true
168
- sections:
169
- - id: styling-approach
170
- title: Styling Approach
171
- instruction: Describe the styling methodology appropriate for the chosen framework (CSS Modules, Styled Components, Tailwind, etc.) and provide basic patterns.
172
- - id: global-theme
173
- title: Global Theme Variables
174
- instruction: Provide a CSS custom properties (CSS variables) theme system that works across all frameworks. Include colors, spacing, typography, shadows, and dark mode support.
175
- type: code
176
- language: css
177
-
178
- - id: testing-requirements
179
- title: Testing Requirements
180
- instruction: Define minimal testing requirements based on the chosen framework.
181
- elicit: true
182
- sections:
183
- - id: component-test-template
184
- title: Component Test Template
185
- instruction: Provide a basic component test template using the framework's recommended testing library. Include examples of rendering tests, user interaction tests, and mocking.
186
- type: code
187
- language: typescript
188
- - id: testing-best-practices
189
- title: Testing Best Practices
190
- type: numbered-list
191
- items:
192
- - "**Unit Tests**: Test individual components in isolation"
193
- - "**Integration Tests**: Test component interactions"
194
- - "**E2E Tests**: Test critical user flows (using Cypress/Playwright)"
195
- - "**Coverage Goals**: Aim for 80% code coverage"
196
- - "**Test Structure**: Arrange-Act-Assert pattern"
197
- - "**Mock External Dependencies**: API calls, routing, state management"
198
-
199
- - id: environment-configuration
200
- title: Environment Configuration
201
- instruction: List required environment variables based on the chosen framework. Show the appropriate format and naming conventions for the framework.
202
- elicit: true
203
-
204
- - id: frontend-developer-standards
205
- title: Frontend Developer Standards
206
- sections:
207
- - id: critical-coding-rules
208
- title: Critical Coding Rules
209
- instruction: List essential rules that prevent common AI mistakes, including both universal rules and framework-specific ones.
210
- elicit: true
211
- - id: quick-reference
212
- title: Quick Reference
213
- instruction: |
214
- Create a framework-specific cheat sheet with:
215
- - Common commands (dev server, build, test)
216
- - Key import patterns
217
- - File naming conventions
218
- - Project-specific patterns and utilities