fraim-framework 2.0.35 → 2.0.37

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 (159) hide show
  1. package/dist/registry/scripts/cleanup-branch.js +62 -33
  2. package/dist/registry/scripts/generate-engagement-emails.js +119 -44
  3. package/dist/registry/scripts/newsletter-helpers.js +208 -268
  4. package/dist/registry/scripts/profile-server.js +387 -0
  5. package/dist/scripts/build-stub-registry.js +108 -0
  6. package/dist/src/cli/commands/doctor.js +5 -5
  7. package/dist/src/cli/commands/sync.js +33 -19
  8. package/dist/tests/test-client-scripts-validation.js +133 -0
  9. package/dist/tests/test-package-size.js +88 -0
  10. package/dist/tests/test-script-location-independence.js +76 -28
  11. package/dist/tests/test-stub-registry.js +120 -0
  12. package/dist/tests/test-sync-stubs.js +143 -0
  13. package/package.json +7 -9
  14. package/registry/scripts/cleanup-branch.ts +341 -0
  15. package/registry/scripts/generate-engagement-emails.ts +830 -0
  16. package/registry/scripts/markdown-to-pdf.js +7 -3
  17. package/registry/scripts/newsletter-helpers.ts +777 -0
  18. package/registry/scripts/profile-server.ts +424 -0
  19. package/registry/scripts/run-thank-you-workflow.ts +122 -0
  20. package/registry/scripts/send-newsletter-simple.ts +102 -0
  21. package/registry/scripts/send-thank-you-emails.ts +57 -0
  22. package/registry/stubs/workflows/bootstrap/create-architecture.md +11 -0
  23. package/registry/stubs/workflows/bootstrap/detect-broken-windows.md +11 -0
  24. package/registry/stubs/workflows/bootstrap/evaluate-code-quality.md +11 -0
  25. package/registry/stubs/workflows/bootstrap/verify-test-coverage.md +11 -0
  26. package/registry/stubs/workflows/business-development/create-business-plan.md +11 -0
  27. package/registry/stubs/workflows/business-development/ideate-business-opportunity.md +11 -0
  28. package/registry/stubs/workflows/business-development/price-product.md +18 -0
  29. package/registry/stubs/workflows/convert-to-pdf.md +11 -0
  30. package/registry/stubs/workflows/customer-development/insight-analysis.md +11 -0
  31. package/registry/stubs/workflows/customer-development/insight-triage.md +11 -0
  32. package/registry/stubs/workflows/customer-development/interview-preparation.md +11 -0
  33. package/registry/stubs/workflows/customer-development/linkedin-outreach.md +11 -0
  34. package/registry/stubs/workflows/customer-development/strategic-brainstorming.md +11 -0
  35. package/registry/stubs/workflows/customer-development/thank-customers.md +11 -0
  36. package/registry/stubs/workflows/customer-development/weekly-newsletter.md +11 -0
  37. package/registry/stubs/workflows/deploy/cloud-deployment.md +11 -0
  38. package/registry/stubs/workflows/improve-fraim/contribute.md +11 -0
  39. package/registry/stubs/workflows/improve-fraim/file-issue.md +11 -0
  40. package/registry/stubs/workflows/marketing/content-creation.md +11 -0
  41. package/registry/stubs/workflows/marketing/hbr-article.md +11 -0
  42. package/registry/stubs/workflows/marketing/launch-checklist.md +11 -0
  43. package/registry/stubs/workflows/marketing/marketing-strategy.md +11 -0
  44. package/registry/stubs/workflows/marketing/storytelling.md +11 -0
  45. package/registry/stubs/workflows/performance/analyze-performance.md +11 -0
  46. package/registry/stubs/workflows/product-building/design.md +11 -0
  47. package/registry/stubs/workflows/product-building/implement.md +12 -0
  48. package/registry/stubs/workflows/product-building/iterate-on-pr-comments.md +11 -0
  49. package/registry/stubs/workflows/product-building/prep-issue.md +11 -0
  50. package/registry/stubs/workflows/product-building/prototype.md +11 -0
  51. package/registry/stubs/workflows/product-building/resolve.md +11 -0
  52. package/registry/stubs/workflows/product-building/retrospect.md +11 -0
  53. package/registry/stubs/workflows/product-building/spec.md +11 -0
  54. package/registry/stubs/workflows/product-building/test.md +11 -0
  55. package/registry/stubs/workflows/quality-assurance/browser-validation.md +11 -0
  56. package/registry/stubs/workflows/quality-assurance/iterative-improvement-cycle.md +11 -0
  57. package/registry/stubs/workflows/replicate/replicate-discovery.md +11 -0
  58. package/registry/stubs/workflows/replicate/replicate-to-issues.md +11 -0
  59. package/registry/stubs/workflows/reviewer/review-implementation-vs-design-spec.md +11 -0
  60. package/registry/stubs/workflows/reviewer/review-implementation-vs-feature-spec.md +11 -0
  61. package/registry/stubs/workflows/startup-credits/aws-activate-application.md +11 -0
  62. package/registry/stubs/workflows/startup-credits/google-cloud-application.md +11 -0
  63. package/registry/stubs/workflows/startup-credits/microsoft-azure-application.md +11 -0
  64. package/.github/workflows/ci.yml +0 -65
  65. package/.github/workflows/deploy-fraim.yml +0 -87
  66. package/.github/workflows/phase-change.yml +0 -251
  67. package/.github/workflows/status-change.yml +0 -68
  68. package/.github/workflows/sync-on-pr-review.yml +0 -66
  69. package/examples/simple-webapp/TESTING.md +0 -62
  70. package/examples/simple-webapp/example-test.ts +0 -186
  71. package/registry/github/workflows/ci.yml +0 -51
  72. package/registry/github/workflows/phase-change.yml +0 -251
  73. package/registry/github/workflows/status-change.yml +0 -68
  74. package/registry/github/workflows/sync-on-pr-review.yml +0 -66
  75. package/registry/mcp-template.jsonc +0 -29
  76. package/registry/rules/agent-success-criteria.md +0 -52
  77. package/registry/rules/agent-testing-guidelines.md +0 -502
  78. package/registry/rules/architecture.md +0 -52
  79. package/registry/rules/communication.md +0 -122
  80. package/registry/rules/continuous-learning.md +0 -55
  81. package/registry/rules/debugging-multitenancy-issues.md +0 -85
  82. package/registry/rules/ephemeral-execution.md +0 -57
  83. package/registry/rules/git-safe-commands.md +0 -34
  84. package/registry/rules/hitl-ppe-record-analysis.md +0 -302
  85. package/registry/rules/integrity-and-test-ethics.md +0 -275
  86. package/registry/rules/local-development.md +0 -254
  87. package/registry/rules/merge-requirements.md +0 -231
  88. package/registry/rules/simplicity.md +0 -118
  89. package/registry/rules/software-development-lifecycle.md +0 -105
  90. package/registry/rules/spike-first-development.md +0 -205
  91. package/registry/rules/successful-debugging-patterns.md +0 -491
  92. package/registry/rules/telemetry.md +0 -67
  93. package/registry/templates/bootstrap/ARCHITECTURE-TEMPLATE.md +0 -53
  94. package/registry/templates/bootstrap/CODE-QUALITY-REPORT-TEMPLATE.md +0 -37
  95. package/registry/templates/bootstrap/TEST-COVERAGE-REPORT-TEMPLATE.md +0 -35
  96. package/registry/templates/business-development/IDEATION-REPORT-TEMPLATE.md +0 -29
  97. package/registry/templates/business-development/PRICING-STRATEGY-TEMPLATE.md +0 -126
  98. package/registry/templates/customer-development/customer-interview-template.md +0 -99
  99. package/registry/templates/customer-development/follow-up-email-templates.md +0 -132
  100. package/registry/templates/customer-development/insight-analysis-template.md +0 -74
  101. package/registry/templates/customer-development/strategic-recommendations-template.md +0 -53
  102. package/registry/templates/customer-development/thank-you-email-template.html +0 -124
  103. package/registry/templates/customer-development/thank-you-note-template.md +0 -16
  104. package/registry/templates/customer-development/triage-log-template.md +0 -278
  105. package/registry/templates/customer-development/weekly-newsletter-template.html +0 -204
  106. package/registry/templates/evidence/Design-Evidence.md +0 -30
  107. package/registry/templates/evidence/Implementation-BugEvidence.md +0 -86
  108. package/registry/templates/evidence/Implementation-FeatureEvidence.md +0 -121
  109. package/registry/templates/evidence/Spec-Evidence.md +0 -19
  110. package/registry/templates/help/HelpNeeded.md +0 -14
  111. package/registry/templates/marketing/HBR-ARTICLE-TEMPLATE.md +0 -66
  112. package/registry/templates/marketing/STORYTELLING-TEMPLATE.md +0 -130
  113. package/registry/templates/replicate/implementation-checklist.md +0 -39
  114. package/registry/templates/replicate/use-cases-template.md +0 -88
  115. package/registry/templates/retrospective/RETROSPECTIVE-TEMPLATE.md +0 -55
  116. package/registry/templates/specs/BUGSPEC-TEMPLATE.md +0 -37
  117. package/registry/templates/specs/FEATURESPEC-TEMPLATE.md +0 -29
  118. package/registry/templates/specs/TECHSPEC-TEMPLATE.md +0 -39
  119. package/registry/workflows/bootstrap/create-architecture.md +0 -38
  120. package/registry/workflows/bootstrap/evaluate-code-quality.md +0 -36
  121. package/registry/workflows/bootstrap/verify-test-coverage.md +0 -37
  122. package/registry/workflows/business-development/create-business-plan.md +0 -737
  123. package/registry/workflows/business-development/ideate-business-opportunity.md +0 -55
  124. package/registry/workflows/business-development/price-product.md +0 -325
  125. package/registry/workflows/convert-to-pdf.md +0 -235
  126. package/registry/workflows/customer-development/insight-analysis.md +0 -156
  127. package/registry/workflows/customer-development/insight-triage.md +0 -933
  128. package/registry/workflows/customer-development/interview-preparation.md +0 -421
  129. package/registry/workflows/customer-development/linkedin-outreach.md +0 -593
  130. package/registry/workflows/customer-development/strategic-brainstorming.md +0 -146
  131. package/registry/workflows/customer-development/thank-customers.md +0 -203
  132. package/registry/workflows/customer-development/weekly-newsletter.md +0 -366
  133. package/registry/workflows/deploy/cloud-deployment.md +0 -310
  134. package/registry/workflows/improve-fraim/contribute.md +0 -32
  135. package/registry/workflows/improve-fraim/file-issue.md +0 -32
  136. package/registry/workflows/marketing/content-creation.md +0 -37
  137. package/registry/workflows/marketing/hbr-article.md +0 -73
  138. package/registry/workflows/marketing/launch-checklist.md +0 -37
  139. package/registry/workflows/marketing/marketing-strategy.md +0 -45
  140. package/registry/workflows/marketing/storytelling.md +0 -65
  141. package/registry/workflows/performance/analyze-performance.md +0 -65
  142. package/registry/workflows/product-building/design.md +0 -130
  143. package/registry/workflows/product-building/implement.md +0 -315
  144. package/registry/workflows/product-building/iterate-on-pr-comments.md +0 -70
  145. package/registry/workflows/product-building/prep-issue.md +0 -43
  146. package/registry/workflows/product-building/prototype.md +0 -60
  147. package/registry/workflows/product-building/resolve.md +0 -164
  148. package/registry/workflows/product-building/retrospect.md +0 -86
  149. package/registry/workflows/product-building/spec.md +0 -117
  150. package/registry/workflows/product-building/test.md +0 -120
  151. package/registry/workflows/quality-assurance/browser-validation.md +0 -221
  152. package/registry/workflows/quality-assurance/iterative-improvement-cycle.md +0 -562
  153. package/registry/workflows/replicate/replicate-discovery.md +0 -336
  154. package/registry/workflows/replicate/replicate-to-issues.md +0 -319
  155. package/registry/workflows/reviewer/review-implementation-vs-design-spec.md +0 -632
  156. package/registry/workflows/reviewer/review-implementation-vs-feature-spec.md +0 -669
  157. package/registry/workflows/startup-credits/aws-activate-application.md +0 -535
  158. package/registry/workflows/startup-credits/google-cloud-application.md +0 -647
  159. package/registry/workflows/startup-credits/microsoft-azure-application.md +0 -538
@@ -1,156 +0,0 @@
1
- # Insight Analysis Workflow
2
-
3
- ## INTENT
4
- To help Product Managers extract, structure, and analyze customer insights from interview notes, enabling data-driven product decisions and systematic customer relationship management.
5
-
6
- ## PRINCIPLES
7
- - **Comprehensive Extraction**: Capture all insights from raw notes
8
- - **Structured Analysis**: Organize insights into actionable categories
9
- - **Customer Scoring**: Evaluate customer fit and prioritization
10
- - **Follow-up Generation**: Create personalized follow-up communications
11
-
12
- ## WORKFLOW TRIGGER
13
- **PM explicitly starts this workflow**:
14
- - "Starting Insight Analysis for [Customer Name]"
15
- - "I want to analyze the interview with [Customer Name]"
16
- - "Following the insight analysis workflow"
17
-
18
- ## INPUT REQUIREMENTS
19
- **PM provides**:
20
- - The `[customer-name]-interview-prep.md` file that needs to be updated
21
- - Raw interview notes in any format (bullet points, paragraphs, voice-to-text, etc.)
22
- - Brief unstructured thoughts about the interview (optional but helpful)
23
-
24
- ## AI AGENT PROCESS
25
-
26
- ### Step 1: Insight Extraction & Template Update
27
- **AI Agent Analysis Process**:
28
- 1. **Read Existing Prep File**
29
- - Load the `[customer-name]-interview-prep.md` file
30
- - Understand the customer context and research from preparation phase
31
- - Review the pre-filled template structure
32
-
33
- 2. **Parse Raw Notes**
34
- - Extract customer quotes and key statements
35
- - Identify pain points and challenges
36
- - Capture success and failure criteria
37
- - Note feature requests and preferences
38
- - **Date Handling**: If user provides relative time references (e.g., "yesterday", "today", "last Friday"), run `new Date()` to determine the actual date and use that in the analysis file
39
-
40
- 3. **Create Analysis File**
41
- - Create new file: `[customer-name]-interview-analysis.md`
42
- - Include comprehensive analysis with customer scoring and insights
43
- - Reference the prep file for context but keep files separate
44
- - Include follow-up actions and next steps
45
-
46
- ### Step 2: Customer Scoring & Prioritization
47
- **AI Agent Scoring Process**:
48
- 1. **Customer Fit Scoring (1-10)**
49
- - Target customer segment alignment
50
- - Pain point severity and frequency
51
- - Budget and decision-making authority
52
- - Influence and referral potential
53
-
54
- 2. **Urgency Assessment**
55
- - Active seeking of solutions
56
- - Budget allocation and timeline
57
- - Competitive pressure
58
- - Implementation readiness
59
-
60
- 3. **Willingness to Pay**
61
- - Budget authority and constraints
62
- - Current spending on similar solutions
63
- - Value perception and ROI understanding
64
-
65
- ### Step 3: Follow-up Generation
66
- **AI Agent Communication Process**:
67
- 1. **Generate Follow-up Email**
68
- - Use follow-up email templates as reference
69
- - Create personalized email based on interview content
70
- - Include key takeaways confirmation
71
- - Add specific next steps and timeline
72
- - Reference customer quotes and insights
73
-
74
- 2. **Follow-up Questions**
75
- - Clarify any gaps in understanding
76
- - Deepen insights on key topics
77
- - Validate assumptions and priorities
78
- - Explore referral opportunities
79
-
80
- 3. **Next Steps Planning**
81
- - Demo scheduling if appropriate
82
- - Additional stakeholder meetings
83
- - Resource sharing and education
84
- - Timeline and milestone setting
85
-
86
- ### Step 4: File Creation & Finalization
87
- **AI Agent File Management**:
88
- 1. **Create Analysis File**
89
- - Create `[customer-name]-interview-analysis.md` with comprehensive analysis
90
- - Include customer scoring, insights, and follow-up actions
91
- - Reference the prep file for context but keep files separate
92
-
93
- 2. **Preserve Prep File**
94
- - Keep `[customer-name]-interview-prep.md` unchanged
95
- - Maintains clean separation between preparation and analysis
96
- - Both files can be referenced independently
97
-
98
- ## OUTPUT TEMPLATE
99
-
100
- ### Analysis File Template
101
- **Template**: Retrieve via `get_fraim_file({ path: "templates/customer-development/insight-analysis-template.md" })`
102
- **File Location**: `docs/customer-development/[customer-name]-interview-analysis.md`
103
-
104
- **Process**:
105
- 1. Use the insight analysis template
106
- 2. Extract insights from raw interview notes
107
- 3. Score customer based on fit, urgency, willingness to pay, and likelihood to buy
108
- 4. Include direct customer quotes for authenticity
109
- 5. Create next steps and follow-up questions
110
- 6. Reference the original prep file for context
111
- 7. **Generate personalized follow-up email** using follow-up email templates as reference `get_fraim_file({ path: "templates/customer-development/follow-up-email-templates.md" })` ... add this to the end of the analysis file.
112
-
113
- ## EXAMPLES
114
-
115
- ### Good: Insight Analysis
116
- ```
117
- Input:
118
- - File: ronil-dhruva-interview-prep.md
119
- - Raw notes: "Ronil mentioned calendar conflicts, uses Outlook, frustrated with rescheduling, would pay $50/month, concerned about AI decisions. He was really engaged and seemed to understand the problem well."
120
-
121
- AI Agent Process:
122
- 1. Reads existing prep file with LinkedIn research
123
- 2. Extracts insights from raw notes
124
- 3. Creates separate analysis file: ronil-dhruva-interview-analysis.md
125
- 4. Preserves original prep file unchanged
126
- 5. **Generates personalized follow-up email** using follow-up email templates
127
- 6. Creates next steps and follow-up questions
128
-
129
- Output:
130
- - New analysis file: ronil-dhruva-interview-analysis.md
131
- - Original prep file: ronil-dhruva-interview-prep.md (unchanged)
132
- - Customer score: 8/10 (high fit, clear pain points, enterprise budget)
133
- - **Personalized follow-up email** using template structure with customer-specific content
134
- - Next questions: "What specific hierarchy rules should AI respect?"
135
- ```
136
-
137
- ### Bad: Surface-Level Analysis
138
- ```
139
- Input:
140
- - File: ronil-dhruva-interview-prep.md
141
- - Raw notes: "Ronil interview went well"
142
-
143
- AI Agent Output:
144
- - Generic analysis with no specific insights
145
- - No customer scoring or prioritization
146
- - No follow-up recommendations
147
- - No actionable next steps
148
-
149
- Result: Lost insights, no clear next steps, wasted prep work
150
- ```
151
-
152
- ## SUCCESS METRICS
153
- - **Insight Extraction**: 95% of key insights captured from raw notes
154
- - **Customer Scoring**: Consistent scoring across all customers
155
- - **Follow-up Quality**: 80% of follow-up emails result in positive responses
156
- - **Action Clarity**: Clear next steps for every customer