fraim-framework 2.0.55 → 2.0.56

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 (126) hide show
  1. package/dist/registry/ai-manager-rules/customer-development-phases/phase1-customer-profiling.md +101 -0
  2. package/dist/registry/ai-manager-rules/customer-development-phases/phase2-platform-discovery.md +235 -0
  3. package/dist/registry/ai-manager-rules/customer-development-phases/phase3-prospect-qualification.md +243 -0
  4. package/dist/registry/ai-manager-rules/customer-development-phases/phase4-inventory-compilation.md +206 -0
  5. package/dist/registry/ai-manager-rules/user-survey-phases/phase1-survey-scoping.md +60 -0
  6. package/dist/registry/ai-manager-rules/user-survey-phases/phase2-survey-build-linkedin.md +23 -0
  7. package/dist/registry/ai-manager-rules/user-survey-phases/phase3-survey-build-reddit.md +22 -0
  8. package/dist/registry/ai-manager-rules/user-survey-phases/phase4-survey-build-x.md +21 -0
  9. package/dist/registry/ai-manager-rules/user-survey-phases/phase5-survey-build-facebook.md +19 -0
  10. package/dist/registry/ai-manager-rules/user-survey-phases/phase6-survey-build-custom.md +15 -0
  11. package/dist/registry/ai-manager-rules/user-survey-phases/phase7-survey-dispatch.md +45 -0
  12. package/dist/registry/templates/bootstrap/ARCHITECTURE-TEMPLATE.md +53 -0
  13. package/dist/registry/templates/bootstrap/CODE-QUALITY-REPORT-TEMPLATE.md +37 -0
  14. package/dist/registry/templates/bootstrap/TEST-COVERAGE-REPORT-TEMPLATE.md +35 -0
  15. package/dist/registry/templates/business-development/IDEATION-REPORT-TEMPLATE.md +29 -0
  16. package/dist/registry/templates/business-development/PRICING-STRATEGY-TEMPLATE.md +126 -0
  17. package/dist/registry/templates/customer-development/customer-interview-template.md +99 -0
  18. package/dist/registry/templates/customer-development/customer-persona-template.md +69 -0
  19. package/dist/registry/templates/customer-development/follow-up-email-templates.md +132 -0
  20. package/dist/registry/templates/customer-development/insight-analysis-template.md +74 -0
  21. package/dist/registry/templates/customer-development/prospect-inventory-template.csv +3 -0
  22. package/dist/registry/templates/customer-development/search-strategy-template.md +123 -0
  23. package/dist/registry/templates/customer-development/strategic-recommendations-template.md +53 -0
  24. package/dist/registry/templates/customer-development/thank-you-email-template.html +124 -0
  25. package/dist/registry/templates/customer-development/thank-you-note-template.md +16 -0
  26. package/dist/registry/templates/customer-development/triage-log-template.md +278 -0
  27. package/dist/registry/templates/customer-development/weekly-newsletter-template.html +204 -0
  28. package/dist/registry/templates/evidence/Design-Evidence.md +30 -0
  29. package/dist/registry/templates/evidence/Implementation-BugEvidence.md +94 -0
  30. package/dist/registry/templates/evidence/Implementation-FeatureEvidence.md +129 -0
  31. package/dist/registry/templates/evidence/Spec-Evidence.md +19 -0
  32. package/dist/registry/templates/help/HelpNeeded.md +14 -0
  33. package/dist/registry/templates/legal/NDA-TEMPLATE.md +170 -0
  34. package/dist/registry/templates/legal/PATENT-TEMPLATE.md +372 -0
  35. package/dist/registry/templates/legal/TRADEMARK-TEMPLATE.md +339 -0
  36. package/dist/registry/templates/legal/contract-review-checklist.md +193 -0
  37. package/dist/registry/templates/legal/review-report-template.md +198 -0
  38. package/dist/registry/templates/legal/saas-terms-template.md +174 -0
  39. package/dist/registry/templates/legal/sow-template.md +117 -0
  40. package/dist/registry/templates/legal/template-variables.md +131 -0
  41. package/dist/registry/templates/marketing/DOMAIN-REGISTRATION-TEMPLATE.md +194 -0
  42. package/dist/registry/templates/marketing/HBR-ARTICLE-TEMPLATE.md +66 -0
  43. package/dist/registry/templates/marketing/STORYTELLING-TEMPLATE.md +130 -0
  44. package/dist/registry/templates/marketing/WEBSITE-TEMPLATE.md +262 -0
  45. package/dist/registry/templates/marketing/github-pages-workflow.yml +64 -0
  46. package/dist/registry/templates/replicate/implementation-checklist.md +39 -0
  47. package/dist/registry/templates/replicate/use-cases-template.md +88 -0
  48. package/dist/registry/templates/retrospective/RETROSPECTIVE-TEMPLATE.md +55 -0
  49. package/dist/registry/templates/specs/BUGSPEC-TEMPLATE.md +37 -0
  50. package/dist/registry/templates/specs/FEATURESPEC-TEMPLATE.md +66 -0
  51. package/dist/registry/templates/specs/TECHSPEC-TEMPLATE.md +39 -0
  52. package/dist/registry/workflows/bootstrap/create-architecture.md +38 -0
  53. package/dist/registry/workflows/bootstrap/detect-broken-windows.md +300 -0
  54. package/dist/registry/workflows/bootstrap/evaluate-code-quality.md +35 -0
  55. package/dist/registry/workflows/bootstrap/verify-test-coverage.md +36 -0
  56. package/dist/registry/workflows/brainstorming/blue-sky-brainstorming.md +211 -0
  57. package/dist/registry/workflows/brainstorming/codebase-brainstorming.md +165 -0
  58. package/dist/registry/workflows/business-development/create-business-plan.md +737 -0
  59. package/dist/registry/workflows/business-development/ideate-business-opportunity.md +55 -0
  60. package/dist/registry/workflows/business-development/price-product.md +325 -0
  61. package/dist/registry/workflows/compliance/detect-compliance-requirements.md +78 -0
  62. package/dist/registry/workflows/compliance/generate-audit-evidence.md +75 -0
  63. package/dist/registry/workflows/compliance/soc2-evidence-generator.md +332 -0
  64. package/dist/registry/workflows/customer-development/insight-analysis.md +156 -0
  65. package/dist/registry/workflows/customer-development/insight-triage.md +938 -0
  66. package/dist/registry/workflows/customer-development/interview-preparation.md +452 -0
  67. package/dist/registry/workflows/customer-development/linkedin-outreach.md +593 -0
  68. package/dist/registry/workflows/customer-development/strategic-brainstorming.md +146 -0
  69. package/dist/registry/workflows/customer-development/thank-customers.md +203 -0
  70. package/dist/registry/workflows/customer-development/user-survey-dispatch.md +60 -0
  71. package/dist/registry/workflows/customer-development/users-to-target.md +112 -0
  72. package/dist/registry/workflows/customer-development/weekly-newsletter.md +366 -0
  73. package/dist/registry/workflows/deploy/cloud-deployment.md +310 -0
  74. package/dist/registry/workflows/improve-fraim/contribute.md +32 -0
  75. package/dist/registry/workflows/improve-fraim/file-issue.md +32 -0
  76. package/dist/registry/workflows/learning/build-skillset.md +212 -0
  77. package/dist/registry/workflows/learning/synthesize-learnings.md +284 -0
  78. package/dist/registry/workflows/legal/contract-review-analysis.md +382 -0
  79. package/dist/registry/workflows/legal/nda.md +69 -0
  80. package/dist/registry/workflows/legal/patent-filing.md +76 -0
  81. package/dist/registry/workflows/legal/saas-contract-development.md +213 -0
  82. package/dist/registry/workflows/legal/trademark-filing.md +77 -0
  83. package/dist/registry/workflows/marketing/content-creation.md +37 -0
  84. package/dist/registry/workflows/marketing/convert-to-pdf.md +235 -0
  85. package/dist/registry/workflows/marketing/create-modern-website.md +456 -0
  86. package/dist/registry/workflows/marketing/domain-registration.md +323 -0
  87. package/dist/registry/workflows/marketing/hbr-article.md +73 -0
  88. package/dist/registry/workflows/marketing/launch-checklist.md +37 -0
  89. package/dist/registry/workflows/marketing/marketing-strategy.md +45 -0
  90. package/dist/registry/workflows/marketing/storytelling.md +65 -0
  91. package/dist/registry/workflows/performance/analyze-performance.md +65 -0
  92. package/dist/registry/workflows/product-building/design.md +103 -0
  93. package/dist/registry/workflows/product-building/implement.md +74 -0
  94. package/dist/registry/workflows/product-building/iterate-on-pr-comments.md +70 -0
  95. package/dist/registry/workflows/product-building/prep-issue.md +41 -0
  96. package/dist/registry/workflows/product-building/prototype.md +65 -0
  97. package/dist/registry/workflows/product-building/resolve.md +168 -0
  98. package/dist/registry/workflows/product-building/retrospect.md +86 -0
  99. package/dist/registry/workflows/product-building/spec.md +181 -0
  100. package/dist/registry/workflows/product-building/test.md +125 -0
  101. package/dist/registry/workflows/productivity-report/productivity-report.md +263 -0
  102. package/dist/registry/workflows/quality-assurance/browser-validation.md +221 -0
  103. package/dist/registry/workflows/quality-assurance/iterative-improvement-cycle.md +562 -0
  104. package/dist/registry/workflows/replicate/replicate-discovery.md +336 -0
  105. package/dist/registry/workflows/replicate/replicate-to-issues.md +324 -0
  106. package/dist/registry/workflows/reviewer/review-implementation-vs-design-spec.md +638 -0
  107. package/dist/registry/workflows/reviewer/review-implementation-vs-feature-spec.md +675 -0
  108. package/dist/registry/workflows/startup-credits/aws-activate-application.md +535 -0
  109. package/dist/registry/workflows/startup-credits/google-cloud-application.md +647 -0
  110. package/dist/registry/workflows/startup-credits/microsoft-azure-application.md +538 -0
  111. package/dist/src/ai-manager/ai-manager.js +4 -6
  112. package/dist/tests/test-users-to-target-workflow.js +2 -2
  113. package/package.json +1 -1
  114. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase1-customer-profiling.md +0 -11
  115. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase1-survey-scoping.md +0 -11
  116. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase2-platform-discovery.md +0 -11
  117. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase2-survey-build-linkedin.md +0 -11
  118. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase3-prospect-qualification.md +0 -11
  119. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase3-survey-build-reddit.md +0 -11
  120. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase4-inventory-compilation.md +0 -11
  121. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase4-survey-build-x.md +0 -11
  122. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase5-survey-build-facebook.md +0 -11
  123. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase6-survey-build-custom.md +0 -11
  124. package/registry/stubs/workflows/customer-development/ai-coach-phases/phase7-survey-dispatch.md +0 -11
  125. package/registry/stubs/workflows/customer-development/templates/customer-persona-template.md +0 -11
  126. package/registry/stubs/workflows/customer-development/templates/search-strategy-template.md +0 -11
@@ -0,0 +1,323 @@
1
+ # Workflow: domain-registration
2
+
3
+ **Path:** `workflows/marketing/domain-registration.md`
4
+
5
+ ---
6
+
7
+ # Domain Registration Research & Analysis
8
+
9
+ ## INTENT
10
+ To systematically research, evaluate, and recommend domain names for the product, including competitive pricing analysis across major registrars and structured decision-making templates.
11
+
12
+ ## PRINCIPLES
13
+ - **Brand Alignment**: Domain should reflect the product's core value proposition
14
+ - **Memorability**: Easy to remember, spell, and share
15
+ - **SEO Consideration**: Consider keyword relevance and search optimization
16
+ - **Future-Proofing**: Consider scalability and brand evolution
17
+ - **Cost Efficiency**: Balance quality with budget constraints
18
+
19
+ ## DOMAIN RESEARCH WORKFLOW
20
+
21
+ ### Step 1: Product Analysis & Brainstorming
22
+ **Objective**: Generate a comprehensive list of potential domain names
23
+
24
+ **Actions**:
25
+ 1. **Product Context Review**
26
+ - Review product documentation, value proposition, and target audience
27
+ - Identify core keywords, benefits, and brand attributes
28
+ - Note any existing brand guidelines or naming conventions
29
+
30
+ 2. **Domain Name Brainstorming**
31
+ - **COLLABORATIVE APPROACH**: Always brainstorm WITH the stakeholder, not independently
32
+ - Generate 20-30 initial domain ideas using various approaches:
33
+ - **Direct naming**: Product name + common TLDs
34
+ - **Descriptive**: What the product does (e.g., taskmanager.com)
35
+ - **Invented words**: Brandable made-up names (e.g., fraim.ai)
36
+ - **Compound words**: Combining relevant terms (e.g., fraimworks.ai)
37
+ - **Abbreviated**: Acronyms or shortened versions
38
+ - **Alternative TLDs**: .ai, .io, .co, .app, .dev, etc.
39
+ - **Playful variations**: Slogan-style domains (e.g., justfraimit.ai)
40
+ - **Ask for user suggestions** and explore their creative ideas
41
+ - **Discuss trade-offs** between different naming approaches in real-time
42
+
43
+ 3. **Initial Filtering**
44
+ - Remove obviously unavailable domains (major brands, common words)
45
+ - Filter for length (ideally 6-12 characters)
46
+ - Ensure pronunciation clarity
47
+ - Check for negative connotations or meanings in other languages
48
+
49
+ **Output**: List of 15-20 candidate domain names
50
+
51
+ ### Step 2: Availability & Trademark Check
52
+ **Objective**: Verify legal availability and reduce list to viable options
53
+
54
+ **Actions**:
55
+ 1. **Domain Availability Check**
56
+ - Use multiple domain checkers (Namecheap, GoDaddy, Domain.com)
57
+ - Check primary TLD (.com) and relevant alternatives (.ai, .io, .co)
58
+ - Note premium domains and their asking prices
59
+
60
+ 2. **Trademark Research**
61
+ - **CRITICAL**: Search for existing businesses using similar names, not just trademarks
62
+ - Search USPTO trademark database for exact and similar marks
63
+ - **Google search for existing companies** using the domain name or similar variations
64
+ - Check domain ownership history (WHOIS data) for active businesses
65
+ - **Industry-specific conflicts**: Pay special attention to businesses in the same sector
66
+ - Check international trademark databases for key markets
67
+ - **Document specific conflicts found** with business names, URLs, and risk assessment
68
+ - Check social media handle availability (@username on major platforms)
69
+
70
+ 3. **Competitive Analysis**
71
+ - Research competitors' domain strategies
72
+ - Note industry naming patterns and trends
73
+ - Identify potential conflicts or confusion risks
74
+
75
+ **Output**: Narrowed list of 5-8 legally available domains
76
+
77
+ ### Step 3: Registrar Price Comparison
78
+ **Objective**: Compare pricing across major registrars for informed purchasing decisions
79
+
80
+ **Actions**:
81
+ 1. **Browser-Based Price Research**
82
+ - **CRITICAL**: Always verify pricing by navigating to actual registrar websites
83
+ - **Do not rely on estimates** - pricing can vary significantly from published rates
84
+ - Open browser and systematically check each domain across registrars:
85
+ - **Namecheap**: Check actual search results for verified pricing and renewal rates
86
+ - **GoDaddy**: Check standard and premium pricing, note promotional vs. renewal rates
87
+ - **IONOS**: Check their domain search for competitive pricing
88
+ - **Google Domains/Squarespace**: Check integrated services pricing
89
+ - **Cloudflare**: Check their registrar pricing
90
+ - **Domain.com**: Check promotional offers
91
+ - **Porkbun**: Check competitive pricing options
92
+
93
+ 2. **Pricing Matrix Creation**
94
+ - **Document verified pricing only** - mark estimates clearly as "estimated"
95
+ - **Focus on 2-year total cost** - many domains require minimum 2-year registration
96
+ - Note first-year promotional pricing vs. standard renewal rates
97
+ - Document included services (privacy protection, email, etc.)
98
+ - Check for bulk discounts or multi-year savings
99
+ - Document any premium domain pricing or auction details
100
+ - **Include additional fees**: Domain Guard/protection services, setup fees
101
+
102
+ 3. **Service Comparison**
103
+ - DNS management capabilities
104
+ - Email hosting options
105
+ - SSL certificate inclusion
106
+ - Domain privacy protection (often free vs. paid)
107
+ - Transfer policies and fees
108
+ - Customer support quality ratings
109
+ - **Minimum registration periods** (especially important for .ai domains)
110
+
111
+ ### Step 6: Domain Registration Process
112
+ **Objective**: Complete the actual domain purchase with proper configuration
113
+
114
+ **Actions**:
115
+ 1. **Pre-Registration Checklist**
116
+ - Confirm final domain choice with stakeholders
117
+ - Verify budget approval for total cost (including protection services)
118
+ - Prepare registration information (contact details, business info)
119
+ - Decide on additional services (privacy protection, email, hosting)
120
+
121
+ 2. **Registration Process**
122
+ - Navigate to chosen registrar's website
123
+ - Search for the exact domain name to confirm availability and pricing
124
+ - **Verify pricing matches research** - if different, document discrepancies
125
+ - Add domain to cart and review all included/additional services
126
+ - **Review minimum registration periods** (especially for .ai domains)
127
+ - Consider domain protection services (Domain Guard, privacy protection)
128
+ - Proceed through checkout process but **stop before payment**
129
+
130
+ 3. **Final Review & Approval**
131
+ - Document final pricing including all fees and services
132
+ - Confirm registration period and renewal dates
133
+ - Get final stakeholder approval for total cost
134
+ - Complete payment and registration
135
+ - **Save confirmation details** and login credentials securely
136
+
137
+ **Output**: Successfully registered domain with proper configuration
138
+
139
+ ### Step 7: Post-Registration Setup
140
+ ### Step 5: Final Analysis & Recommendations
141
+ **Objective**: Complete evaluation matrix and provide structured recommendations
142
+
143
+ **Actions**:
144
+ 1. **Scoring Matrix Completion**
145
+ - Rate each viable domain (1-10) on all criteria in template
146
+ - Calculate total scores and rank options
147
+ - Document detailed evaluation notes for top candidates
148
+
149
+ 2. **Risk Assessment Documentation**
150
+ - Complete legal, business, and technical risk sections
151
+ - Provide specific mitigation plans for identified risks
152
+ - Assess implementation complexity and timeline
153
+ - **Document specific trademark conflicts** and business risks found
154
+
155
+ 3. **Final Recommendations**
156
+ - Select primary, alternative, and backup domain options
157
+ - Complete budget summary with **verified 2-year cost projections**
158
+ - Create implementation plan with specific action items
159
+ - Prepare stakeholder approval section
160
+ - **Include trademark clearance requirements** if any conflicts found
161
+
162
+ **Output**: Complete domain analysis with final recommendations ready for stakeholder review
163
+ - Select primary, alternative, and backup domain options
164
+ - Complete budget summary with 3-year cost projections
165
+ - Create implementation plan with specific action items
166
+ - Prepare stakeholder approval section
167
+
168
+ **Output**: Complete domain analysis with final recommendations ready for stakeholder review
169
+
170
+ ### Step 7: Post-Registration Setup
171
+ **Objective**: Configure domain for immediate use and long-term management
172
+
173
+ **Actions**:
174
+ 1. **Essential Configuration**
175
+ - Configure DNS settings for immediate use
176
+ - Set up domain privacy protection if not already enabled
177
+ - Configure email forwarding or professional email accounts
178
+ - Set up SSL certificate if hosting is immediate
179
+ - Document all login credentials and account information securely
180
+
181
+ 2. **Business Integration**
182
+ - Update business documentation with new domain
183
+ - Configure domain forwarding from old domain if applicable
184
+ - Update marketing materials and business cards
185
+ - Set up Google Analytics and Search Console for new domain
186
+ - Configure social media profiles with new domain
187
+
188
+ 3. **Long-term Management**
189
+ - Set up renewal reminders (60-90 days before expiration)
190
+ - Document renewal dates and costs in business calendar
191
+ - Set up monitoring for domain expiration and DNS issues
192
+ - Create backup contact information for domain management
193
+ - Plan for potential domain expansion (subdomains, additional TLDs)
194
+
195
+ **Output**: Fully configured domain ready for business use with proper management systems in place
196
+
197
+ ### Step 4: Document Creation & Analysis
198
+ **Objective**: Create comprehensive domain analysis document using the standard template
199
+
200
+ **Actions**:
201
+ 1. **Template Setup**
202
+ - Retrieve the Domain Registration template: `get_fraim_file({ path: "templates/marketing/DOMAIN-REGISTRATION-TEMPLATE.md" })`
203
+ - Create analysis document at: `docs/marketing/domain-analysis/{YYYY-MM-DD}-{kebab-case-title}.md`
204
+ - Fill in all template sections systematically
205
+
206
+ 2. **Product Context Documentation**
207
+ - Complete product analysis section with current brand attributes
208
+ - Define budget parameters and timeline requirements
209
+ - Identify required vs. nice-to-have TLD extensions
210
+
211
+ 3. **Domain Research Documentation**
212
+ - Document all brainstormed domain options in organized categories
213
+ - Record availability status for each option
214
+ - Note any premium pricing or special conditions
215
+
216
+ **Output**: Structured analysis document with complete product context and domain research
217
+
218
+ ## TEMPLATE & OUTPUT LOCATIONS
219
+
220
+ ### Required Template
221
+ Use the Domain Registration Analysis template: `get_fraim_file({ path: "templates/marketing/DOMAIN-REGISTRATION-TEMPLATE.md" })`
222
+
223
+ ### Output Location
224
+ **Primary Document**: `docs/marketing/domain-analysis/{YYYY-MM-DD}-{kebab-case-title}.md`
225
+ - Example: `docs/marketing/domain-analysis/2026-01-23-fraim-domain-research.md`
226
+ - Example: `docs/marketing/domain-analysis/2026-01-23-product-rebrand-domains.md`
227
+
228
+
229
+ ## EXECUTION CHECKLIST
230
+
231
+ ### Pre-Research
232
+ - [ ] Gather product documentation and brand guidelines
233
+ - [ ] Define budget parameters and timeline
234
+ - [ ] Identify key stakeholders for final approval
235
+ - [ ] **Schedule collaborative brainstorming session** with stakeholders
236
+
237
+ ### Research Phase
238
+ - [ ] Complete product analysis with stakeholder input
239
+ - [ ] **Conduct collaborative brainstorming session** - do not work independently
240
+ - [ ] Generate initial list of 20-30 domain ideas together
241
+ - [ ] Filter to 15-20 viable candidates
242
+ - [ ] Check availability across multiple registrars
243
+ - [ ] **Conduct thorough trademark and business conflict research**
244
+ - [ ] Narrow to 5-8 available options with no major conflicts
245
+
246
+ ### Analysis Phase
247
+ - [ ] **Open browser and verify actual pricing** at each registrar
248
+ - [ ] **Do not rely on estimates** - get verified pricing only
249
+ - [ ] Create comprehensive pricing matrix with **2-year total costs**
250
+ - [ ] Document service comparisons and features
251
+ - [ ] **Note minimum registration periods** and additional fees
252
+ - [ ] Complete scoring matrix for each domain
253
+ - [ ] **Document specific trademark conflicts** and legal considerations
254
+
255
+ ### Recommendation Phase
256
+ - [ ] Prepare final recommendation report with **verified pricing**
257
+ - [ ] Create implementation timeline
258
+ - [ ] Calculate total cost of ownership including protection services
259
+ - [ ] **Include trademark clearance requirements** if needed
260
+ - [ ] Present findings to stakeholders
261
+ - [ ] Secure approval for domain purchase
262
+
263
+ ### Registration Phase
264
+ - [ ] **Navigate to chosen registrar and verify final pricing**
265
+ - [ ] Add domain to cart and review all services
266
+ - [ ] **Get final approval for total cost** including all fees
267
+ - [ ] Complete registration process
268
+ - [ ] **Save all confirmation details and credentials securely**
269
+
270
+ ### Post-Registration
271
+ - [ ] Configure essential DNS and privacy settings
272
+ - [ ] Set up email forwarding or professional email
273
+ - [ ] Update business documentation with new domain
274
+ - [ ] **Set up renewal reminders** (60-90 days before expiration)
275
+ - [ ] Configure monitoring and backup management contacts
276
+
277
+ ## SUCCESS METRICS
278
+ - **Speed**: Complete research and recommendation within 2-3 business days
279
+ - **Thoroughness**: Evaluate at least 5 viable domain options with verified pricing
280
+ - **Cost Efficiency**: Identify savings opportunities across registrars with actual pricing
281
+ - **Risk Mitigation**: Zero trademark or legal conflicts through comprehensive research
282
+ - **Stakeholder Satisfaction**: Clear, actionable recommendations with rationale
283
+ - **Collaborative Process**: Stakeholder actively involved in brainstorming and decision-making
284
+
285
+ ## CRITICAL LESSONS LEARNED
286
+
287
+ ### Pricing Verification
288
+ - **Never rely on estimated pricing** - always verify by navigating to actual registrar websites
289
+ - **Focus on 2-year total costs** - many premium domains (.ai, .io) require minimum 2-year registration
290
+ - **Include all fees** - domain protection services, setup fees, and renewal rate increases
291
+ - **Promotional vs. renewal pricing** - first-year discounts can be misleading for long-term costs
292
+
293
+ ### Trademark Research
294
+ - **Search for existing businesses**, not just trademark registrations
295
+ - **Industry-specific conflicts** are critical - same sector businesses pose higher risk
296
+ - **Document specific conflicts** found with business names, URLs, and risk levels
297
+ - **Different industries may have lower risk** - business consulting vs. AI development tools
298
+
299
+ ### Collaborative Process
300
+ - **Always brainstorm WITH stakeholders** - never work independently on creative naming
301
+ - **User suggestions often lead to better options** - be open to their creative input
302
+ - **Explain trade-offs in real-time** - help stakeholders understand naming implications
303
+ - **Get approval at each major decision point** - pricing, trademark risks, final selection
304
+
305
+ ### Registration Process
306
+ - **Verify pricing at checkout** - registrar pricing can differ from search results
307
+ - **Review all included services** - privacy protection, domain guard, email options
308
+ - **Understand minimum registration periods** - especially important for .ai domains
309
+ - **Save all credentials securely** - registration confirmations, login details, renewal dates
310
+
311
+ ## OUTPUT DELIVERABLES
312
+ All deliverables should be saved in the designated output location: `docs/marketing/domain-analysis/{YYYY-MM-DD}-{kebab-case-title}.md`
313
+
314
+ 1. **Complete Domain Analysis Document** - Using the standard template with all sections filled
315
+ 2. **Pricing Comparison Matrix** - Detailed registrar analysis (included in main document)
316
+ 3. **Risk Assessment Report** - Legal and business risk evaluation (included in main document)
317
+ 4. **Implementation Plan** - Step-by-step execution timeline (included in main document)
318
+ 5. **Stakeholder Approval Section** - Ready for decision-maker review (included in main document)
319
+
320
+ **File Naming Examples**:
321
+ - `docs/marketing/domain-analysis/2026-01-23-fraim-domain-research.md`
322
+ - `docs/marketing/domain-analysis/2026-01-23-product-rebrand-domains.md`
323
+ - `docs/marketing/domain-analysis/2026-01-23-new-feature-subdomain.md`
@@ -0,0 +1,73 @@
1
+ # Workflow: hbr-article
2
+
3
+ **Path:** `workflows/marketing/hbr-article.md`
4
+
5
+ ---
6
+
7
+ # Harvard Business Review Article Phase
8
+
9
+ ## INTENT
10
+ Design a repeatable reviewable process for researching, drafting, and submitting an HBR or similar thought-leadership article that follows the Harvard Business Review author guidelines and documents each review before publication.
11
+
12
+ ## PRINCIPLES
13
+ - **Strategy First** – Explain why the piece matters to HBR readers and how it advances the product roadmap.
14
+ - **Evidence-Led Storytelling** – Back every claim with customer insights, data, or experiments and include proper citations.
15
+ - **Executive Clarity** – Keep the tone structured, concise, and professional while still being compelling.
16
+ - **Review Discipline** – Require sign-offs during every milestone so the article progresses with confidence.
17
+
18
+ ## HARVARD BUSINESS REVIEW GUIDELINES SUMMARY
19
+ - **Audience & Outcome**: HBR serves ambitious senior leaders with rigorous, evidence-backed insights they can apply today.
20
+ - **Topic Scope**: Strategy, leadership, culture, operations, technology change, innovation, communication, decision-making, talent, and transitions.
21
+ - **Five Quality Criteria**: Expertise, evidence, originality (or a counterintuitive twist), practical usefulness, and excellent writing.
22
+ - **Responsible Storytelling**: Represent diverse organizations, avoid bias/stereotypes, disclose conflicts, and explain any generative AI usage.
23
+ - **Pitch Checklist** (covered during Step 2 and in the template): central message, importance/counterintuition, novelty, leader application, authority/backing, supporting research/examples, and relevant experiences.
24
+
25
+ ## HBR ARTICLE WORKFLOW
26
+
27
+ ### Step 1: Confirm the story belongs with HBR
28
+ - Articulate the insight, the proposed HBR section (Strategy, Leadership, Technology, etc.), and why the timing is right.
29
+ - Cite the HBR guidelines (https://hbr.org/guidelines-for-authors) for exclusivity, word count, bylines, and conflict-of-interest disclosures.
30
+ - Document how the story ties to the product roadmap, clarify the customer problem, and capture any embargo or exclusivity constraints with marketing and executive reviewers.
31
+
32
+ ### Step 2: Research & angle sharpening
33
+ - Gather customer data, experiments, interviews, or telemetry that demonstrate the thesis.
34
+ - Review two recent HBR pieces in the target section to understand structure, tone, and citation style.
35
+ - Identify outstanding sourcing needs (people, metrics, visuals) and schedule them before drafting.
36
+ - Use the HBR prompts to refine the story:
37
+ - What is the central message of the article?
38
+ - Why is it important, useful, or counterintuitive?
39
+ - What is new about the idea?
40
+ - Why do senior leaders need to know about it today, and how can they apply it?
41
+ - What is the source of the team’s authority (prior work, credentials, experience)?
42
+ - What research or examples will back the idea?
43
+ - What academic, professional, or personal experience will you draw on?
44
+
45
+ ### Step 3: Outline and structure guardrails
46
+ - Draft an outline covering:
47
+ - Hook and problem framing
48
+ - Diagnostic/evidence blocks (data, quotes, frameworks)
49
+ - Practice-ready recommendation and product-specific next steps
50
+ - Annotate each section with required references and attachments.
51
+ - Share the outline with product and marketing reviewers, collect feedback, and incorporate it prior to drafting.
52
+
53
+ ### Step 4: Draft, iterate, and polish
54
+ - Adhere to HBR word limits and formatting expectations; note disclosures, partnerships, or competing interests directly in the draft.
55
+ - Run two review passes: one focused on clarity (peer reviewer) and one on strategic voice (executive reviewer).
56
+ - Track edits through versioned drafts, doc comments, or PR history and finalize the headline/angle with the marketing lead.
57
+ - Capture approvals for accuracy, voice, and compliance before locking the draft.
58
+
59
+ ### Step 5: Finalize submission + collateral
60
+ - Verify the draft satisfies the HBR checklist (tone, length, references, conflicts) and secure the final sign-off.
61
+ - Draft the submission email (subject line, synopsis, attachments) and log it in `docs/marketing/hbr/submission-log.md` or an equivalent tracking document.
62
+ - Plan accompanying collateral (blog post, newsletter snippet, executive update) that repurposes the article's insight and assign owners.
63
+ - Note follow-up steps for publication tracking and audience engagement.
64
+
65
+ ## OUTPUT
66
+ - Thesis/angle memo that explains the fit for HBR.
67
+ - Approved outline and draft with reviewer notes and version history.
68
+ - Submission package (email, attachments, compliance checklist).
69
+ - Launch collateral plan with asset owners and delivery status.
70
+
71
+ ## DOCUMENT TEMPLATE STRUCTURE
72
+
73
+ Use `get_fraim_file({ path: "templates/marketing/HBR-ARTICLE-TEMPLATE.md" })` to capture the thesis, outline, draft, review log, submission log, and launch collateral plan for each HBR article.
@@ -0,0 +1,37 @@
1
+ # Workflow: launch-checklist
2
+
3
+ **Path:** `workflows/marketing/launch-checklist.md`
4
+
5
+ ---
6
+
7
+ # Launch Checklist Phase
8
+
9
+ ## INTENT
10
+ To ensure a smooth and successful feature launch by systematically verifying all marketing, technical, and operational readiness.
11
+
12
+ ## PRINCIPLES
13
+ - **Meticulous Preparation**: Leave no stone unturned before launch.
14
+ - **Cross-Functional Alignment**: Ensure all teams are ready for the launch.
15
+ - **Timely Execution**: Follow the schedule for maximum impact.
16
+ - **Post-Launch Verification**: Monitor performance and address issues immediately.
17
+
18
+ ## LAUNCH CHECKLIST WORKFLOW
19
+
20
+ ### Step 1: Readiness Check
21
+ - Is the feature deployed and verified?
22
+ - Are the marketing assets ready?
23
+ - Is the support team briefed?
24
+
25
+ ### Step 2: Launch Execution
26
+ - Post to social channels.
27
+ - Send announcement emails.
28
+ - Update documentation.
29
+
30
+ ### Step 3: Post-Launch Monitoring
31
+ - Check for user feedback.
32
+ - Monitor error rates.
33
+ - Engagement metrics.
34
+
35
+ ## OUTPUT
36
+ - Launch Status Report
37
+ - Post-Launch Feedback Summary
@@ -0,0 +1,45 @@
1
+ # Workflow: marketing-strategy
2
+
3
+ **Path:** `workflows/marketing/marketing-strategy.md`
4
+
5
+ ---
6
+
7
+ # Marketing Strategy Phase
8
+
9
+ ## INTENT
10
+ To define the value proposition, target audience, and launch strategy for new features, ensuring clear communication of benefits and effective market entry.
11
+
12
+ ## PRINCIPLES
13
+ - **Value-First**: Focus on the problem solved and the value delivered.
14
+ - **Audience-Centric**: Identify exactly who the feature is for.
15
+ - **Clear Messaging**: Ensure simplicity and clarity in all marketing materials.
16
+ - **Channel Alignment**: Choose appropriate channels for the target audience.
17
+
18
+ ## MARKETING STRATEGY WORKFLOW
19
+
20
+ ### Step 1: Feature Analysis
21
+ - What is the core problem being solved?
22
+ - What are the key benefits?
23
+ - Who is the primary persona?
24
+
25
+ ### Step 2: Value Proposition Definition
26
+ - Draft 1-2 sentences describing the feature's value.
27
+ - Identify the "Hero" benefit.
28
+
29
+ ### Step 3: Target Audience Identification
30
+ - Define the specific segment of users this is for.
31
+ - Identify there pain points.
32
+
33
+ ### Step 4: Channel Strategy
34
+ - Where will we announce this? (Twitter, LinkedIn, Email, In-app)
35
+ - What is the tone for each channel?
36
+
37
+ ### Step 5: Marketing Brief Creation
38
+ - Create a `docs/marketing/strategy/{issue_number}-{feature-name}.md`
39
+ - Use `MARKETING-STRATEGY-TEMPLATE.md`
40
+
41
+ ## OUTPUT
42
+ - Marketing Strategy Doc
43
+ - Value Prop
44
+ - Target Audience
45
+ - Launch Checklist status
@@ -0,0 +1,65 @@
1
+ # Workflow: storytelling
2
+
3
+ **Path:** `workflows/marketing/storytelling.md`
4
+
5
+ ---
6
+
7
+ # Marketing Storytelling Workflow
8
+
9
+ ## INTENT
10
+ To transform product development experiences into compelling founder narratives for events, conferences, and speaking opportunities that connect technical reality with broadly applicable lessons.
11
+
12
+ ## PRINCIPLES
13
+ - **Grounded in Reality**: All narratives based on actual product development experiences
14
+ - **Story Arc Focus**: Follow intent → friction → insight → outcome structure
15
+ - **Audience-Specific**: Tailor messaging to event type and audience expectations
16
+ - **Authentic Voice**: Avoid sales pitch tone, focus on genuine founder lessons
17
+
18
+ ## STORYTELLING WORKFLOW
19
+
20
+ ### Step 1: Artifact Collection
21
+ Gather source materials that tell the product development story:
22
+ - Product documentation (specs, architecture notes, design docs)
23
+ - Development retrospectives or post-mortems
24
+ - Code repositories and key commits
25
+ - Prior pitches, emails, or presentations
26
+
27
+ ### Step 2: Story Arc Extraction
28
+ Extract the core narrative following the story structure:
29
+ - **Intent**: What was the original vision and why it mattered?
30
+ - **Friction**: What unexpected challenges or failures occurred?
31
+ - **Insight**: What key learnings or "aha moments" emerged?
32
+ - **Outcome**: What was built and why it works?
33
+
34
+ ### Step 3: Founder Lessons Development
35
+ Transform technical experience into broadly applicable lessons:
36
+ - Identify 3-5 key takeaways that apply to other founders
37
+ - Remove internal jargon and technical complexity
38
+ - Focus on decision-making processes and trade-offs
39
+ - Highlight counterintuitive or surprising discoveries
40
+
41
+ ### Step 4: Event-Specific Adaptation
42
+ Customize content for target event and audience:
43
+ - Research event format (conference, panel, workshop, podcast)
44
+ - Adapt language for audience (technical, business, mixed)
45
+ - Create appropriate time formats (5min, 15min, 30min, 45min)
46
+ - Develop supporting materials and Q&A preparation
47
+
48
+ ### Step 5: Content Package Creation
49
+ Generate complete materials for event submission:
50
+ - Email pitch with compelling subject line
51
+ - Session title with clear hook
52
+ - 1-2 sentence session description
53
+ - Speaker bio highlighting relevant experience
54
+ - Presentation outline and talking points
55
+
56
+ ## TEMPLATE USAGE
57
+
58
+ Use `get_fraim_file({ path: "templates/marketing/STORYTELLING-TEMPLATE.md" })` to create:
59
+ - `docs/marketing/storytelling/{issue_number}-{event-name}.md`
60
+
61
+ ## OUTPUT
62
+ - Compelling founder narrative grounded in product reality
63
+ - Event-ready submission materials
64
+ - Multi-format presentation content
65
+ - Reusable story framework for future opportunities
@@ -0,0 +1,65 @@
1
+ # Performance Analysis Phase
2
+
3
+ ## INTENT
4
+ To diagnose production performance issues (CPU, Memory, Swap) and provide actionable recommendations for stabilization without performing direct application or infrastructure modifications.
5
+
6
+ ## PRINCIPLES
7
+ - **Observational Only**: Do not modify code or infrastructure during this phase.
8
+ - **Data-Driven**: Base all recommendations on metrics collected from the environment.
9
+ - **Non-Invasive**: Use non-destructive commands that do not impact server stability.
10
+ - **Actionable**: Provide clear, prioritized recommendations for remediation.
11
+
12
+ ## ANALYSIS WORKFLOW
13
+
14
+ ### Step 1: Run the Performance Profiler
15
+ Execute the profiling script against the production environment to collect plan-level and process-level metrics.
16
+
17
+ **Note**: `profile-server.ts` has FRAIM dependencies and requires ephemeral execution.
18
+
19
+ ```bash
20
+ # Get the profile-server script ephemerally (has FRAIM dependencies)
21
+ # Use get_fraim_file({ path: "scripts/performance/profile-server.ts" }) and save to tmp/profile-server.ts
22
+ npx tsx tmp/profile-server.ts --prod
23
+ ```
24
+
25
+ ### Step 2: Inspect Automated Diagnosis
26
+ Review the "Step 4: Automated Diagnosis" section of the output.
27
+ It will specifically check for:
28
+ - **Swap Death**: If >95% swap is used, the server is thrashing.
29
+ - **Absent Application**: If `server.js` is missing, the infrastructure is healthy but the app is crashed/not starting.
30
+ - **Infrastructure Hogs**: If Azure agents (Kudu/dotnet) are consuming excessive RAM.
31
+
32
+ ### Step 3: Deep Dive Log Analysis
33
+ If a crash loop or high operation frequency is suspected, collect and analyze application logs using the same script with the `--logs` flag.
34
+
35
+ ```bash
36
+ # Use the same ephemeral script with logs flag
37
+ npx tsx tmp/profile-server.ts --prod --logs
38
+ ```
39
+ Look for:
40
+ - Frequency of initialization logs (e.g., "Ensured unique index").
41
+ - Patterns indicative of OOM events or unhandled exceptions.
42
+ - High volume of specific operations (e.g., decryptions) suggesting an infinite loop.
43
+
44
+ ### Step 4: Formulate Recommendations
45
+ Based on the diagnosis, provide specific recommendations in your response or an implementation plan (if a fix is needed in a subsequent phase).
46
+ Examples:
47
+ - **Restart**: If swap usage is high or rogue processes are detected.
48
+ - **Upgrade Plan**: If physical memory is chronically saturated (B1 to P1v3).
49
+ - **Code Optimization**: If log analysis reveals initialization loops or leaks.
50
+
51
+ ## EXAMPLES
52
+
53
+ ### Good Analysis
54
+ > "The profiler shows 98% CPU usage and 'Swap Death'. The logs show 'Ensured unique index' occurring 100 times per minute. I recommend implementing an initialization guard in `PrismaDatabaseService` to break this loop."
55
+
56
+ ### Bad Analysis (Do not do)
57
+ > "I found a loop, so I've updated `server.ts` to fix it."
58
+ > *Correction: Propose the fix first, do not implement it within the analysis workflow.*
59
+
60
+ ## COMPLETION CHECKLIST
61
+ - [ ] Profiler run successfully on production.
62
+ - [ ] Resource bottlenecks (CPU/Mem/Swap) identified.
63
+ - [ ] Application process stability verified.
64
+ - [ ] Root cause hypothesis formulated based on metrics and logs.
65
+ - [ ] Prioritized recommendations delivered to the user.