@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,278 @@
1
+ # Create Deep Research Prompt Task
2
+
3
+ This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
4
+
5
+ ## Purpose
6
+
7
+ Generate well-structured research prompts that:
8
+
9
+ - Define clear research objectives and scope
10
+ - Specify appropriate research methodologies
11
+ - Outline expected deliverables and formats
12
+ - Guide systematic investigation of complex topics
13
+ - Ensure actionable insights are captured
14
+
15
+ ## Research Type Selection
16
+
17
+ CRITICAL: First, help the user select the most appropriate research focus based on their needs and any input documents they've provided.
18
+
19
+ ### 1. Research Focus Options
20
+
21
+ Present these numbered options to the user:
22
+
23
+ 1. **Product Validation Research**
24
+ - Validate product hypotheses and market fit
25
+ - Test assumptions about user needs and solutions
26
+ - Assess technical and business feasibility
27
+ - Identify risks and mitigation strategies
28
+
29
+ 2. **Market Opportunity Research**
30
+ - Analyze market size and growth potential
31
+ - Identify market segments and dynamics
32
+ - Assess market entry strategies
33
+ - Evaluate timing and market readiness
34
+
35
+ 3. **User & Customer Research**
36
+ - Deep dive into user personas and behaviors
37
+ - Understand jobs-to-be-done and pain points
38
+ - Map customer journeys and touchpoints
39
+ - Analyze willingness to pay and value perception
40
+
41
+ 4. **Competitive Intelligence Research**
42
+ - Detailed competitor analysis and positioning
43
+ - Feature and capability comparisons
44
+ - Business model and strategy analysis
45
+ - Identify competitive advantages and gaps
46
+
47
+ 5. **Technology & Innovation Research**
48
+ - Assess technology trends and possibilities
49
+ - Evaluate technical approaches and architectures
50
+ - Identify emerging technologies and disruptions
51
+ - Analyze build vs. buy vs. partner options
52
+
53
+ 6. **Industry & Ecosystem Research**
54
+ - Map industry value chains and dynamics
55
+ - Identify key players and relationships
56
+ - Analyze regulatory and compliance factors
57
+ - Understand partnership opportunities
58
+
59
+ 7. **Strategic Options Research**
60
+ - Evaluate different strategic directions
61
+ - Assess business model alternatives
62
+ - Analyze go-to-market strategies
63
+ - Consider expansion and scaling paths
64
+
65
+ 8. **Risk & Feasibility Research**
66
+ - Identify and assess various risk factors
67
+ - Evaluate implementation challenges
68
+ - Analyze resource requirements
69
+ - Consider regulatory and legal implications
70
+
71
+ 9. **Custom Research Focus**
72
+ - User-defined research objectives
73
+ - Specialized domain investigation
74
+ - Cross-functional research needs
75
+
76
+ ### 2. Input Processing
77
+
78
+ **If Project Brief provided:**
79
+
80
+ - Extract key product concepts and goals
81
+ - Identify target users and use cases
82
+ - Note technical constraints and preferences
83
+ - Highlight uncertainties and assumptions
84
+
85
+ **If Brainstorming Results provided:**
86
+
87
+ - Synthesize main ideas and themes
88
+ - Identify areas needing validation
89
+ - Extract hypotheses to test
90
+ - Note creative directions to explore
91
+
92
+ **If Market Research provided:**
93
+
94
+ - Build on identified opportunities
95
+ - Deepen specific market insights
96
+ - Validate initial findings
97
+ - Explore adjacent possibilities
98
+
99
+ **If Starting Fresh:**
100
+
101
+ - Gather essential context through questions
102
+ - Define the problem space
103
+ - Clarify research objectives
104
+ - Establish success criteria
105
+
106
+ ## Process
107
+
108
+ ### 3. Research Prompt Structure
109
+
110
+ CRITICAL: collaboratively develop a comprehensive research prompt with these components.
111
+
112
+ #### A. Research Objectives
113
+
114
+ CRITICAL: collaborate with the user to articulate clear, specific objectives for the research.
115
+
116
+ - Primary research goal and purpose
117
+ - Key decisions the research will inform
118
+ - Success criteria for the research
119
+ - Constraints and boundaries
120
+
121
+ #### B. Research Questions
122
+
123
+ CRITICAL: collaborate with the user to develop specific, actionable research questions organized by theme.
124
+
125
+ **Core Questions:**
126
+
127
+ - Central questions that must be answered
128
+ - Priority ranking of questions
129
+ - Dependencies between questions
130
+
131
+ **Supporting Questions:**
132
+
133
+ - Additional context-building questions
134
+ - Nice-to-have insights
135
+ - Future-looking considerations
136
+
137
+ #### C. Research Methodology
138
+
139
+ **Data Collection Methods:**
140
+
141
+ - Secondary research sources
142
+ - Primary research approaches (if applicable)
143
+ - Data quality requirements
144
+ - Source credibility criteria
145
+
146
+ **Analysis Frameworks:**
147
+
148
+ - Specific frameworks to apply
149
+ - Comparison criteria
150
+ - Evaluation methodologies
151
+ - Synthesis approaches
152
+
153
+ #### D. Output Requirements
154
+
155
+ **Format Specifications:**
156
+
157
+ - Executive summary requirements
158
+ - Detailed findings structure
159
+ - Visual/tabular presentations
160
+ - Supporting documentation
161
+
162
+ **Key Deliverables:**
163
+
164
+ - Must-have sections and insights
165
+ - Decision-support elements
166
+ - Action-oriented recommendations
167
+ - Risk and uncertainty documentation
168
+
169
+ ### 4. Prompt Generation
170
+
171
+ **Research Prompt Template:**
172
+
173
+ ```markdown
174
+ ## Research Objective
175
+
176
+ [Clear statement of what this research aims to achieve]
177
+
178
+ ## Background Context
179
+
180
+ [Relevant information from project brief, brainstorming, or other inputs]
181
+
182
+ ## Research Questions
183
+
184
+ ### Primary Questions (Must Answer)
185
+
186
+ 1. [Specific, actionable question]
187
+ 2. [Specific, actionable question]
188
+ ...
189
+
190
+ ### Secondary Questions (Nice to Have)
191
+
192
+ 1. [Supporting question]
193
+ 2. [Supporting question]
194
+ ...
195
+
196
+ ## Research Methodology
197
+
198
+ ### Information Sources
199
+
200
+ - [Specific source types and priorities]
201
+
202
+ ### Analysis Frameworks
203
+
204
+ - [Specific frameworks to apply]
205
+
206
+ ### Data Requirements
207
+
208
+ - [Quality, recency, credibility needs]
209
+
210
+ ## Expected Deliverables
211
+
212
+ ### Executive Summary
213
+
214
+ - Key findings and insights
215
+ - Critical implications
216
+ - Recommended actions
217
+
218
+ ### Detailed Analysis
219
+
220
+ [Specific sections needed based on research type]
221
+
222
+ ### Supporting Materials
223
+
224
+ - Data tables
225
+ - Comparison matrices
226
+ - Source documentation
227
+
228
+ ## Success Criteria
229
+
230
+ [How to evaluate if research achieved its objectives]
231
+
232
+ ## Timeline and Priority
233
+
234
+ [If applicable, any time constraints or phasing]
235
+ ```
236
+
237
+ ### 5. Review and Refinement
238
+
239
+ 1. **Present Complete Prompt**
240
+ - Show the full research prompt
241
+ - Explain key elements and rationale
242
+ - Highlight any assumptions made
243
+
244
+ 2. **Gather Feedback**
245
+ - Are the objectives clear and correct?
246
+ - Do the questions address all concerns?
247
+ - Is the scope appropriate?
248
+ - Are output requirements sufficient?
249
+
250
+ 3. **Refine as Needed**
251
+ - Incorporate user feedback
252
+ - Adjust scope or focus
253
+ - Add missing elements
254
+ - Clarify ambiguities
255
+
256
+ ### 6. Next Steps Guidance
257
+
258
+ **Execution Options:**
259
+
260
+ 1. **Use with AI Research Assistant**: Provide this prompt to an AI model with research capabilities
261
+ 2. **Guide Human Research**: Use as a framework for manual research efforts
262
+ 3. **Hybrid Approach**: Combine AI and human research using this structure
263
+
264
+ **Integration Points:**
265
+
266
+ - How findings will feed into next phases
267
+ - Which team members should review results
268
+ - How to validate findings
269
+ - When to revisit or expand research
270
+
271
+ ## Important Notes
272
+
273
+ - The quality of the research prompt directly impacts the quality of insights gathered
274
+ - Be specific rather than general in research questions
275
+ - Consider both current state and future implications
276
+ - Balance comprehensiveness with focus
277
+ - Document assumptions and limitations clearly
278
+ - Plan for iterative refinement based on initial findings
@@ -0,0 +1,101 @@
1
+ # Create Document from Template (YAML Driven)
2
+
3
+ ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
4
+
5
+ **THIS IS AN EXECUTABLE WORKFLOW - NOT REFERENCE MATERIAL**
6
+
7
+ When this task is invoked:
8
+
9
+ 1. **DISABLE ALL EFFICIENCY OPTIMIZATIONS** - This workflow requires full user interaction
10
+ 2. **MANDATORY STEP-BY-STEP EXECUTION** - Each section must be processed sequentially with user feedback
11
+ 3. **ELICITATION IS REQUIRED** - When `elicit: true`, you MUST use the 1-9 format and wait for user response
12
+ 4. **NO SHORTCUTS ALLOWED** - Complete documents cannot be created without following this workflow
13
+
14
+ **VIOLATION INDICATOR:** If you create a complete document without user interaction, you have violated this workflow.
15
+
16
+ ## Critical: Template Discovery
17
+
18
+ If a YAML Template has not been provided, list all templates from .tfcore/templates or ask the user to provide another.
19
+
20
+ ## CRITICAL: Mandatory Elicitation Format
21
+
22
+ **When `elicit: true`, this is a HARD STOP requiring user interaction:**
23
+
24
+ **YOU MUST:**
25
+
26
+ 1. Present section content
27
+ 2. Provide detailed rationale (explain trade-offs, assumptions, decisions made)
28
+ 3. **STOP and present numbered options 1-9:**
29
+ - **Option 1:** Always "Proceed to next section"
30
+ - **Options 2-9:** Select 8 methods from data/elicitation-methods
31
+ - End with: "Select 1-9 or just type your question/feedback:"
32
+ 4. **WAIT FOR USER RESPONSE** - Do not proceed until user selects option or provides feedback
33
+
34
+ **WORKFLOW VIOLATION:** Creating content for elicit=true sections without user interaction violates this task.
35
+
36
+ **NEVER ask yes/no questions or use any other format.**
37
+
38
+ ## Processing Flow
39
+
40
+ 1. **Parse YAML template** - Load template metadata and sections
41
+ 2. **Set preferences** - Show current mode (Interactive), confirm output file
42
+ 3. **Process each section:**
43
+ - Skip if condition unmet
44
+ - Check agent permissions (owner/editors) - note if section is restricted to specific agents
45
+ - Draft content using section instruction
46
+ - Present content + detailed rationale
47
+ - **IF elicit: true** → MANDATORY 1-9 options format
48
+ - Save to file if possible
49
+ 4. **Continue until complete**
50
+
51
+ ## Detailed Rationale Requirements
52
+
53
+ When presenting section content, ALWAYS include rationale that explains:
54
+
55
+ - Trade-offs and choices made (what was chosen over alternatives and why)
56
+ - Key assumptions made during drafting
57
+ - Interesting or questionable decisions that need user attention
58
+ - Areas that might need validation
59
+
60
+ ## Elicitation Results Flow
61
+
62
+ After user selects elicitation method (2-9):
63
+
64
+ 1. Execute method from data/elicitation-methods
65
+ 2. Present results with insights
66
+ 3. Offer options:
67
+ - **1. Apply changes and update section**
68
+ - **2. Return to elicitation menu**
69
+ - **3. Ask any questions or engage further with this elicitation**
70
+
71
+ ## Agent Permissions
72
+
73
+ When processing sections with agent permission fields:
74
+
75
+ - **owner**: Note which agent role initially creates/populates the section
76
+ - **editors**: List agent roles allowed to modify the section
77
+ - **readonly**: Mark sections that cannot be modified after creation
78
+
79
+ **For sections with restricted access:**
80
+
81
+ - Include a note in the generated document indicating the responsible agent
82
+ - Example: "_(This section is owned by dev-agent and can only be modified by dev-agent)_"
83
+
84
+ ## YOLO Mode
85
+
86
+ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
87
+
88
+ ## CRITICAL REMINDERS
89
+
90
+ **❌ NEVER:**
91
+
92
+ - Ask yes/no questions for elicitation
93
+ - Use any format other than 1-9 numbered options
94
+ - Create new elicitation methods
95
+
96
+ **✅ ALWAYS:**
97
+
98
+ - Use exact 1-9 format when elicit: true
99
+ - Select options 2-9 from data/elicitation-methods only
100
+ - Provide detailed rationale explaining decisions
101
+ - End with "Select 1-9 or just type your question/feedback:"