fraim-framework 2.0.56 → 2.0.58

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 (224) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/bin/fraim-mcp.js +14 -0
  3. package/bin/fraim.js +23 -0
  4. package/dist/src/cli/commands/init-project.js +10 -4
  5. package/dist/src/cli/commands/mcp.js +65 -0
  6. package/dist/src/cli/setup/mcp-config-generator.js +19 -16
  7. package/dist/src/fraim/issue-tracking/ado-provider.js +304 -0
  8. package/dist/src/fraim/issue-tracking/factory.js +63 -0
  9. package/dist/src/fraim/issue-tracking/github-provider.js +200 -0
  10. package/dist/src/fraim/issue-tracking/types.js +7 -0
  11. package/dist/src/fraim/issue-tracking-config.js +83 -0
  12. package/dist/src/local-mcp-server/stdio-server.js +207 -0
  13. package/dist/src/utils/workflow-parser.js +81 -0
  14. package/package.json +17 -12
  15. package/registry/scripts/pdf-styles.css +172 -0
  16. package/registry/scripts/prep-issue.sh +46 -4
  17. package/registry/scripts/profile-server.ts +131 -130
  18. package/registry/stubs/workflows/customer-development/user-survey-dispatch.md +1 -1
  19. package/registry/stubs/workflows/customer-development/users-to-target.md +1 -1
  20. package/registry/stubs/workflows/product-building/design.md +1 -1
  21. package/registry/stubs/workflows/product-building/implement.md +1 -1
  22. package/Claude.md +0 -1
  23. package/dist/registry/ai-manager-rules/customer-development-phases/phase1-customer-profiling.md +0 -101
  24. package/dist/registry/ai-manager-rules/customer-development-phases/phase2-platform-discovery.md +0 -235
  25. package/dist/registry/ai-manager-rules/customer-development-phases/phase3-prospect-qualification.md +0 -243
  26. package/dist/registry/ai-manager-rules/customer-development-phases/phase4-inventory-compilation.md +0 -206
  27. package/dist/registry/ai-manager-rules/design-phases/design-completeness-review.md +0 -73
  28. package/dist/registry/ai-manager-rules/design-phases/design-design.md +0 -145
  29. package/dist/registry/ai-manager-rules/implement-phases/implement-code.md +0 -283
  30. package/dist/registry/ai-manager-rules/implement-phases/implement-completeness-review.md +0 -120
  31. package/dist/registry/ai-manager-rules/implement-phases/implement-regression.md +0 -173
  32. package/dist/registry/ai-manager-rules/implement-phases/implement-repro.md +0 -104
  33. package/dist/registry/ai-manager-rules/implement-phases/implement-scoping.md +0 -100
  34. package/dist/registry/ai-manager-rules/implement-phases/implement-smoke.md +0 -237
  35. package/dist/registry/ai-manager-rules/implement-phases/implement-spike.md +0 -121
  36. package/dist/registry/ai-manager-rules/implement-phases/implement-validate.md +0 -375
  37. package/dist/registry/ai-manager-rules/retrospective.md +0 -116
  38. package/dist/registry/ai-manager-rules/shared-phases/address-pr-feedback.md +0 -188
  39. package/dist/registry/ai-manager-rules/shared-phases/submit-pr.md +0 -202
  40. package/dist/registry/ai-manager-rules/shared-phases/wait-for-pr-review.md +0 -170
  41. package/dist/registry/ai-manager-rules/spec-phases/spec-competitor-analysis.md +0 -105
  42. package/dist/registry/ai-manager-rules/spec-phases/spec-completeness-review.md +0 -66
  43. package/dist/registry/ai-manager-rules/spec-phases/spec-spec.md +0 -139
  44. package/dist/registry/ai-manager-rules/user-survey-phases/phase1-survey-scoping.md +0 -60
  45. package/dist/registry/ai-manager-rules/user-survey-phases/phase2-survey-build-linkedin.md +0 -23
  46. package/dist/registry/ai-manager-rules/user-survey-phases/phase3-survey-build-reddit.md +0 -22
  47. package/dist/registry/ai-manager-rules/user-survey-phases/phase4-survey-build-x.md +0 -21
  48. package/dist/registry/ai-manager-rules/user-survey-phases/phase5-survey-build-facebook.md +0 -19
  49. package/dist/registry/ai-manager-rules/user-survey-phases/phase6-survey-build-custom.md +0 -15
  50. package/dist/registry/ai-manager-rules/user-survey-phases/phase7-survey-dispatch.md +0 -45
  51. package/dist/registry/providers/ado.json +0 -19
  52. package/dist/registry/providers/github.json +0 -19
  53. package/dist/registry/scripts/cleanup-branch.js +0 -287
  54. package/dist/registry/scripts/evaluate-code-quality.js +0 -66
  55. package/dist/registry/scripts/exec-with-timeout.js +0 -142
  56. package/dist/registry/scripts/generate-engagement-emails.js +0 -705
  57. package/dist/registry/scripts/newsletter-helpers.js +0 -671
  58. package/dist/registry/scripts/profile-server.js +0 -388
  59. package/dist/registry/scripts/run-thank-you-workflow.js +0 -92
  60. package/dist/registry/scripts/send-newsletter-simple.js +0 -85
  61. package/dist/registry/scripts/send-thank-you-emails.js +0 -54
  62. package/dist/registry/scripts/validate-openapi-limits.js +0 -311
  63. package/dist/registry/scripts/validate-test-coverage.js +0 -262
  64. package/dist/registry/scripts/verify-test-coverage.js +0 -66
  65. package/dist/registry/templates/bootstrap/ARCHITECTURE-TEMPLATE.md +0 -53
  66. package/dist/registry/templates/bootstrap/CODE-QUALITY-REPORT-TEMPLATE.md +0 -37
  67. package/dist/registry/templates/bootstrap/TEST-COVERAGE-REPORT-TEMPLATE.md +0 -35
  68. package/dist/registry/templates/business-development/IDEATION-REPORT-TEMPLATE.md +0 -29
  69. package/dist/registry/templates/business-development/PRICING-STRATEGY-TEMPLATE.md +0 -126
  70. package/dist/registry/templates/customer-development/customer-interview-template.md +0 -99
  71. package/dist/registry/templates/customer-development/customer-persona-template.md +0 -69
  72. package/dist/registry/templates/customer-development/follow-up-email-templates.md +0 -132
  73. package/dist/registry/templates/customer-development/insight-analysis-template.md +0 -74
  74. package/dist/registry/templates/customer-development/prospect-inventory-template.csv +0 -3
  75. package/dist/registry/templates/customer-development/search-strategy-template.md +0 -123
  76. package/dist/registry/templates/customer-development/strategic-recommendations-template.md +0 -53
  77. package/dist/registry/templates/customer-development/thank-you-email-template.html +0 -124
  78. package/dist/registry/templates/customer-development/thank-you-note-template.md +0 -16
  79. package/dist/registry/templates/customer-development/triage-log-template.md +0 -278
  80. package/dist/registry/templates/customer-development/weekly-newsletter-template.html +0 -204
  81. package/dist/registry/templates/evidence/Design-Evidence.md +0 -30
  82. package/dist/registry/templates/evidence/Implementation-BugEvidence.md +0 -94
  83. package/dist/registry/templates/evidence/Implementation-FeatureEvidence.md +0 -129
  84. package/dist/registry/templates/evidence/Spec-Evidence.md +0 -19
  85. package/dist/registry/templates/help/HelpNeeded.md +0 -14
  86. package/dist/registry/templates/legal/NDA-TEMPLATE.md +0 -170
  87. package/dist/registry/templates/legal/PATENT-TEMPLATE.md +0 -372
  88. package/dist/registry/templates/legal/TRADEMARK-TEMPLATE.md +0 -339
  89. package/dist/registry/templates/legal/contract-review-checklist.md +0 -193
  90. package/dist/registry/templates/legal/review-report-template.md +0 -198
  91. package/dist/registry/templates/legal/saas-terms-template.md +0 -174
  92. package/dist/registry/templates/legal/sow-template.md +0 -117
  93. package/dist/registry/templates/legal/template-variables.md +0 -131
  94. package/dist/registry/templates/marketing/DOMAIN-REGISTRATION-TEMPLATE.md +0 -194
  95. package/dist/registry/templates/marketing/HBR-ARTICLE-TEMPLATE.md +0 -66
  96. package/dist/registry/templates/marketing/STORYTELLING-TEMPLATE.md +0 -130
  97. package/dist/registry/templates/marketing/WEBSITE-TEMPLATE.md +0 -262
  98. package/dist/registry/templates/marketing/github-pages-workflow.yml +0 -64
  99. package/dist/registry/templates/replicate/implementation-checklist.md +0 -39
  100. package/dist/registry/templates/replicate/use-cases-template.md +0 -88
  101. package/dist/registry/templates/retrospective/RETROSPECTIVE-TEMPLATE.md +0 -55
  102. package/dist/registry/templates/specs/BUGSPEC-TEMPLATE.md +0 -37
  103. package/dist/registry/templates/specs/FEATURESPEC-TEMPLATE.md +0 -66
  104. package/dist/registry/templates/specs/TECHSPEC-TEMPLATE.md +0 -39
  105. package/dist/registry/workflows/bootstrap/create-architecture.md +0 -38
  106. package/dist/registry/workflows/bootstrap/detect-broken-windows.md +0 -300
  107. package/dist/registry/workflows/bootstrap/evaluate-code-quality.md +0 -35
  108. package/dist/registry/workflows/bootstrap/verify-test-coverage.md +0 -36
  109. package/dist/registry/workflows/brainstorming/blue-sky-brainstorming.md +0 -211
  110. package/dist/registry/workflows/brainstorming/codebase-brainstorming.md +0 -165
  111. package/dist/registry/workflows/business-development/create-business-plan.md +0 -737
  112. package/dist/registry/workflows/business-development/ideate-business-opportunity.md +0 -55
  113. package/dist/registry/workflows/business-development/price-product.md +0 -325
  114. package/dist/registry/workflows/compliance/detect-compliance-requirements.md +0 -78
  115. package/dist/registry/workflows/compliance/generate-audit-evidence.md +0 -75
  116. package/dist/registry/workflows/compliance/soc2-evidence-generator.md +0 -332
  117. package/dist/registry/workflows/customer-development/insight-analysis.md +0 -156
  118. package/dist/registry/workflows/customer-development/insight-triage.md +0 -938
  119. package/dist/registry/workflows/customer-development/interview-preparation.md +0 -452
  120. package/dist/registry/workflows/customer-development/linkedin-outreach.md +0 -593
  121. package/dist/registry/workflows/customer-development/strategic-brainstorming.md +0 -146
  122. package/dist/registry/workflows/customer-development/thank-customers.md +0 -203
  123. package/dist/registry/workflows/customer-development/user-survey-dispatch.md +0 -60
  124. package/dist/registry/workflows/customer-development/users-to-target.md +0 -112
  125. package/dist/registry/workflows/customer-development/weekly-newsletter.md +0 -366
  126. package/dist/registry/workflows/deploy/cloud-deployment.md +0 -310
  127. package/dist/registry/workflows/improve-fraim/contribute.md +0 -32
  128. package/dist/registry/workflows/improve-fraim/file-issue.md +0 -32
  129. package/dist/registry/workflows/learning/build-skillset.md +0 -212
  130. package/dist/registry/workflows/learning/synthesize-learnings.md +0 -284
  131. package/dist/registry/workflows/legal/contract-review-analysis.md +0 -382
  132. package/dist/registry/workflows/legal/nda.md +0 -69
  133. package/dist/registry/workflows/legal/patent-filing.md +0 -76
  134. package/dist/registry/workflows/legal/saas-contract-development.md +0 -213
  135. package/dist/registry/workflows/legal/trademark-filing.md +0 -77
  136. package/dist/registry/workflows/marketing/content-creation.md +0 -37
  137. package/dist/registry/workflows/marketing/convert-to-pdf.md +0 -235
  138. package/dist/registry/workflows/marketing/create-modern-website.md +0 -456
  139. package/dist/registry/workflows/marketing/domain-registration.md +0 -323
  140. package/dist/registry/workflows/marketing/hbr-article.md +0 -73
  141. package/dist/registry/workflows/marketing/launch-checklist.md +0 -37
  142. package/dist/registry/workflows/marketing/marketing-strategy.md +0 -45
  143. package/dist/registry/workflows/marketing/storytelling.md +0 -65
  144. package/dist/registry/workflows/performance/analyze-performance.md +0 -65
  145. package/dist/registry/workflows/product-building/design.md +0 -103
  146. package/dist/registry/workflows/product-building/implement.md +0 -74
  147. package/dist/registry/workflows/product-building/iterate-on-pr-comments.md +0 -70
  148. package/dist/registry/workflows/product-building/prep-issue.md +0 -41
  149. package/dist/registry/workflows/product-building/prototype.md +0 -65
  150. package/dist/registry/workflows/product-building/resolve.md +0 -168
  151. package/dist/registry/workflows/product-building/retrospect.md +0 -86
  152. package/dist/registry/workflows/product-building/spec.md +0 -181
  153. package/dist/registry/workflows/product-building/test.md +0 -125
  154. package/dist/registry/workflows/productivity-report/productivity-report.md +0 -263
  155. package/dist/registry/workflows/quality-assurance/browser-validation.md +0 -221
  156. package/dist/registry/workflows/quality-assurance/iterative-improvement-cycle.md +0 -562
  157. package/dist/registry/workflows/replicate/replicate-discovery.md +0 -336
  158. package/dist/registry/workflows/replicate/replicate-to-issues.md +0 -324
  159. package/dist/registry/workflows/reviewer/review-implementation-vs-design-spec.md +0 -638
  160. package/dist/registry/workflows/reviewer/review-implementation-vs-feature-spec.md +0 -675
  161. package/dist/registry/workflows/startup-credits/aws-activate-application.md +0 -535
  162. package/dist/registry/workflows/startup-credits/google-cloud-application.md +0 -647
  163. package/dist/registry/workflows/startup-credits/microsoft-azure-application.md +0 -538
  164. package/dist/scripts/build-stub-registry.js +0 -108
  165. package/dist/src/ai-manager/ai-manager.js +0 -480
  166. package/dist/src/ai-manager/phase-flow.js +0 -357
  167. package/dist/src/ai-manager/types.js +0 -5
  168. package/dist/src/fraim-mcp-server.js +0 -1885
  169. package/dist/tests/debug-tools.js +0 -80
  170. package/dist/tests/shared-server-utils.js +0 -57
  171. package/dist/tests/test-add-ide.js +0 -283
  172. package/dist/tests/test-ai-coach-edge-cases.js +0 -420
  173. package/dist/tests/test-ai-coach-mcp-integration.js +0 -450
  174. package/dist/tests/test-ai-coach-performance.js +0 -328
  175. package/dist/tests/test-ai-coach-phase-content.js +0 -264
  176. package/dist/tests/test-ai-coach-workflows.js +0 -514
  177. package/dist/tests/test-cli.js +0 -228
  178. package/dist/tests/test-client-scripts-validation.js +0 -167
  179. package/dist/tests/test-complete-setup-flow.js +0 -110
  180. package/dist/tests/test-config-system.js +0 -279
  181. package/dist/tests/test-debug-session.js +0 -134
  182. package/dist/tests/test-end-to-end-hybrid-validation.js +0 -328
  183. package/dist/tests/test-enhanced-session-init.js +0 -188
  184. package/dist/tests/test-first-run-journey.js +0 -368
  185. package/dist/tests/test-fraim-issues.js +0 -59
  186. package/dist/tests/test-genericization.js +0 -44
  187. package/dist/tests/test-hybrid-script-execution.js +0 -340
  188. package/dist/tests/test-ide-detector.js +0 -46
  189. package/dist/tests/test-improved-setup.js +0 -121
  190. package/dist/tests/test-mcp-config-generator.js +0 -99
  191. package/dist/tests/test-mcp-connection.js +0 -107
  192. package/dist/tests/test-mcp-issue-integration.js +0 -156
  193. package/dist/tests/test-mcp-lifecycle-methods.js +0 -240
  194. package/dist/tests/test-mcp-shared-server.js +0 -308
  195. package/dist/tests/test-mcp-template-processing.js +0 -160
  196. package/dist/tests/test-modular-issue-tracking.js +0 -165
  197. package/dist/tests/test-node-compatibility.js +0 -95
  198. package/dist/tests/test-npm-install.js +0 -68
  199. package/dist/tests/test-package-size.js +0 -108
  200. package/dist/tests/test-pr-review-workflow.js +0 -307
  201. package/dist/tests/test-prep-issue.js +0 -129
  202. package/dist/tests/test-productivity-integration.js +0 -157
  203. package/dist/tests/test-script-location-independence.js +0 -198
  204. package/dist/tests/test-script-sync.js +0 -557
  205. package/dist/tests/test-server-utils.js +0 -32
  206. package/dist/tests/test-session-rehydration.js +0 -148
  207. package/dist/tests/test-setup-integration.js +0 -98
  208. package/dist/tests/test-setup-scenarios.js +0 -322
  209. package/dist/tests/test-standalone.js +0 -143
  210. package/dist/tests/test-stub-registry.js +0 -136
  211. package/dist/tests/test-sync-stubs.js +0 -143
  212. package/dist/tests/test-sync-version-update.js +0 -93
  213. package/dist/tests/test-telemetry.js +0 -193
  214. package/dist/tests/test-token-validator.js +0 -30
  215. package/dist/tests/test-user-journey.js +0 -236
  216. package/dist/tests/test-users-to-target-workflow.js +0 -253
  217. package/dist/tests/test-utils.js +0 -109
  218. package/dist/tests/test-wizard.js +0 -71
  219. package/dist/tests/test-workflow-discovery.js +0 -242
  220. package/labels.json +0 -52
  221. package/registry/agent-guardrails.md +0 -63
  222. package/registry/fraim.md +0 -48
  223. package/setup.js +0 -171
  224. package/tsconfig.json +0 -23
@@ -1,53 +0,0 @@
1
- # Architecture Documentation: <project-name>
2
-
3
- ## 1. Overview
4
- <Briefly describe the purpose and goals of the project.>
5
-
6
- ## 2. Tech Stack Choices
7
-
8
- | Category | Choice | Rationale |
9
- | :--- | :--- | :--- |
10
- | **Language** | <e.g. TypeScript> | <e.g. Type safety and developer productivity> |
11
- | **Runtime** | <e.g. Node.js> | <e.g. Ubiquity and ecosystem> |
12
- | **Frameworks** | <e.g. Express, Fastify, React> | <e.g. Robustness and community support> |
13
- | **Database** | <e.g. MongoDB, PostgreSQL> | <e.g. Data structure requirements> |
14
- | **Testing** | <e.g. Vitest, Playwright> | <e.g. Modern toolchain and speed> |
15
-
16
- ## 3. Architectural Layers
17
-
18
- Describe the layers of the system and their responsibilities.
19
-
20
- ### 3.1. [Layer Name, e.g., API/Interface Layer]
21
- - **Responsibility**: <e.g., Handling HTTP requests, validation, and CLI entry points.>
22
- - **Key Modules**: <e.g., `src/server.ts`, `src/cli/`>
23
-
24
- ### 3.2. [Layer Name, e.g., Application/Business Logic Layer]
25
- - **Responsibility**: <e.g., Core business rules and orchestrating domain services.>
26
- - **Key Modules**: <e.g., `src/services/`, `src/orchestrator/`>
27
-
28
- ### 3.3. [Layer Name, e.g., Data/Infrastructure Layer]
29
- - **Responsibility**: <e.g., Persistence, external API integrations, and low-level utilities.>
30
- - **Key Modules**: <e.g., `src/db/`, `src/clients/`>
31
-
32
- ## 4. Key Components & Modules
33
-
34
- <mermaid>
35
- graph TD
36
- A[Component A] --> B[Component B]
37
- B --> C[External API]
38
- B --> D[Database]
39
- </mermaid>
40
-
41
- ### 4.1 [Component Name]
42
- <Description of the component's role and internal structure.>
43
-
44
- ## 5. Data Flow
45
- <Describe how information moves through the system from an input (e.g., user request) to output/persistence.>
46
-
47
- ## 6. Design Patterns & Principles
48
- - **Pattern 1**: <e.g., Dependency Injection for testability.>
49
- - **Pattern 2**: <e.g., Event-driven architecture for async processing.>
50
-
51
- ## 7. Configuration & Environment
52
- - **FRAIM Config**: Located at `config.json`.
53
- - **Environment Variables**: <List critical variables here.>
@@ -1,37 +0,0 @@
1
- # Code Quality Evaluation Report
2
-
3
- ## Summary
4
- - **Evaluation Date**: <date>
5
- - **Project Name**: <project-name>
6
- - **Overall Quality Grade**: <grade> (A/B/C/D/F)
7
-
8
- ## Key Characteristics
9
-
10
- ### 1. Type Safety
11
- - **Gate 1 Status**: <status>
12
- - **Issues Found**:
13
- - <issue-1>
14
- - <issue-2>
15
- - **Recommendation**: <recommendation>
16
-
17
- ### 2. Linting & Style
18
- - **Status**: <status>
19
- - **Warnings/Errors**: <count>
20
- - **Recommendation**: <recommendation>
21
-
22
- ### 3. FRAIM Patterns & Architecture
23
- - **Architecture Alignment**: <status>
24
- - **Missing Documentation**: <list>
25
- - **Rule Violations**:
26
- - <violation-1>
27
-
28
- ### 4. Technical Debt
29
- - **Estimated Effort to Fix**: <hours>
30
- - **Top 3 Critical Issues**:
31
- 1. <issue-1>
32
- 2. <issue-2>
33
- 3. <issue-3>
34
-
35
- ## Recommendations
36
- - [ ] <next-step-1>
37
- - [ ] <next-step-2>
@@ -1,35 +0,0 @@
1
- # Test Coverage & Effectiveness Report
2
-
3
- ## Summary
4
- - **Evaluation Date**: <date>
5
- - **Total Scenarios Found**: <total>
6
- - **Scenario Coverage**: <percentage>%
7
- - **Line Coverage**: <percentage>%
8
-
9
- ## Coverage Breakdown
10
-
11
- ### 1. Scenario Coverage (Gate 9)
12
- - **Status**: <status>
13
- - **Covered Scenarios**:
14
- - [x] <scenario-1>
15
- - [x] <scenario-2>
16
- - **Missing Scenarios**:
17
- - [ ] <missing-scenario-1>
18
- - [ ] <missing-scenario-2>
19
-
20
- ### 2. Code Coverage
21
- - **Lines**: <covered>/<total> (<percentage>%)
22
- - **Branches**: <covered>/<total> (<percentage>%)
23
- - **Functions**: <covered>/<total> (<percentage>%)
24
-
25
- ### 3. Test Quality
26
- - **Tautological Tests (Gate 1.5)**: <count> found
27
- - **Mocking Health**: <assessment>
28
-
29
- ## Risk Areas
30
- - **Unverified Critical Paths**: <list>
31
- - **Complexity without Tests**: <list>
32
-
33
- ## Recommendations
34
- - [ ] <recommendation-1>
35
- - [ ] <recommendation-2>
@@ -1,29 +0,0 @@
1
- # Ideation Report: [Product/Space Name]
2
-
3
- ## 🎯 Executive Summary
4
- [1-2 sentences summarizing the core idea and its unique value prop.]
5
-
6
- ## 🧭 Problem Space & Vision
7
- ### The Problem
8
- [Describe the pain points being solved.]
9
- ### The Vision
10
- [Describe the desired future state.]
11
-
12
- ## 👥 Target Personas
13
- - **[Persona Name]**: [Description, Goals, Pain Points]
14
-
15
- ## 🚀 Priority Feature Backlog
16
- | Feature | Description | Priority |
17
- | :--- | :--- | :--- |
18
- | [Feature Name] | [Brief detail] | [High/Med/Low] |
19
-
20
- ## 📐 Conceptual Architecture
21
- [High-level description of how modules or agents might interact.]
22
-
23
- ## 🧪 Next Steps
24
- - [ ] Transition to `prototype` for [Core Feature]
25
- - [ ] Create `spec` for [Highest Priority Feature]
26
- - [ ] Research [Specific Technical/Market Gap]
27
-
28
- ---
29
- *Created via FRAIM Ideation Workflow*
@@ -1,126 +0,0 @@
1
- # Pricing & Packaging Strategy — [Product Name]
2
-
3
- **Date:** YYYY-MM-DD
4
- **Owner:** [Name/Team]
5
- **Purpose:** Define SKUs, pricing, unit economics, and competitive positioning
6
-
7
- ---
8
-
9
- ## Executive Summary
10
- - What we sell (one-liner)
11
- - Who buys (top 2–3 segments)
12
- - Recommended pricing metric
13
- - Recommended SKUs/tiers
14
- - Price list snapshot
15
- - Biggest risks + mitigations
16
- - Next 30 days plan
17
-
18
- ---
19
-
20
- ## Product Context
21
- - Core outcomes
22
- - Buyer vs user
23
- - Delivery model (SaaS / services / hybrid)
24
- - Constraints (margin targets, capacity, sales motion)
25
-
26
- ---
27
-
28
- ## Customer Segments (ICP)
29
- ### Segment 1: [Name]
30
- - Job-to-be-done
31
- - Pain points
32
- - Alternatives today
33
- - Willingness to pay signals
34
- - Buying process & budget
35
- - Success metrics
36
-
37
- [Repeat for 3–7 segments]
38
-
39
- ### Segment Comparison Table
40
- | Segment | Pain | Frequency | Budget Owner | WTP | Reach | Competition | Notes |
41
- |---|---:|---:|---|---:|---:|---:|---|
42
-
43
- ---
44
-
45
- ## Value Narrative (Why Before Pricing)
46
- - Headline value statement
47
- - Why outcomes vary (if relevant)
48
- - 3 adoption paths / maturity levels (optional)
49
- - CTA
50
-
51
- ---
52
-
53
- ## Packaging Architecture (SKUs + tiers)
54
- ### SKU Catalog
55
- | SKU | Who it’s for | Primary outcomes | Included | Excludes | Success metrics |
56
- |---|---|---|---|---|---|
57
-
58
- ### Tier Comparison
59
- | Tier | Best for | Outcomes | Limits | Support | Upgrade triggers |
60
- |---|---|---|---|---|---|
61
-
62
- ---
63
-
64
- ## Pricing Metric
65
- - Primary metric: [e.g., per seat / per workspace / per project / per run]
66
- - Why this metric fits value + predictability
67
- - Guardrails and anti-gaming
68
- - Secondary metrics (optional add-ons)
69
-
70
- ---
71
-
72
- ## Price List
73
- ### Hero Table (simple first)
74
- | | Tier 1 | Tier 2 | Tier 3 |
75
- |---|---|---|---|
76
- | What you get | | | |
77
- | What you save/earn | | | |
78
- | What you pay | | | |
79
-
80
- ### Add-ons
81
- | Add-on | What it includes | Who buys it | Price | Notes |
82
- |---|---|---|---:|---|
83
-
84
- ### Discounts & Terms
85
- - annual/volume/enterprise terms
86
-
87
- ---
88
-
89
- ## Unit Economics
90
- ### Assumptions
91
- | Driver | Assumption | Notes |
92
- |---|---|---|
93
-
94
- ### Margin by SKU/Tier
95
- | SKU/Tier | ARPU/ACV | COGS | Gross Margin | Notes |
96
- |---|---:|---:|---:|---|
97
-
98
- ### Scalability Constraints
99
- - staffing ratios (if services)
100
- - compute caps
101
- - support burden
102
-
103
- ---
104
-
105
- ## Competitive Landscape (with citations)
106
- ### Competitor Matrix
107
- | Competitor | What they sell | Who buys | Pricing model | Strengths | Weaknesses | Win strategy |
108
- |---|---|---|---|---|---|---|
109
-
110
- ### Positioning & Talk Tracks
111
- - Differentiation pillars
112
- - Objections + responses
113
- - Win/loss summary
114
-
115
- ---
116
-
117
- ## Risks & Mitigations
118
- | Risk | Impact | Mitigation | Owner | Leading indicator |
119
- |---|---|---|---|---|
120
-
121
- ---
122
-
123
- ## Validation Plan (30/60/90)
124
- - experiments
125
- - metrics
126
- - decision points
@@ -1,99 +0,0 @@
1
- # Customer Interview Template
2
-
3
- ## Interview Preparation Section (AI Agent fills this before interview)
4
-
5
- ### Customer Overview
6
- **Name**: [Full Name]
7
- **Role**: [Current Title] at [Company]
8
- **Location**: [City, State/Country]
9
- **Experience**: [Years] at [Company], [Total] years in [Industry]
10
- **Connection**: [Degree] degree connection with [X] mutual connections
11
-
12
- ### Professional Background
13
-
14
- #### Current Role ([Date] - Present)
15
- **[Title]** - [Company/Department]
16
- - **Mission**: [Key responsibilities and team focus]
17
- - **Team Leadership**: [Team size and management responsibilities]
18
- - **Key Responsibilities**:
19
- - [Specific responsibility 1]
20
- - [Specific responsibility 2]
21
- - [Specific responsibility 3]
22
-
23
- #### Previous Role ([Date] - [Date])
24
- **[Title]** - [Company/Department]
25
- - **Focus**: [Key focus areas and achievements]
26
- - **Key Products/Projects**:
27
- - [Product/Project 1]: [Description]
28
- - [Product/Project 2]: [Description]
29
- - **Innovation**: [Key innovations or approaches]
30
-
31
- #### Career Progression
32
- - **[X] years at [Company]** ([Additional context])
33
- - **Technical Background**: [Background details]
34
- - **Enterprise Experience**: [Relevant experience]
35
- - **Product Creation**: [Notable products built]
36
- - **Education**: [Education background]
37
-
38
- ### Key Insights for Interview
39
-
40
- #### Product Philosophy
41
- - **[Quote or philosophy from profile]**
42
- - **[Key mindset or approach]**
43
- - **[Customer-centric focus areas]**
44
-
45
- #### Technical & Business Acumen
46
- - **Hybrid Background**: [Technical + Business background]
47
- - **Enterprise Focus**: [Enterprise experience details]
48
- - **AI Integration**: [AI/Technology experience]
49
- - **Product-Led Growth**: [Growth and adoption expertise]
50
-
51
- #### Company Context
52
- - **Long Tenure**: [Company experience details]
53
- - **Current Focus**: [Current team and project focus]
54
- - **Hierarchy Awareness**: [Level and leadership context]
55
- - **Cross-Functional**: [Cross-functional experience]
56
-
57
- #### LinkedIn Activity Insights
58
- - **Recent Posts**: [Topics they write about, tone, expertise areas]
59
- - **Liked/Reshared Content**: [Interests and influences from their engagement]
60
- - **Comments**: [Perspectives and opinions from their comments]
61
- - **Recurring Themes**: [Pain points, interests, expertise areas from content]
62
- - **Communication Style**: [Personality and approach from posts/comments]
63
- - **Thought Leadership**: [Areas where they share insights and opinions]
64
-
65
- #### Additional Research Insights
66
- - **Web Search Findings**: [Articles, interviews, press mentions found online]
67
- - **Professional Content**: [Blog posts, articles, speaking engagements, podcasts]
68
- - **Social Media Activity**: [Twitter/X, Medium, other platforms activity]
69
- - **Company Intelligence**: [Company culture, tools, policies, recent changes]
70
- - **Industry Context**: [Industry trends, challenges, competitive landscape]
71
-
72
- ### Interview Strategy
73
-
74
- #### Conversation Starters
75
- - **Mutual Connections**: Reference [Specific mutual connections]
76
- - **Shared Experience**: [Shared context or experience]
77
- - **Product Philosophy**: Connect to [Specific philosophy or approach]
78
- - **Recent Work**: Ask about [Specific recent work or projects]
79
-
80
- ### Research Notes
81
- - **LinkedIn Profile**: [Profile research summary]
82
- - **Mutual Connections**: [Network overlap details]
83
- - **Company Context**: [Company and industry context]
84
- - **Role Relevance**: [Why this customer is a good fit]
85
- - **Timing**: [Why timing is good for interview]
86
-
87
- ## Interview Questions (AI Agent creates these based on strategic document - Mom Test Compliant)
88
-
89
- ### Priority Questions
90
- [AI Agent creates specific questions based on strategic assumptions and customer context]
91
- **Mom Test Format**: "Tell me about the last time you..." or "Walk me through what happened when..."
92
-
93
- ### Validation Questions
94
- [AI Agent creates questions to validate specific strategic assumptions from the strategy document]
95
- **Focus**: Past behavior, specific examples, current processes
96
-
97
- ### Follow-up Questions
98
- [AI Agent creates follow-up questions based on customer background and role]
99
- **Format**: "How did that work out?" or "What would you have done differently?"
@@ -1,69 +0,0 @@
1
- # Customer Persona Template
2
-
3
- ## Basic Information
4
- - **Persona Name**: [Give your ideal customer a name]
5
- - **Industry/Sector**: [What industry do they work in?]
6
- - **Job Title/Role**: [What is their position?]
7
- - **Company Size**: [Startup, SMB, Enterprise]
8
- - **Geographic Location**: [Where are they located?]
9
-
10
- ## Demographics
11
- - **Age Range**: [Age bracket]
12
- - **Education Level**: [Educational background]
13
- - **Income Range**: [If relevant]
14
- - **Experience Level**: [Years in role/industry]
15
-
16
- ## Pain Points & Challenges
17
- 1. **Primary Pain Point**: [Main problem your solution addresses]
18
- 2. **Secondary Pain Points**: [Additional problems they face]
19
- 3. **Current Solutions**: [How do they currently handle these problems?]
20
- 4. **Frustrations**: [What frustrates them about current solutions?]
21
-
22
- ## Behavioral Indicators
23
- - **Online Behavior**: [Where do they spend time online?]
24
- - **Content Consumption**: [What do they read/watch?]
25
- - **Social Media Usage**: [Which platforms do they use?]
26
- - **Professional Networks**: [LinkedIn groups, associations]
27
- - **Forums/Communities**: [Where do they seek help/advice?]
28
-
29
- ## Search Keywords
30
- ### LinkedIn Keywords
31
- - [Professional terms they use]
32
- - [Job titles to search for]
33
- - [Company types]
34
- - [Skills they mention]
35
-
36
- ### Reddit Keywords
37
- - [Subreddits they frequent]
38
- - [Problems they discuss]
39
- - [Solutions they seek]
40
-
41
- ### X (Twitter) Keywords
42
- - [Hashtags they use]
43
- - [Complaints they voice]
44
- - [Topics they discuss]
45
-
46
- ### Facebook Keywords
47
- - [Groups they join]
48
- - [Topics they discuss]
49
- - [Problems they share]
50
-
51
- ### Web Search Keywords
52
- - [Blog topics they read]
53
- - [Problems they Google]
54
- - [Solutions they research]
55
-
56
- ## Qualification Criteria
57
- - **Must Have**: [Non-negotiable requirements]
58
- - **Nice to Have**: [Preferred but not required]
59
- - **Red Flags**: [Disqualifying factors]
60
-
61
- ## Contact Preferences
62
- - **Preferred Channels**: [Email, LinkedIn, Twitter DM, etc.]
63
- - **Best Times**: [When to reach out]
64
- - **Messaging Tone**: [Professional, casual, technical]
65
-
66
- ## Success Indicators
67
- - **Budget Authority**: [Do they have buying power?]
68
- - **Urgency**: [How urgent is their need?]
69
- - **Fit Score**: [How well do they match your solution?]
@@ -1,132 +0,0 @@
1
- # Customer Follow-up Email Templates
2
-
3
- ## Template 1: Thank You + Key Takeaways Confirmation
4
-
5
- **Subject**: Thank you for the insightful conversation about [Topic] - [Company Name]
6
-
7
- Hi [Customer Name],
8
-
9
- Thank you for taking the time to speak with me about [Topic] yesterday. I really appreciated your insights and candor about [Specific Pain Point].
10
-
11
- **Key Takeaways I Want to Confirm:**
12
- - [Pain Point 1]: [Customer's specific example/quote]
13
- - [Pain Point 2]: [Customer's specific example/quote]
14
- - [Success Criteria]: [What customer said success would look like]
15
- - [Budget/Decision Process]: [What customer said about budget/timeline]
16
-
17
- **Next Steps:**
18
- - [Follow-up action 1]
19
- - [Follow-up action 2]
20
- - [Timeline for next steps]
21
-
22
- I'll [specific commitment] and get back to you by [date].
23
-
24
- Thanks again for your time and insights!
25
-
26
- Best regards,
27
- [Your Name]
28
-
29
- ---
30
-
31
- ## Template 2: Follow-up Questions + Demo Offer
32
-
33
- **Subject**: Follow-up questions from our conversation + Demo offer
34
-
35
- Hi [Customer Name],
36
-
37
- Thanks again for the great conversation about [Topic]. I have a few follow-up questions that came up after our discussion:
38
-
39
- **Questions:**
40
- 1. [Question 1 based on gaps in understanding]
41
- 2. [Question 2 based on gaps in understanding]
42
- 3. [Question 3 based on gaps in understanding]
43
-
44
- **Demo Offer:**
45
- Based on what you shared about [Pain Point], I think you might find value in seeing how [Product] addresses [Specific Problem]. Would you be interested in a brief demo?
46
-
47
- **Referrals:**
48
- You mentioned [Colleague Name] at [Company] might also be interested in this topic. Would you be comfortable if I reached out to them as well?
49
-
50
- Let me know your thoughts on the questions and demo offer.
51
-
52
- Best regards,
53
- [Your Name]
54
-
55
- ---
56
-
57
- ## Template 3: Resource Sharing + Next Steps
58
-
59
- **Subject**: Resources from our conversation + Next steps
60
-
61
- Hi [Customer Name],
62
-
63
- Thanks for the insightful conversation about [Topic]. As promised, here are some resources that might be helpful:
64
-
65
- **Resources:**
66
- - [Resource 1]: [Description and why it's relevant]
67
- - [Resource 2]: [Description and why it's relevant]
68
- - [Resource 3]: [Description and why it's relevant]
69
-
70
- **Next Steps:**
71
- - [Specific next step 1]
72
- - [Specific next step 2]
73
- - [Timeline and commitment]
74
-
75
- **Questions:**
76
- If you have any questions about the resources or next steps, feel free to reach out.
77
-
78
- Thanks again for your time and insights!
79
-
80
- Best regards,
81
- [Your Name]
82
-
83
- ---
84
-
85
- ## Template 4: Referral Request + Thank You
86
-
87
- **Subject**: Thank you + Referral request
88
-
89
- Hi [Customer Name],
90
-
91
- Thank you for the valuable conversation about [Topic]. Your insights about [Specific Insight] were particularly helpful.
92
-
93
- **Referral Request:**
94
- You mentioned that [Colleague Name] at [Company] might also be interested in [Topic]. Would you be comfortable making an introduction? I'd be happy to share what we discussed and see if they have similar challenges.
95
-
96
- **What I'd Share:**
97
- - Brief overview of [Topic] and common challenges
98
- - How [Product] addresses these challenges
99
- - 15-20 minute conversation to understand their needs
100
-
101
- **Next Steps:**
102
- - [Your specific commitment]
103
- - [Timeline for follow-up]
104
-
105
- Thanks again for your time and insights!
106
-
107
- Best regards,
108
- [Your Name]
109
-
110
- ---
111
-
112
- ## Template Usage Guidelines
113
-
114
- ### When to Use Each Template:
115
- - **Template 1**: Standard follow-up for most interviews
116
- - **Template 2**: When you need more information or want to offer a demo
117
- - **Template 3**: When you promised to share resources
118
- - **Template 4**: When customer mentioned referrals
119
-
120
- ### Customization Tips:
121
- - Always personalize with specific quotes and examples
122
- - Include specific commitments and timelines
123
- - Reference specific pain points mentioned in the interview
124
- - Keep tone professional but friendly
125
- - Include clear next steps and expectations
126
-
127
- ### Best Practices:
128
- - Send within 24-48 hours of the interview
129
- - Include specific quotes and examples from the conversation
130
- - Make specific commitments and follow through
131
- - Ask for referrals when appropriate
132
- - Keep emails concise and actionable
@@ -1,74 +0,0 @@
1
- # Insight Analysis Template
2
-
3
- ## Analysis File Template
4
- ```markdown
5
- # Interview Analysis - [Customer Name] - [Date]
6
-
7
- ## Executive Summary
8
- [Brief overview of key insights and customer fit]
9
-
10
- ## Customer Scoring & Prioritization
11
- ### Customer Fit Score: [X]/10
12
- **Reasoning**: [Why this score - segment alignment, pain point severity, budget authority]
13
-
14
- ### Urgency Level: [High/Medium/Low]
15
- **Reasoning**: [Why this urgency - active seeking, timeline, competitive pressure]
16
-
17
- ### Willingness to Pay: [High/Medium/Low]
18
- **Reasoning**: [Why this willingness - budget authority, current spending, value perception]
19
-
20
- ### Likelihood to Buy: [High/Medium/Low]
21
- **Reasoning**: [Why this likelihood - decision power, implementation readiness, engagement]
22
-
23
- ## Key Insights from Interview
24
- ### Pain Points Confirmed
25
- 1. [Pain point 1 with customer quote]
26
- 2. [Pain point 2 with customer quote]
27
- 3. [Pain point 3 with customer quote]
28
-
29
- ### Success & Failure Criteria
30
- **Success**: [Success criteria with customer quotes]
31
- **Failure**: [Failure criteria with customer quotes]
32
-
33
- ### Feature Validation
34
- - **Calendar & Scheduling**: [Priority, pain level, willingness to pay, customer quote]
35
- - **Email Management**: [Priority, pain level, willingness to pay, customer quote]
36
- - **Other Features**: [Additional feature insights]
37
-
38
- ## Memorable Quotes
39
- > "[Customer quote 1]"
40
-
41
- > "[Customer quote 2]"
42
-
43
- > "[Customer quote 3]"
44
-
45
- ## Follow-up Actions
46
- ### Immediate Actions
47
- - [ ] [Action 1 with timeline]
48
- - [ ] [Action 2 with timeline]
49
- - [ ] [Action 3 with timeline]
50
-
51
- ### Suggested Follow-up Email
52
- [Generated personalized follow-up email using follow-up email templates as reference]
53
-
54
- ### Next Questions
55
- 1. [Follow-up question 1]
56
- 2. [Follow-up question 2]
57
- 3. [Follow-up question 3]
58
-
59
- ### Referrals
60
- - **Potential referrals**: [Referral opportunities]
61
- - **Introduction approach**: [How to approach referrals]
62
-
63
- ## Reference Files
64
- - **Interview Preparation**: `[customer-name]-interview-prep.md`
65
- - **Strategic Context**: `ashley-market-niche-strategy.md`
66
- ```
67
-
68
- ## Usage Notes
69
- - Extract insights from raw interview notes
70
- - Score customer based on fit, urgency, willingness to pay, and likelihood to buy
71
- - Include direct customer quotes for authenticity
72
- - **Generate personalized follow-up emails using follow-up email templates as reference**
73
- - Create actionable next steps with timelines
74
- - Reference the original prep file for context
@@ -1,3 +0,0 @@
1
- Name,Platform Found,Profile URL,Contact Information,Pain Points Identified,Relevance Score,Discovery Context,Follow-up Priority,Notes,Date Found,Industry,Job Title,Company,Location,Engagement Level
2
- John Doe,LinkedIn,https://linkedin.com/in/johndoe,john.doe@company.com,"Struggling with manual data entry, needs automation",9,"Posted about spending 10 hours/week on manual tasks",High,"Active poster about productivity challenges",2026-02-03,SaaS,Operations Manager,TechCorp,San Francisco,High
3
- Jane Smith,Reddit,https://reddit.com/u/janesmith,,"Looking for better project management tools",7,"Comment in r/projectmanagement about current tool limitations",Medium,"Frequent contributor to PM discussions",2026-02-03,Marketing,Project Manager,Unknown,Unknown,Medium