@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.
- package/.claude/commands/TechieFlow/agents/analyst.md +97 -0
- package/.claude/commands/TechieFlow/agents/architect.md +84 -0
- package/.claude/commands/TechieFlow/agents/flow-master.md +217 -0
- package/.claude/commands/TechieFlow/agents/verifier.md +72 -0
- package/.claude/commands/TechieFlow/tasks/_metrics-emit-gate.md +138 -0
- package/.claude/commands/TechieFlow/tasks/_smoke-test-policy.md +98 -0
- package/.claude/commands/TechieFlow/tasks/_status-update-gate.md +78 -0
- package/.claude/commands/TechieFlow/tasks/_yolo-mode.md +77 -0
- package/.claude/commands/TechieFlow/tasks/advanced-elicitation.md +117 -0
- package/.claude/commands/TechieFlow/tasks/amend-docs.md +149 -0
- package/.claude/commands/TechieFlow/tasks/author-brd.md +79 -0
- package/.claude/commands/TechieFlow/tasks/build-phase.md +231 -0
- package/.claude/commands/TechieFlow/tasks/create-deep-research-prompt.md +278 -0
- package/.claude/commands/TechieFlow/tasks/create-doc.md +101 -0
- package/.claude/commands/TechieFlow/tasks/day1-brownfield.md +507 -0
- package/.claude/commands/TechieFlow/tasks/day1-greenfield.md +224 -0
- package/.claude/commands/TechieFlow/tasks/devguide.md +224 -0
- package/.claude/commands/TechieFlow/tasks/document-project.md +343 -0
- package/.claude/commands/TechieFlow/tasks/execute-checklist.md +86 -0
- package/.claude/commands/TechieFlow/tasks/facilitate-brainstorming-session.md +136 -0
- package/.claude/commands/TechieFlow/tasks/fix-issues.md +134 -0
- package/.claude/commands/TechieFlow/tasks/generate-html.md +115 -0
- package/.claude/commands/TechieFlow/tasks/handoff-phase.md +126 -0
- package/.claude/commands/TechieFlow/tasks/index-docs.md +173 -0
- package/.claude/commands/TechieFlow/tasks/kb-mode-interaction.md +75 -0
- package/.claude/commands/TechieFlow/tasks/log-miss.md +160 -0
- package/.claude/commands/TechieFlow/tasks/metrics-report.md +143 -0
- package/.claude/commands/TechieFlow/tasks/mockups.md +122 -0
- package/.claude/commands/TechieFlow/tasks/productguide.md +105 -0
- package/.claude/commands/TechieFlow/tasks/refresh-status.md +135 -0
- package/.claude/commands/TechieFlow/tasks/render-workflow-docs.md +117 -0
- package/.claude/commands/TechieFlow/tasks/shard-doc.md +185 -0
- package/.claude/commands/TechieFlow/tasks/split-brd.md +131 -0
- package/.claude/commands/TechieFlow/tasks/triage-issues.md +157 -0
- package/.claude/commands/TechieFlow/tasks/verify-phase.md +579 -0
- package/.claude/commands/generate-html.md +124 -0
- package/.codex/config.toml +46 -0
- package/.codex/hooks.json +63 -0
- package/.codex/rules/techieflow.rules +8 -0
- package/.opencode/command/generate-html.md +129 -0
- package/.opencode/plugin/techieflow.js +350 -0
- package/.tfcore/TOKEN-GUIDE.md +59 -0
- package/.tfcore/agents/analyst.md +97 -0
- package/.tfcore/agents/architect.md +84 -0
- package/.tfcore/agents/flow-master.md +217 -0
- package/.tfcore/agents/verifier.md +72 -0
- package/.tfcore/checklists/architect-checklist.md +438 -0
- package/.tfcore/core-config.yaml +47 -0
- package/.tfcore/data/brainstorming-techniques.md +36 -0
- package/.tfcore/data/elicitation-methods.md +154 -0
- package/.tfcore/data/techieflow-kb.md +807 -0
- package/.tfcore/data/technical-preferences.md +3 -0
- package/.tfcore/enhanced-ide-development-workflow.md +248 -0
- package/.tfcore/hooks/block-git.sh +301 -0
- package/.tfcore/hooks/codex-adapter.py +248 -0
- package/.tfcore/hooks/guard-artifacts.sh +101 -0
- package/.tfcore/hooks/guard-status-html.sh +102 -0
- package/.tfcore/hooks/guard-status.sh +124 -0
- package/.tfcore/hooks/guard-verify.sh +108 -0
- package/.tfcore/hooks/metrics-session.sh +129 -0
- package/.tfcore/hooks/session-pointer.sh +52 -0
- package/.tfcore/hooks/sweep-artifacts.sh +198 -0
- package/.tfcore/install-manifest.yaml +231 -0
- package/.tfcore/routing.yaml +105 -0
- package/.tfcore/tasks/_metrics-emit-gate.md +138 -0
- package/.tfcore/tasks/_smoke-test-policy.md +98 -0
- package/.tfcore/tasks/_status-update-gate.md +78 -0
- package/.tfcore/tasks/_yolo-mode.md +77 -0
- package/.tfcore/tasks/advanced-elicitation.md +117 -0
- package/.tfcore/tasks/amend-docs.md +149 -0
- package/.tfcore/tasks/author-brd.md +79 -0
- package/.tfcore/tasks/build-phase.md +231 -0
- package/.tfcore/tasks/create-deep-research-prompt.md +278 -0
- package/.tfcore/tasks/create-doc.md +101 -0
- package/.tfcore/tasks/day1-brownfield.md +507 -0
- package/.tfcore/tasks/day1-greenfield.md +224 -0
- package/.tfcore/tasks/devguide.md +224 -0
- package/.tfcore/tasks/document-project.md +343 -0
- package/.tfcore/tasks/execute-checklist.md +86 -0
- package/.tfcore/tasks/facilitate-brainstorming-session.md +136 -0
- package/.tfcore/tasks/fix-issues.md +134 -0
- package/.tfcore/tasks/generate-html.md +115 -0
- package/.tfcore/tasks/handoff-phase.md +126 -0
- package/.tfcore/tasks/index-docs.md +173 -0
- package/.tfcore/tasks/kb-mode-interaction.md +75 -0
- package/.tfcore/tasks/log-miss.md +160 -0
- package/.tfcore/tasks/metrics-report.md +143 -0
- package/.tfcore/tasks/mockups.md +122 -0
- package/.tfcore/tasks/productguide.md +105 -0
- package/.tfcore/tasks/refresh-status.md +135 -0
- package/.tfcore/tasks/render-workflow-docs.md +117 -0
- package/.tfcore/tasks/shard-doc.md +185 -0
- package/.tfcore/tasks/split-brd.md +131 -0
- package/.tfcore/tasks/triage-issues.md +157 -0
- package/.tfcore/tasks/verify-phase.md +579 -0
- package/.tfcore/telemetry/SCHEMA.md +678 -0
- package/.tfcore/telemetry/install-metrics.sh +390 -0
- package/.tfcore/telemetry/pre-commit +94 -0
- package/.tfcore/telemetry/tf-metrics.sh +1415 -0
- package/.tfcore/templates/architecture-tmpl.yaml +650 -0
- package/.tfcore/templates/brainstorming-output-tmpl.yaml +156 -0
- package/.tfcore/templates/brownfield-architecture-tmpl.yaml +476 -0
- package/.tfcore/templates/competitor-analysis-tmpl.yaml +306 -0
- package/.tfcore/templates/front-end-architecture-tmpl.yaml +218 -0
- package/.tfcore/templates/fullstack-architecture-tmpl.yaml +823 -0
- package/.tfcore/templates/market-research-tmpl.yaml +252 -0
- package/.tfcore/templates/project-brief-tmpl.yaml +221 -0
- package/.tfcore/templates/v4custom/app-agents-md-tmpl.md +61 -0
- package/.tfcore/templates/v4custom/app-architecture-tmpl.md +127 -0
- package/.tfcore/templates/v4custom/app-brd-tmpl.md +204 -0
- package/.tfcore/templates/v4custom/app-checklist-tmpl.md +90 -0
- package/.tfcore/templates/v4custom/app-claude-md-tmpl.md +33 -0
- package/.tfcore/templates/v4custom/app-devguide-tmpl.md +167 -0
- package/.tfcore/templates/v4custom/app-editorconfig-tmpl.editorconfig +44 -0
- package/.tfcore/templates/v4custom/app-library-feedback-tmpl.md +31 -0
- package/.tfcore/templates/v4custom/app-productguide-tmpl.md +54 -0
- package/.tfcore/templates/v4custom/app-project-status-tmpl.md +98 -0
- package/.tfcore/templates/v4custom/app-uidesign-tmpl.md +48 -0
- package/.tfcore/templates/v4custom/app-usageguide-tmpl.md +67 -0
- package/.tfcore/templates/v4custom/build-invocation-ladder.md +190 -0
- package/.tfcore/templates/v4custom/html-render-shell.md +502 -0
- package/.tfcore/templates/v4custom/metrics-report-template.md +273 -0
- package/.tfcore/templates/v4custom/opencode-operating-contract.md +56 -0
- package/.tfcore/user-guide.md +633 -0
- package/.tfcore/utils/techieflow-doc-template.md +325 -0
- package/.tfcore/utils/tf-assets.sh +310 -0
- package/.tfcore/utils/tf-codex-bind.py +196 -0
- package/.tfcore/utils/tf-codex-telemetry.py +60 -0
- package/.tfcore/utils/tf-emit.sh +1075 -0
- package/.tfcore/utils/tf-gitignore-audit.sh +281 -0
- package/.tfcore/utils/tf-goal.sh +421 -0
- package/.tfcore/utils/tf-harness.sh +160 -0
- package/.tfcore/utils/tf-mockup-parity.mjs +555 -0
- package/.tfcore/utils/tf-mockup-parity.sh +65 -0
- package/.tfcore/utils/tf-opencode-audit.py +126 -0
- package/.tfcore/utils/tf-perf.sh +241 -0
- package/.tfcore/utils/tf-render-html.py +715 -0
- package/.tfcore/utils/tf-render-html.sh +28 -0
- package/.tfcore/utils/tf-routing-bind.sh +216 -0
- package/.tfcore/utils/tf-routing.sh +247 -0
- package/.tfcore/utils/tf-yolo.sh +119 -0
- package/.tfcore/working-in-the-brownfield.md +606 -0
- package/LICENSE +201 -0
- package/README.md +1212 -0
- package/WORKFLOW.html +1986 -0
- package/docs/TechieFlow-Installation.md +299 -0
- package/opencode.jsonc +929 -0
- package/package.json +60 -0
- package/scripts/install.mjs +992 -0
- package/scripts/test-install.mjs +505 -0
- 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:"
|