fraim-framework 2.0.36 → 2.0.38
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/fraim.js +5 -52
- package/dist/registry/scripts/build-scripts-generator.js +205 -0
- package/dist/registry/scripts/fraim-config.js +61 -0
- package/dist/registry/scripts/generic-issues-api.js +100 -0
- package/dist/registry/scripts/openapi-generator.js +664 -0
- package/dist/registry/scripts/performance/profile-server.js +390 -0
- package/dist/scripts/build-stub-registry.js +108 -0
- package/dist/src/cli/commands/doctor.js +5 -5
- package/dist/src/cli/commands/init-project.js +74 -0
- package/dist/src/cli/commands/setup.js +176 -0
- package/dist/src/cli/commands/sync.js +33 -19
- package/dist/src/cli/commands/test-mcp.js +135 -0
- package/dist/src/cli/fraim.js +6 -0
- package/dist/src/cli/setup/auto-mcp-setup.js +367 -0
- package/dist/src/cli/setup/ide-detector.js +163 -0
- package/dist/src/cli/setup/mcp-config-generator.js +115 -0
- package/dist/src/cli/setup/token-validator.js +49 -0
- package/dist/test-utils.js +96 -0
- package/dist/tests/debug-tools.js +2 -2
- package/dist/tests/esm-compat.js +11 -0
- package/dist/tests/shared-server-utils.js +57 -0
- package/dist/tests/test-chalk-esm-issue.js +159 -0
- package/dist/tests/test-chalk-real-world.js +265 -0
- package/dist/tests/test-chalk-regression.js +2 -18
- package/dist/tests/test-chalk-resolution-issue.js +304 -0
- package/dist/tests/test-client-scripts-validation.js +27 -5
- package/dist/tests/test-complete-setup-flow.js +110 -0
- package/dist/tests/test-fraim-install-chalk-issue.js +254 -0
- package/dist/tests/test-ide-detector.js +46 -0
- package/dist/tests/test-improved-setup.js +121 -0
- package/dist/tests/test-mcp-config-generator.js +70 -0
- package/dist/tests/test-mcp-connection.js +58 -117
- package/dist/tests/test-mcp-issue-integration.js +2 -2
- package/dist/tests/test-mcp-lifecycle-methods.js +34 -100
- package/dist/tests/test-mcp-shared-server.js +308 -0
- package/dist/tests/test-npm-resolution-diagnostic.js +140 -0
- package/dist/tests/test-package-size.js +101 -0
- package/dist/tests/test-prep-issue.js +34 -1
- package/dist/tests/test-script-location-independence.js +39 -62
- package/dist/tests/test-server-utils.js +32 -0
- package/dist/tests/test-session-rehydration.js +2 -2
- package/dist/tests/test-setup-integration.js +98 -0
- package/dist/tests/test-standalone.js +2 -2
- package/dist/tests/test-stub-registry.js +136 -0
- package/dist/tests/test-sync-stubs.js +143 -0
- package/dist/tests/test-telemetry.js +2 -2
- package/dist/tests/test-token-validator.js +30 -0
- package/dist/tests/test-user-journey.js +2 -1
- package/package.json +7 -9
- package/registry/agent-guardrails.md +62 -62
- package/registry/scripts/code-quality-check.sh +559 -559
- package/registry/scripts/detect-tautological-tests.sh +38 -38
- package/registry/scripts/prep-issue.sh +61 -30
- package/registry/scripts/validate-openapi-limits.ts +366 -366
- package/registry/scripts/validate-test-coverage.ts +280 -280
- package/registry/scripts/verify-pr-comments.sh +70 -70
- package/registry/stubs/workflows/bootstrap/create-architecture.md +11 -0
- package/registry/stubs/workflows/bootstrap/detect-broken-windows.md +11 -0
- package/registry/stubs/workflows/bootstrap/evaluate-code-quality.md +11 -0
- package/registry/stubs/workflows/bootstrap/verify-test-coverage.md +11 -0
- package/registry/stubs/workflows/business-development/create-business-plan.md +11 -0
- package/registry/stubs/workflows/business-development/ideate-business-opportunity.md +11 -0
- package/registry/stubs/workflows/business-development/price-product.md +18 -0
- package/registry/stubs/workflows/convert-to-pdf.md +11 -0
- package/registry/stubs/workflows/customer-development/insight-analysis.md +11 -0
- package/registry/stubs/workflows/customer-development/insight-triage.md +11 -0
- package/registry/stubs/workflows/customer-development/interview-preparation.md +11 -0
- package/registry/stubs/workflows/customer-development/linkedin-outreach.md +11 -0
- package/registry/stubs/workflows/customer-development/strategic-brainstorming.md +11 -0
- package/registry/stubs/workflows/customer-development/thank-customers.md +11 -0
- package/registry/stubs/workflows/customer-development/weekly-newsletter.md +11 -0
- package/registry/stubs/workflows/deploy/cloud-deployment.md +11 -0
- package/registry/stubs/workflows/improve-fraim/contribute.md +11 -0
- package/registry/stubs/workflows/improve-fraim/file-issue.md +11 -0
- package/registry/stubs/workflows/marketing/content-creation.md +11 -0
- package/registry/stubs/workflows/marketing/hbr-article.md +11 -0
- package/registry/stubs/workflows/marketing/launch-checklist.md +11 -0
- package/registry/stubs/workflows/marketing/marketing-strategy.md +11 -0
- package/registry/stubs/workflows/marketing/storytelling.md +11 -0
- package/registry/stubs/workflows/performance/analyze-performance.md +11 -0
- package/registry/stubs/workflows/product-building/design.md +11 -0
- package/registry/stubs/workflows/product-building/implement.md +12 -0
- package/registry/stubs/workflows/product-building/iterate-on-pr-comments.md +11 -0
- package/registry/stubs/workflows/product-building/prep-issue.md +11 -0
- package/registry/stubs/workflows/product-building/prototype.md +11 -0
- package/registry/stubs/workflows/product-building/resolve.md +11 -0
- package/registry/stubs/workflows/product-building/retrospect.md +11 -0
- package/registry/stubs/workflows/product-building/spec.md +11 -0
- package/registry/stubs/workflows/product-building/test.md +11 -0
- package/registry/stubs/workflows/quality-assurance/browser-validation.md +11 -0
- package/registry/stubs/workflows/quality-assurance/iterative-improvement-cycle.md +11 -0
- package/registry/stubs/workflows/replicate/replicate-discovery.md +11 -0
- package/registry/stubs/workflows/replicate/replicate-to-issues.md +11 -0
- package/registry/stubs/workflows/reviewer/review-implementation-vs-design-spec.md +11 -0
- package/registry/stubs/workflows/reviewer/review-implementation-vs-feature-spec.md +11 -0
- package/registry/stubs/workflows/startup-credits/aws-activate-application.md +11 -0
- package/registry/stubs/workflows/startup-credits/google-cloud-application.md +11 -0
- package/registry/stubs/workflows/startup-credits/microsoft-azure-application.md +11 -0
- package/.github/workflows/ci.yml +0 -65
- package/.github/workflows/deploy-fraim.yml +0 -87
- package/.github/workflows/phase-change.yml +0 -251
- package/.github/workflows/status-change.yml +0 -68
- package/.github/workflows/sync-on-pr-review.yml +0 -66
- package/examples/simple-webapp/TESTING.md +0 -62
- package/examples/simple-webapp/example-test.ts +0 -186
- package/registry/github/workflows/ci.yml +0 -51
- package/registry/github/workflows/phase-change.yml +0 -251
- package/registry/github/workflows/status-change.yml +0 -68
- package/registry/github/workflows/sync-on-pr-review.yml +0 -66
- package/registry/mcp-template.jsonc +0 -29
- package/registry/rules/agent-success-criteria.md +0 -52
- package/registry/rules/agent-testing-guidelines.md +0 -502
- package/registry/rules/architecture.md +0 -52
- package/registry/rules/communication.md +0 -122
- package/registry/rules/continuous-learning.md +0 -55
- package/registry/rules/debugging-multitenancy-issues.md +0 -85
- package/registry/rules/ephemeral-execution.md +0 -57
- package/registry/rules/git-safe-commands.md +0 -34
- package/registry/rules/hitl-ppe-record-analysis.md +0 -302
- package/registry/rules/integrity-and-test-ethics.md +0 -275
- package/registry/rules/local-development.md +0 -254
- package/registry/rules/merge-requirements.md +0 -231
- package/registry/rules/simplicity.md +0 -118
- package/registry/rules/software-development-lifecycle.md +0 -105
- package/registry/rules/spike-first-development.md +0 -205
- package/registry/rules/successful-debugging-patterns.md +0 -491
- package/registry/rules/telemetry.md +0 -67
- package/registry/templates/bootstrap/ARCHITECTURE-TEMPLATE.md +0 -53
- package/registry/templates/bootstrap/CODE-QUALITY-REPORT-TEMPLATE.md +0 -37
- package/registry/templates/bootstrap/TEST-COVERAGE-REPORT-TEMPLATE.md +0 -35
- package/registry/templates/business-development/IDEATION-REPORT-TEMPLATE.md +0 -29
- package/registry/templates/business-development/PRICING-STRATEGY-TEMPLATE.md +0 -126
- package/registry/templates/customer-development/customer-interview-template.md +0 -99
- package/registry/templates/customer-development/follow-up-email-templates.md +0 -132
- package/registry/templates/customer-development/insight-analysis-template.md +0 -74
- package/registry/templates/customer-development/strategic-recommendations-template.md +0 -53
- package/registry/templates/customer-development/thank-you-email-template.html +0 -124
- package/registry/templates/customer-development/thank-you-note-template.md +0 -16
- package/registry/templates/customer-development/triage-log-template.md +0 -278
- package/registry/templates/customer-development/weekly-newsletter-template.html +0 -204
- package/registry/templates/evidence/Design-Evidence.md +0 -30
- package/registry/templates/evidence/Implementation-BugEvidence.md +0 -86
- package/registry/templates/evidence/Implementation-FeatureEvidence.md +0 -121
- package/registry/templates/evidence/Spec-Evidence.md +0 -19
- package/registry/templates/help/HelpNeeded.md +0 -14
- package/registry/templates/marketing/HBR-ARTICLE-TEMPLATE.md +0 -66
- package/registry/templates/replicate/implementation-checklist.md +0 -39
- package/registry/templates/replicate/use-cases-template.md +0 -88
- package/registry/templates/retrospective/RETROSPECTIVE-TEMPLATE.md +0 -55
- package/registry/templates/specs/BUGSPEC-TEMPLATE.md +0 -37
- package/registry/templates/specs/FEATURESPEC-TEMPLATE.md +0 -29
- package/registry/templates/specs/TECHSPEC-TEMPLATE.md +0 -39
- package/registry/workflows/bootstrap/create-architecture.md +0 -38
- package/registry/workflows/bootstrap/evaluate-code-quality.md +0 -36
- package/registry/workflows/bootstrap/verify-test-coverage.md +0 -37
- package/registry/workflows/business-development/create-business-plan.md +0 -737
- package/registry/workflows/business-development/ideate-business-opportunity.md +0 -55
- package/registry/workflows/business-development/price-product.md +0 -325
- package/registry/workflows/convert-to-pdf.md +0 -235
- package/registry/workflows/customer-development/insight-analysis.md +0 -156
- package/registry/workflows/customer-development/insight-triage.md +0 -933
- package/registry/workflows/customer-development/interview-preparation.md +0 -421
- package/registry/workflows/customer-development/linkedin-outreach.md +0 -593
- package/registry/workflows/customer-development/strategic-brainstorming.md +0 -146
- package/registry/workflows/customer-development/thank-customers.md +0 -203
- package/registry/workflows/customer-development/weekly-newsletter.md +0 -366
- package/registry/workflows/deploy/cloud-deployment.md +0 -310
- package/registry/workflows/improve-fraim/contribute.md +0 -32
- package/registry/workflows/improve-fraim/file-issue.md +0 -32
- package/registry/workflows/marketing/content-creation.md +0 -37
- package/registry/workflows/marketing/hbr-article.md +0 -73
- package/registry/workflows/marketing/launch-checklist.md +0 -37
- package/registry/workflows/marketing/marketing-strategy.md +0 -45
- package/registry/workflows/performance/analyze-performance.md +0 -65
- package/registry/workflows/product-building/design.md +0 -130
- package/registry/workflows/product-building/implement.md +0 -315
- package/registry/workflows/product-building/iterate-on-pr-comments.md +0 -70
- package/registry/workflows/product-building/prep-issue.md +0 -43
- package/registry/workflows/product-building/prototype.md +0 -60
- package/registry/workflows/product-building/resolve.md +0 -164
- package/registry/workflows/product-building/retrospect.md +0 -86
- package/registry/workflows/product-building/spec.md +0 -117
- package/registry/workflows/product-building/test.md +0 -120
- package/registry/workflows/quality-assurance/browser-validation.md +0 -221
- package/registry/workflows/quality-assurance/iterative-improvement-cycle.md +0 -562
- package/registry/workflows/replicate/replicate-discovery.md +0 -336
- package/registry/workflows/replicate/replicate-to-issues.md +0 -319
- package/registry/workflows/reviewer/review-implementation-vs-design-spec.md +0 -632
- package/registry/workflows/reviewer/review-implementation-vs-feature-spec.md +0 -669
- package/registry/workflows/startup-credits/aws-activate-application.md +0 -535
- package/registry/workflows/startup-credits/google-cloud-application.md +0 -647
- 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
|