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,55 +0,0 @@
1
- # Workflow: ideate-business-opportunity
2
-
3
- **Path:** `workflows/business-development/ideate-business-opportunity.md`
4
-
5
- ---
6
-
7
- # Ideate Business Opportunity Phase
8
-
9
- ## INTENT
10
- To help founders and product owners navigate the broad, fuzzy front-end of product development. This workflow guides the transition from a "vague space" to "concrete feature deliverables" through interactive brainstorming and research.
11
-
12
- ## PRINCIPLES
13
- - **Interactive Exploration**: This is not a one-shot process. It requires multiple cycles of feedback.
14
- - **Founder-Led**: The founder's intuition is the compass; the agent provides the map and vehicle.
15
- - **Outcome-Oriented**: The goal is NOT just a list of ideas, but a prioritized, repo-ready backlog.
16
- - **Divergent Thinking**:
17
- - **Defer Judgment**: Do not criticize or discard ideas in the early stages.
18
- - **Go for Volume**: Quantity often leads to quality. Aim for a wide range of options.
19
- - **Cross-Pollinate**: Combine unrelated concepts or industries to find unique angles.
20
- - **Challenge Constraints**: Ask "What if X wasn't a limitation?"
21
- - **Interactive Refinement**: Use feedback to branch into new directions, even if they seem tangential.
22
-
23
- ## IDEATION WORKFLOW
24
-
25
- ### Step 1: Broad Mapping (Divergent)
26
- - Ask the founder for their initial "Spark" or "Space".
27
- - **Exploration Protocol**:
28
- - When an idea is proposed, respond with 3-5 distinct "What if" scenarios or variations.
29
- - Avoid saying "That's not possible" or "That's too expensive" during this stage.
30
- - Use tools to describe or visualize the space before narrowing down.
31
- - Generate 3-5 distinct sub-spaces or "angles" within that spark.
32
- - **Exit Criteria**: Founder chooses 1-2 directions to explore further.
33
-
34
- ### Step 2: Interactive Research & Validation
35
- - For the chosen directions, research:
36
- - Existing competitors (even indirect ones).
37
- - Potential user personas.
38
- - Technical feasibility (high-level).
39
- - Present findings and ask for "Pivot or Persevere" feedback.
40
-
41
- ### Step 3: Feature Synthesis (Convergent)
42
- - Based on the validated direction, brainstorm a set of potential features.
43
- - Map features against: **Complexity** vs. **Value**.
44
- - **Exit Criteria**: Founder approves a "Hero" feature and 3-5 supporting features.
45
-
46
- ### Step 4: Repository Documentation
47
- - Formalize the findings into a report.
48
- - **ACTION**: Call `get_fraim_file({ path: "templates/business-development/IDEATION-REPORT-TEMPLATE.md" })`.
49
- - Create `docs/ideation/{YYYYMMDD}-{project-name}.md`.
50
- - **Outcome**: A file that a PM agent can use to write `specs`.
51
-
52
- ## OUTPUT
53
- - `docs/ideation/[project].md`
54
- - Prioritized Feature Backlog
55
- - High-level Vision & Persona Map
@@ -1,325 +0,0 @@
1
- ## INTENT
2
-
3
- To create a comprehensive **pricing + packaging strategy** for any product that:
4
-
5
- * clarifies who the product is for and what outcomes it delivers,
6
- * defines SKUs, tiers, add-ons, and the pricing metric,
7
- * ties pricing to unit economics and scalability,
8
- * and positions the product clearly against competitors and substitutes.
9
-
10
- ---
11
-
12
- ## PRINCIPLES
13
-
14
- * **Outcome-first**: Price and packaging must map to customer outcomes, not features
15
- * **Simple packaging**: Fewer SKUs, clearer upgrade path, lower decision friction
16
- * **Credible claims**: Use evidence, ranges, and benchmarks; avoid brittle promises
17
- * **Economic grounding**: Every SKU must connect to COGS, margin targets, and scalability limits
18
- * **Competitive honesty**: Don’t invent competitor pricing; cite sources or state “not public”
19
- * **Procurement-friendly**: Prefer predictable add-ons/tiers over opaque metered token pricing
20
- * **Reusable framework**: The same structure should work for B2B, B2C, SaaS, services, and hybrid models
21
- * **Citations required**: All competitive facts should be sourced with dates
22
-
23
- ---
24
-
25
- ## WORKFLOW OVERVIEW
26
-
27
- This workflow produces a single comprehensive document (`docs/business-development/pricing-strategy.md`) that follows the template in `templates/business-development/PRICING-STRATEGY-TEMPLATE.md`.
28
-
29
- ---
30
-
31
- ## STEP-BY-STEP WORKFLOW
32
-
33
- ### Step 1: Product Context Gathering
34
-
35
- **Objective:** Understand the product, buyer, and constraints.
36
-
37
- **Actions:**
38
-
39
- 1. Capture product one-liner and primary outcomes
40
- 2. Identify who pays vs who uses (buyer vs end user)
41
- 3. Define product type: SaaS, usage-based, services, hybrid
42
- 4. Capture current stage: MVP/beta/GA and current pricing (if any)
43
- 5. Capture business constraints:
44
-
45
- * margin targets
46
- * delivery capacity (if services/hybrid)
47
- * sales motion (self-serve vs sales-led)
48
- * contract constraints (annual, PO, procurement)
49
-
50
- **Output:** Product context section (10–20 bullets)
51
-
52
- ---
53
-
54
- ### Step 2: Customer Segmentation (ICP + willingness-to-pay)
55
-
56
- **Objective:** Identify 3–7 segments with different value and pricing sensitivity.
57
-
58
- **Process:**
59
-
60
- 1. Brainstorm segments by pain intensity and frequency
61
- 2. Score each segment:
62
-
63
- * Pain intensity
64
- * Frequency of use
65
- * Budget owner clarity
66
- * Willingness to pay
67
- * Ease of reach (distribution)
68
- * Competitive alternatives
69
- 3. Select 2–4 priority segments (tip-of-the-spear)
70
- 4. For each segment document:
71
-
72
- * Customer profile
73
- * Job-to-be-done
74
- * Core pains
75
- * Current alternatives
76
- * Buying process and budget source
77
- * Success metrics they care about
78
-
79
- **Output:** Segment cards + segment comparison table
80
-
81
- ---
82
-
83
- ### Step 3: Outcome Narrative (the “why” before pricing)
84
-
85
- **Objective:** Build an exec-readable narrative that sets up the pricing table.
86
-
87
- **Actions:**
88
-
89
- 1. Write a headline framing value (speed, cost, quality, risk reduction, revenue)
90
- 2. Explain why outcomes vary with usage maturity (if applicable)
91
- 3. Describe the customer journey in 3 “paths” or “maturity levels” (optional but powerful):
92
-
93
- * Self-serve power user
94
- * Guided/coached adopter
95
- * Managed delivery / done-for-you (if offered)
96
- 4. Add a clear CTA (“If you’re here and want to be there…”)
97
-
98
- **Output:** One-page narrative suitable for a brochure
99
-
100
- ---
101
-
102
- ### Step 4: Define Packaging (SKUs, tiers, and boundaries)
103
-
104
- **Objective:** Create a SKU/tier map that is simple and scalable.
105
-
106
- **Actions:**
107
-
108
- 1. Define 3–6 SKUs by **customer need** (e.g., role-based, module-based, team-based, use-case-based)
109
- 2. Define tiers (Good/Better/Best) or maturity tiers (Self-serve / Guided / Managed)
110
- 3. For each SKU/tier define:
111
-
112
- * Outcomes delivered
113
- * Included capabilities
114
- * Exclusions/limits (what’s not included)
115
- * Primary success metrics
116
- * Who it’s for (buyer/user)
117
- 4. Ensure upgrade path is explicit:
118
-
119
- * When to move up a tier
120
- * What triggers expansion (more users, more volume, more scope)
121
-
122
- **Output:** SKU catalog + tier comparison table
123
-
124
- ---
125
-
126
- ### Step 5: Choose a Pricing Metric (what you charge “per”)
127
-
128
- **Objective:** Pick a pricing unit that scales with value and is hard to game.
129
-
130
- **Common metrics (choose 1 primary):**
131
-
132
- * Per user / seat
133
- * Per team / workspace
134
- * Per project
135
- * Per workflow/run
136
- * Per asset (e.g., report, doc, build, analysis)
137
- * Per integration
138
- * % of spend / % of savings (rare; needs strong proof)
139
- * Tiered capacity bundles (recommended for predictability)
140
-
141
- **Selection criteria:**
142
-
143
- * Aligns with value
144
- * Understandable to buyers
145
- * Predictable billing
146
- * Resistant to abuse
147
- * Matches cost-to-serve drivers
148
-
149
- **Output:** Pricing metric decision + rationale + alternatives rejected
150
-
151
- ---
152
-
153
- ### Step 6: Build the Price List (tables first, numbers second)
154
-
155
- **Objective:** Produce clean pricing tables and packaging rules.
156
-
157
- **Actions:**
158
-
159
- 1. Start with a single “hero” table (e.g., 3 columns × 3 rows):
160
-
161
- * Columns = tiers/maturity levels
162
- * Rows = what you get (outcomes), what you save/earn, what you pay
163
- 2. Expand into:
164
-
165
- * SKU × tier grid (if needed)
166
- * Add-on list
167
- 3. Define discounting:
168
-
169
- * annual prepay discount
170
- * volume discount principles
171
- * partner/channel margins (if relevant)
172
-
173
- **Output:** Pricing tables + add-ons + discount rules
174
-
175
- ---
176
-
177
- ### Step 7: Unit Economics + Scalability Model
178
-
179
- **Objective:** Ensure pricing is profitable, defensible, and scalable.
180
-
181
- **Actions:**
182
-
183
- 1. Identify COGS drivers:
184
-
185
- * compute/infrastructure
186
- * support burden
187
- * onboarding/training
188
- * professional services / delivery labor
189
- * third-party fees
190
- 2. For each SKU/tier estimate:
191
-
192
- * expected usage / volume
193
- * expected support hours
194
- * expected compute cost
195
- * gross margin target
196
- 3. Model edge cases:
197
-
198
- * power users
199
- * low-usage churners
200
- * heavy-support customers
201
- 4. Define guardrails:
202
-
203
- * caps
204
- * fair-use limits
205
- * paid add-on packs for overflow
206
- * staffing ratios (if managed services)
207
-
208
- **Output:** Unit economics assumptions table + margin estimates by SKU/tier
209
-
210
- ---
211
-
212
- ### Step 8: Competitive Landscape & Positioning (research required)
213
-
214
- **Objective:** Build a credible pricing/positioning story vs alternatives.
215
-
216
- **Actions:**
217
-
218
- 1. Identify 10–20 competitors/substitutes across:
219
-
220
- * direct competitors
221
- * adjacent tools
222
- * “do nothing/manual”
223
- * agencies/contractors (if relevant)
224
- 2. For each competitor:
225
-
226
- * what they sell
227
- * who buys
228
- * pricing model (cite sources, include dates)
229
- * strengths/weaknesses vs your product
230
- 3. Synthesize:
231
-
232
- * differentiation pillars (3–5)
233
- * win/loss reasons
234
- * objection handling talk tracks
235
-
236
- **Output:** Competitive matrix + positioning section (with citations)
237
-
238
- ---
239
-
240
- ### Step 9: Risks, Objections, and Mitigations
241
-
242
- **Objective:** Preempt the hardest questions and reduce churn risk.
243
-
244
- **Actions:**
245
-
246
- * Identify 5–10 risks:
247
-
248
- * credibility of claims
249
- * adoption friction
250
- * pricing confusion
251
- * margin erosion
252
- * scaling services
253
- * procurement/security concerns
254
- * competitor response
255
- * For each:
256
-
257
- * impact
258
- * mitigation
259
- * owner
260
- * measurable leading indicator
261
-
262
- **Output:** Risk table
263
-
264
- ---
265
-
266
- ### Step 10: Validation Plan (pricing experiments + rollout)
267
-
268
- **Objective:** Test assumptions quickly before locking prices.
269
-
270
- **Actions:**
271
-
272
- 1. Define experiments:
273
-
274
- * price sensitivity interviews (Van Westendorp / Gabor-Granger style)
275
- * landing page A/B price anchoring
276
- * pilot offers with 2–3 packaging variants
277
- * sales-led quote testing
278
- 2. Define metrics:
279
-
280
- * conversion
281
- * activation/time-to-value
282
- * expansion
283
- * churn
284
- * support burden
285
- * gross margin
286
- 3. Create 30/60/90 day plan
287
-
288
- **Output:** Validation plan + timeline + decision points
289
-
290
- ---
291
-
292
- ## References
293
- - All citations with date + URL
294
- ```
295
-
296
- ---
297
-
298
- ## QUALITY CHECKLIST
299
-
300
- ### Content
301
-
302
- * [ ] Pricing is outcome-first, not feature-first
303
- * [ ] SKUs/tiers are simple with a clear upgrade path
304
- * [ ] Pricing metric is understandable and predictable
305
- * [ ] Add-ons reduce edge-case margin risk
306
- * [ ] Sales motion is supported (self-serve vs sales-led)
307
-
308
- ### Economics
309
-
310
- * [ ] COGS drivers identified and bounded
311
- * [ ] Gross margin targets by tier are explicit
312
- * [ ] Guardrails (caps/add-ons) prevent abuse and margin collapse
313
-
314
- ### Competitive
315
-
316
- * [ ] No invented competitor pricing
317
- * [ ] Citations + dates included for competitive facts
318
- * [ ] Win/loss reasons are honest and actionable
319
-
320
- ### Validation
321
-
322
- * [ ] At least 3 pricing experiments defined
323
- * [ ] Metrics are clear and decision points are scheduled
324
-
325
- ---
@@ -1,78 +0,0 @@
1
- # Detect Compliance Requirements
2
-
3
- ## INTENT
4
- Analyze feature descriptions to detect applicable compliance frameworks, then update project configuration.
5
-
6
- ## OUTCOME
7
- - Project `.fraim/config.json` updated with confirmed regulations list
8
- - Clear understanding of which compliance frameworks apply
9
-
10
- ## WORKFLOW
11
-
12
- ### Step 1: Analyze Feature Description and Context
13
- Look for compliance indicators from multiple sources:
14
-
15
- **Feature Description Analysis**:
16
- - **Financial**: payment, transaction, receipt, disbursement, funds, money → FinRA
17
- - **UI**: interface, customer-facing, website, dashboard, form → WCAG
18
- - **Data**: personal data, customer information, pii, sensitive data → GDPR
19
- - **Payment Processing**: credit card, payment processing, card data → PCI DSS
20
-
21
- **Deep Context Analysis**:
22
- - Read existing business documentation and plans
23
- - Analyze codebase for compliance-related implementations
24
- - Review existing compliance documentation
25
- - Consider user stories and acceptance criteria
26
-
27
- ### Step 2: Check Project Industry
28
- Read `.fraim/config.json` and check `project.industry`:
29
- - `financial-services` → Likely FinRA, State Financial
30
- - `healthcare` → Likely HIPAA
31
- - `e-commerce` → Likely PCI DSS, GDPR
32
- - `software-development` → Likely SOC 2, ISO 27001
33
-
34
- ### Step 3: Present Detection Results
35
- Show user detected regulations with reasoning.
36
-
37
- ### Step 4: User Confirmation
38
- Ask user to confirm which regulations apply.
39
-
40
- **Important**: Updating the config will cause future specs to automatically include compliance requirements for these regulations.
41
-
42
- ### Step 5: Update Configuration
43
- Once user confirms, update `.fraim/config.json` (preserving existing content):
44
- ```json
45
- {
46
- "compliance": {
47
- "regulations": ["finra", "wcag", "gdpr"],
48
- "compliance_specifications": {
49
- "finra": "https://www.finra.org/rules-guidance",
50
- "wcag": "https://www.w3.org/WAI/WCAG21/quickref/",
51
- "gdpr": "https://gdpr-info.eu/"
52
- }
53
- }
54
- }
55
- ```
56
-
57
- **Standard Reference URLs by Regulation:**
58
- - **finra**: https://www.finra.org/rules-guidance
59
- - **pci**: https://www.pcisecuritystandards.org/standards/
60
- - **wcag**: https://www.w3.org/WAI/WCAG21/quickref/
61
- - **gdpr**: https://gdpr-info.eu/
62
- - **ccpa**: https://oag.ca.gov/privacy/ccpa
63
- - **soc2**: https://www.aicpa.org/resources/landing/system-and-organization-controls-soc-suite-of-services
64
- - **iso27001**: https://www.iso.org/standard/27001
65
- - **hipaa**: https://www.hhs.gov/hipaa/for-professionals/security/laws-regulations/index.html
66
- - **fedramp**: https://www.fedramp.gov/documents/
67
-
68
- **Note**: Only include regulations and URLs that apply to the project. Users can override URLs with company-specific documentation.
69
-
70
- ### Step 6: Next Steps
71
- Tell user to add or update compliance_specifications with document links:
72
- ```json
73
- {
74
- "compliance_specifications": [
75
- {"<regulation_name>": "<doc_link_or_location"}
76
- ]
77
- }
78
- ```
@@ -1,75 +0,0 @@
1
- # Generate Audit Evidence
2
-
3
- ## INTENT
4
- Generate compliance audit documentation by analyzing implementations against regulatory requirements.
5
-
6
- ## OUTCOME
7
- - Audit documentation generated
8
- - Evidence mapped to regulatory requirements from compliance_specifications
9
-
10
- ## WORKFLOW
11
-
12
- ### Step 1: Read Compliance Configuration
13
- Read `.fraim/config.json`:
14
- ```json
15
- {
16
- "compliance": {
17
- "regulations": ["finra", "wcag"],
18
- "compliance_specifications": [
19
- {"name": "FinRA Requirements", "pointer": "https://company.com/finra-requirements.pdf"},
20
- {"name": "WCAG Standards", "pointer": "https://company.com/accessibility-standards.pdf"}
21
- ]
22
- }
23
- }
24
- ```
25
-
26
- ### Step 2: Get Evidence Files from User
27
- Ask user which files/implementations to analyze for compliance evidence.
28
-
29
- ### Step 3: Analyze Evidence Against Requirements
30
- For each regulation:
31
- 1. **Reference Requirements Document**: Tell agent "Ensure this implementation abides by the requirements specified in [pointer]"
32
- 2. **Analyze Implementation**: Review provided files against the specification document
33
- 3. **Document Evidence**: Map code/implementations to regulatory requirements
34
- 4. **Create Evidence Document**: Generate detailed compliance evidence document
35
-
36
- ### Step 4: Generate Audit Reports and Evidence Document
37
- Create compliance reports by regulation and a comprehensive evidence document:
38
-
39
- **Evidence Document Structure**:
40
- ```markdown
41
- # Compliance Evidence Report - [Feature Name]
42
-
43
- ## Executive Summary
44
- - Overall compliance status: [X]% compliant
45
- - Regulations analyzed: [list]
46
- - Critical gaps: [number]
47
-
48
- ## Detailed Evidence by Regulation
49
-
50
- ### FinRA Compliance
51
- **Requirements Source**: [FinRA Requirements](https://company.com/finra-requirements.pdf)
52
- **Evidence Analysis**:
53
- - ✅ **COMPLIANT**: Transaction Logging in `src/services/transaction-logger.ts`
54
- - Evidence: Code implements required fields (date, amount, type, account)
55
- - Verification: Unit tests pass, audit trail functional
56
- - ❌ **NON-COMPLIANT**: Record Retention Policy
57
- - Gap: No automated retention policy implemented
58
- - Required Action: Implement 3-year retention automation
59
- ```
60
-
61
- **Example FinRA Report**:
62
- ```markdown
63
- ## FinRA Compliance Evidence
64
- **Requirements Source**: [FinRA Requirements](https://company.com/finra-requirements.pdf)
65
- **Agent Instruction**: Ensure all implementations abide by requirements specified in the above document.
66
-
67
- **Implementation Analysis**:
68
- - ✅ Transaction Logging: `src/services/transaction-logger.ts` - Compliant
69
- - ❌ Record Retention: Missing automated retention policy
70
- ```
71
-
72
- ### Step 5: Reference Compliance Specifications
73
- Always reference the original compliance specification:
74
- **Requirement Source**: As specified in [document name](pointer URL)
75
- **Agent Instruction**: Ensure all implementations abide by the requirements specified in the above document