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,213 +0,0 @@
1
- # Learned Skill: saas-contract-development
2
-
3
- **Category:** legal
4
- **Created:** 2026-02-03
5
- **Last Updated:** 2026-02-03
6
- **Project Context:** SaaS business contract creation and negotiation
7
-
8
- ---
9
-
10
- ## INTENT
11
- Create comprehensive, legally protective contract packages for SaaS engagements including SOWs, Terms & Conditions, and strategic pricing negotiations. This skill enables rapid development of professional-grade legal documents that protect IP, limit liability, and position for business growth.
12
-
13
- ## PRINCIPLES
14
- - **Legal Protection First**: Always prioritize IP protection and liability limitation
15
- - **Business Growth Alignment**: Structure contracts to enable expansion and renewal
16
- - **Clear Boundaries**: Explicitly define scope, responsibilities, and limitations
17
- - **Professional Positioning**: Use language that establishes expertise and authority
18
- - **Flexibility with Protection**: Allow for scope changes while maintaining legal safeguards
19
-
20
- ## WORKFLOW
21
-
22
- ### Step 1: Engagement Analysis
23
- **Objective**: Understand the business context and legal requirements
24
-
25
- **Actions**:
26
- 1. Analyze customer profile and industry (financial services, healthcare, etc.)
27
- 2. Identify service delivery model (training, managed services, software licensing)
28
- 3. Assess pricing strategy and revenue model
29
- 4. Determine liability exposure and risk factors
30
- 5. Review existing customer feedback and scope changes
31
-
32
- **Tools/Resources**:
33
- - Customer discovery documents
34
- - Pricing strategy documents
35
- - Industry-specific compliance requirements
36
- - Existing contract templates
37
-
38
- **Output**: Clear understanding of engagement scope, risks, and legal requirements
39
-
40
- ### Step 2: Document Structure Planning
41
- **Objective**: Design the optimal contract package structure
42
-
43
- **Actions**:
44
- 1. Determine if MSA is needed (single engagement vs. ongoing relationship)
45
- 2. Plan SOW scope and deliverables structure
46
- 3. Identify Terms & Conditions requirements
47
- 4. Map pricing model to contract terms
48
- 5. Plan signature and execution process
49
-
50
- **Tools/Resources**:
51
- - Contract template library
52
- - Legal precedent research
53
- - Industry standard practices
54
-
55
- **Output**: Complete document package plan with clear hierarchy
56
-
57
- ### Step 3: SOW Development
58
- **Objective**: Create a comprehensive Statement of Work
59
-
60
- **Actions**:
61
- 1. **Engagement Summary**: Clear objective and delivery model
62
- 2. **Scope Definition**: Detailed in-scope and out-of-scope items
63
- 3. **Pricing Structure**: Transparent pricing with flexibility clauses
64
- 4. **Success Metrics**: Measurable outcomes and evaluation criteria
65
- 5. **IP and Confidentiality**: Clear ownership and protection terms
66
- 6. **Signature Block**: Professional execution format
67
-
68
- **Key SOW Elements**:
69
- - Advisory vs. delivery accountability boundaries
70
- - Pricing reevaluation clauses for expansion
71
- - Flexible scope change management
72
- - Clear customer responsibility statements
73
-
74
- **Tools/Resources**:
75
- - SOW templates (`templates/sow-template.md`)
76
- - Pricing calculators
77
- - Success metrics frameworks
78
- - Template variables guide (`templates/template-variables.md`)
79
-
80
- **Output**: Complete, professional SOW ready for negotiation
81
-
82
- ### Step 4: Terms & Conditions Creation
83
- **Objective**: Develop comprehensive SaaS Terms & Conditions
84
-
85
- **Actions**:
86
- 1. **Service Description**: Clear platform and service definitions
87
- 2. **IP Protection**: Comprehensive ownership and licensing terms
88
- 3. **Liability Limitation**: Maximum protection within legal bounds
89
- 4. **Data Protection**: Privacy and security commitments
90
- 5. **Service Levels**: Realistic availability and support commitments
91
- 6. **Legal Framework**: Governing law, dispute resolution, termination
92
-
93
- **Critical T&C Sections**:
94
- - Zero or minimal liability clauses
95
- - Strong IP retention language
96
- - Minimal data retention policies
97
- - Flexible support commitments
98
- - Comprehensive indemnification
99
-
100
- **Tools/Resources**:
101
- - Legal template libraries (`templates/saas-terms-template.md`)
102
- - Industry standard T&C examples
103
- - Jurisdiction-specific requirements
104
- - Template variables guide (`templates/template-variables.md`)
105
-
106
- **Output**: Legally protective Terms & Conditions document
107
-
108
- ### Step 5: Document Integration & Review
109
- **Objective**: Ensure document consistency and legal coherence
110
-
111
- **Actions**:
112
- 1. Cross-reference SOW and T&C for consistency
113
- 2. Verify pricing alignment across documents
114
- 3. Check IP ownership consistency
115
- 4. Validate liability protection coverage
116
- 5. Ensure professional formatting and presentation
117
-
118
- **Review Checklist**:
119
- - [ ] IP ownership clearly defined in both documents
120
- - [ ] Liability limitations consistent
121
- - [ ] Pricing terms align with business model
122
- - [ ] Scope boundaries clearly established
123
- - [ ] Professional presentation quality
124
-
125
- **Tools/Resources**:
126
- - Document comparison tools
127
- - Legal review checklists
128
- - Professional formatting standards
129
-
130
- **Output**: Integrated, consistent contract package
131
-
132
- ### Step 6: PDF Generation & Delivery
133
- **Objective**: Create professional presentation-ready documents
134
-
135
- **Actions**:
136
- 1. Install markdown-to-PDF conversion tools (`npm install -g md-to-pdf`)
137
- 2. Convert documents with professional formatting
138
- 3. Verify PDF quality and readability
139
- 4. Organize files for client delivery
140
- 5. Prepare document package for negotiation
141
-
142
- **PDF Generation Commands**:
143
- ```bash
144
- md-to-pdf "document.md" --pdf-options '{"format": "A4", "margin": {"top": "1in", "right": "1in", "bottom": "1in", "left": "1in"}}'
145
- ```
146
-
147
- **Tools/Resources**:
148
- - md-to-pdf npm package
149
- - PDF formatting standards
150
- - Professional document templates
151
-
152
- **Output**: Professional PDF contract package ready for client presentation
153
-
154
-
155
- ### Common Pitfalls
156
- - **Scope Creep**: Not clearly defining out-of-scope items
157
- - **Liability Exposure**: Insufficient liability limitation language
158
- - **IP Confusion**: Unclear ownership of work product vs. platform
159
- - **Pricing Rigidity**: No mechanism for scope or pricing adjustments
160
- - **Poor Presentation**: Unprofessional document formatting
161
-
162
- ## SUCCESS CRITERIA
163
- - [ ] Complete contract package (SOW + T&C) created
164
- - [ ] IP ownership clearly protected
165
- - [ ] Liability exposure minimized or eliminated
166
- - [ ] Pricing structure supports business growth
167
- - [ ] Professional PDF documents generated
168
- - [ ] Client-ready presentation package delivered
169
- - [ ] Legal boundaries clearly established
170
- - [ ] Expansion/renewal mechanisms included
171
-
172
- ## PRICING STRATEGY INTEGRATION
173
-
174
- ### Tier-Based Pricing Approach
175
- - **Core Framework**: Low-cost entry point
176
- - **Acceleration Academy**: Training + software bundle
177
- - **Managed Delivery**: High-touch service delivery
178
-
179
- ### Contract Pricing Tactics
180
- - Hybrid models (licensing + services)
181
- - Reevaluation clauses for expansion
182
- - Volume discounts for longer commitments
183
- - Success-based pricing adjustments
184
-
185
- ## LEGAL PROTECTION CHECKLIST
186
-
187
- ### IP Protection
188
- - [ ] Platform ownership retained
189
- - [ ] Work product ownership defined
190
- - [ ] Improvement rights reserved
191
- - [ ] Feedback usage rights secured
192
-
193
- ### Liability Limitation
194
- - [ ] Zero liability clause (where legally permissible)
195
- - [ ] Warranty disclaimers included
196
- - [ ] Consequential damages excluded
197
- - [ ] Maximum liability caps set
198
-
199
- ### Data Protection
200
- - [ ] Minimal data retention policies
201
- - [ ] Processing purpose limitations
202
- - [ ] Security commitment levels
203
- - [ ] Breach notification procedures
204
-
205
- ## NOTES
206
- - Always customize jurisdiction and governing law based on business location
207
- - Consider industry-specific compliance requirements (SOC 2, HIPAA, etc.)
208
- - Maintain template library for rapid contract development
209
- - Keep pricing strategy documents aligned with contract terms
210
- - Regular legal review recommended for template updates
211
- - PDF generation ensures professional presentation and prevents unauthorized edits
212
- - **Templates Available**: Use `templates/sow-template.md` and `templates/saas-terms-template.md` with `templates/template-variables.md` guide for rapid contract creation. Get these files using get_fraim_file MCP toolcall
213
- - **Variable Substitution**: All `[VARIABLE]` placeholders must be replaced before finalizing documents
@@ -1,77 +0,0 @@
1
- # Workflow: trademark-filing
2
-
3
- **Path:** `workflows/legal/trademark-filing.md`
4
-
5
- ---
6
-
7
- # Trademark Filing Workflow
8
-
9
- ## INTENT
10
- To conduct comprehensive trademark searches, analyze registrability, and file trademark applications that protect brand names, logos, and slogans while avoiding conflicts with existing marks and maximizing protection scope.
11
-
12
- ## PRINCIPLES
13
- - **Comprehensive Search**: Thorough analysis of existing trademarks and common law rights
14
- - **Strategic Classification**: Optimal selection of goods/services classes for maximum protection
15
- - **Strong Distinctiveness**: Ensure marks are distinctive and protectable
16
- - **Global Perspective**: Consider international trademark strategy and Madrid Protocol
17
- - **Brand Protection**: Create comprehensive brand protection strategy
18
-
19
- ## TRADEMARK FILING WORKFLOW
20
-
21
- ### Step 1: Trademark Identification
22
- Define the marks to be protected:
23
- - Word marks (brand names, slogans)
24
- - Design marks (logos, symbols)
25
- - Combined marks (word + design)
26
- - Trade dress (product appearance)
27
- - Sound marks or other non-traditional marks
28
-
29
- ### Step 2: Comprehensive Trademark Search
30
- Conduct multi-level search strategy:
31
- - USPTO Trademark Electronic Search System (TESS)
32
- - State trademark databases
33
- - Common law trademark search
34
- - Domain name availability
35
- - Social media handle availability
36
- - International trademark databases
37
-
38
- ### Step 3: Registrability Analysis
39
- Evaluate trademark strength and registrability:
40
- - **Distinctiveness**: Arbitrary, suggestive, descriptive, or generic
41
- - **Likelihood of Confusion**: Similarity to existing marks
42
- - **Absolute Bars**: Descriptive, deceptive, scandalous content
43
- - **Prior Rights**: Common law and registered trademark conflicts
44
-
45
- ### Step 4: Goods and Services Classification
46
- Strategic class selection and description:
47
- - International Classification (Nice Classification)
48
- - Broad vs. narrow descriptions
49
- - Future business expansion considerations
50
- - Multi-class filing strategy
51
-
52
- ### Step 5: Filing Strategy Development
53
- Determine optimal filing approach:
54
- - Intent-to-Use vs. Use-in-Commerce
55
- - Madrid Protocol for international protection
56
- - Priority filing jurisdictions
57
- - Timing and budget considerations
58
-
59
- ### Step 6: Application Preparation and Filing
60
- Create complete trademark application:
61
- - Mark identification and description
62
- - Goods/services descriptions
63
- - Specimens of use (if applicable)
64
- - Declaration and signatures
65
- - Filing fees and forms
66
-
67
- ## TEMPLATE USAGE
68
-
69
- Use `get_fraim_file({ path: "templates/legal/TRADEMARK-TEMPLATE.md" })` to create:
70
- - `docs/legal/trademarks/{mark-name}-{date}-application.md`
71
-
72
- ## OUTPUT
73
- - Comprehensive trademark search report
74
- - Registrability analysis and recommendations
75
- - Professional trademark application
76
- - International filing strategy
77
- - Brand protection roadmap
@@ -1,37 +0,0 @@
1
- # Workflow: content-creation
2
-
3
- **Path:** `workflows/marketing/content-creation.md`
4
-
5
- ---
6
-
7
- # Content Creation Phase
8
-
9
- ## INTENT
10
- To produce high-quality marketing assets, including blog posts, social media content, and email campaigns, that effectively communicate the feature's value.
11
-
12
- ## PRINCIPLES
13
- - **Storytelling**: Use narratives to engage the audience.
14
- - **Visual Excellence**: Ensure all assets are visually appealing and on-brand.
15
- - **Consistency**: Maintain a consistent voice and style across all content.
16
- - **Action-Oriented**: Include clear calls to action in all materials.
17
-
18
- ## CONTENT CREATION WORKFLOW
19
-
20
- ### Step 1: Asset Identification
21
- - What assets are needed based on the strategy? (Blog post, Social thread, Email)
22
-
23
- ### Step 2: Drafting
24
- - Create drafts for each asset in `docs/marketing/content/{issue_number}/`
25
- - Follow the brand voice guidelines.
26
-
27
- ### Step 3: Visual Asset Prep
28
- - Identify core screenshots or diagrams needed.
29
- - Write descriptions for images.
30
-
31
- ### Step 4: Review
32
- - Ensure content is free of errors and aligns with the strategy.
33
-
34
- ## OUTPUT
35
- - Blog Post Draft
36
- - Social Media Thread Draft
37
- - Email Campaign Draft
@@ -1,235 +0,0 @@
1
- # Convert to PDF Workflow
2
-
3
- ## INTENT
4
- To provide agents with a reliable workflow for converting markdown files to professional PDF documents, enabling seamless document sharing and archival while maintaining formatting integrity and visual appeal.
5
-
6
- ## PRINCIPLES
7
- - **Format Preservation**: Maintain all markdown formatting including tables, code blocks, and images
8
- - **Professional Output**: Generate clean, readable PDFs suitable for business use
9
- - **Flexible Configuration**: Support various paper formats, margins, and styling options
10
- - **Error Resilience**: Handle common conversion issues gracefully with clear error messages
11
- - **Cross-Platform Compatibility**: Work consistently across Windows, macOS, and Linux
12
-
13
- ## Overview
14
- This workflow guides agents through converting markdown files to PDF format using the markdown-to-pdf script. The conversion maintains formatting, supports code highlighting, tables, and images while producing professional-looking PDF documents.
15
-
16
- ## When to Use
17
- - User requests converting markdown documentation to PDF
18
- - Need to generate PDF reports from markdown content
19
- - Creating printable versions of specifications or documentation
20
- - Sharing formatted documents with stakeholders who prefer PDF format
21
- - Archiving documentation in a portable format
22
-
23
- ## Prerequisites
24
- Before using this workflow, ensure the following dependencies are installed:
25
-
26
- ```bash
27
- npm install puppeteer markdown-it markdown-it-highlightjs
28
- ```
29
-
30
- ## Script Location
31
- The conversion script is synced to: `~/.fraim/scripts/markdown-to-pdf.js`
32
-
33
- ## Workflow Steps
34
-
35
- ### Phase 1: Validate Environment
36
-
37
- 1. **Check Dependencies**
38
- ```bash
39
- node -e "console.log('puppeteer:', require.resolve('puppeteer')); console.log('markdown-it:', require.resolve('markdown-it')); console.log('markdown-it-highlightjs:', require.resolve('markdown-it-highlightjs'));"
40
- ```
41
-
42
- 2. **Verify Script Availability**
43
- - Confirm `~/.fraim/scripts/markdown-to-pdf.js` exists
44
- - Check script permissions (executable on Unix systems)
45
-
46
- 3. **Test Basic Functionality**
47
- ```bash
48
- node ~/.fraim/scripts/markdown-to-pdf.js --help
49
- ```
50
-
51
- ### Phase 2: Prepare Input
52
-
53
- 1. **Validate Input File**
54
- - Confirm markdown file exists and is readable
55
- - Check for any syntax issues in markdown
56
- - Verify image paths are correct and accessible
57
-
58
- 2. **Determine Output Requirements**
59
- - Ask user about desired output location
60
- - Confirm paper format preferences (A4, Letter, etc.)
61
- - Check if custom styling is needed
62
- - Determine header/footer requirements
63
-
64
- 3. **Prepare Output Directory**
65
- - Ensure output directory exists
66
- - Verify write permissions
67
-
68
- ### Phase 3: Execute Conversion
69
-
70
- 1. **Basic Conversion**
71
- ```bash
72
- node ~/.fraim/scripts/markdown-to-pdf.js <input.md>
73
- ```
74
-
75
- 2. **Advanced Conversion with Options**
76
- ```bash
77
- node ~/.fraim/scripts/markdown-to-pdf.js <input.md> [output.pdf] [options]
78
- ```
79
-
80
- 3. **Monitor Progress**
81
- - Watch for error messages
82
- - Verify successful completion
83
- - Check output file size and accessibility
84
-
85
- ### Phase 4: Validate Output
86
-
87
- 1. **Verify PDF Generation**
88
- - Confirm PDF file was created
89
- - Check file size is reasonable
90
- - Verify file is not corrupted
91
-
92
- 2. **Quality Check**
93
- - Review formatting preservation
94
- - Check image rendering
95
- - Verify code block highlighting
96
- - Confirm table alignment
97
-
98
- 3. **User Acceptance**
99
- - Share output location with user
100
- - Confirm output meets requirements
101
- - Offer to regenerate with different options if needed
102
-
103
- ### Available Options
104
-
105
- | Option | Description | Example |
106
- |--------|-------------|---------|
107
- | `--format <format>` | Paper format (A4, Letter, Legal, etc.) | `--format Letter` |
108
- | `--margin <margin>` | Page margins in inches | `--margin 1` |
109
- | `--css <file>` | Custom CSS file for styling | `--css custom.css` |
110
- | `--header <text>` | Header text | `--header "Company Report"` |
111
- | `--footer <text>` | Footer text | `--footer "Page <span class='pageNumber'></span>"` |
112
- | `--landscape` | Use landscape orientation | `--landscape` |
113
- | `--no-background` | Disable background graphics | `--no-background` |
114
-
115
- ### Common Examples
116
-
117
- 1. **Basic conversion:**
118
- ```bash
119
- node ~/.fraim/scripts/markdown-to-pdf.js README.md
120
- ```
121
-
122
- 2. **Specify output location:**
123
- ```bash
124
- node ~/.fraim/scripts/markdown-to-pdf.js docs/spec.md output/specification.pdf
125
- ```
126
-
127
- 3. **Letter format with custom margins:**
128
- ```bash
129
- node ~/.fraim/scripts/markdown-to-pdf.js report.md --format Letter --margin 0.75
130
- ```
131
-
132
- 4. **With custom styling:**
133
- ```bash
134
- node ~/.fraim/scripts/markdown-to-pdf.js document.md --css styles/custom.css --header "Project Documentation"
135
- ```
136
-
137
- 5. **Landscape orientation:**
138
- ```bash
139
- node ~/.fraim/scripts/markdown-to-pdf.js wide-table.md --landscape --format A3
140
- ```
141
-
142
- ## Agent Instructions
143
-
144
- When a user requests markdown to PDF conversion:
145
-
146
- 1. **Identify the source file(s)**: Confirm which markdown file(s) need to be converted
147
- 2. **Check dependencies**: Verify that required npm packages are installed
148
- 3. **Determine output requirements**: Ask about:
149
- - Desired output location
150
- - Paper format preferences
151
- - Custom styling needs
152
- - Header/footer requirements
153
- 4. **Execute conversion**: Run the appropriate command with the specified options
154
- 5. **Verify output**: Confirm the PDF was generated successfully and meets requirements
155
-
156
- ### Error Handling
157
-
158
- If the script fails:
159
- - Check that all dependencies are installed
160
- - Verify the input file exists and is readable
161
- - Ensure the output directory is writable
162
- - Check for any syntax errors in the markdown file
163
-
164
- ### Troubleshooting Common Issues
165
-
166
- 1. **Missing dependencies**: Install required packages with npm
167
- 2. **Permission errors**: Ensure write permissions for output directory
168
- 3. **Large files**: Consider breaking large markdown files into smaller sections
169
- 4. **Image issues**: Verify image paths are correct and accessible
170
- 5. **Font rendering**: Use web-safe fonts or include custom font CSS
171
-
172
- ## Customization
173
-
174
- ### Custom CSS Styling
175
- Create a CSS file to customize the PDF appearance:
176
-
177
- ```css
178
- /* custom-style.css */
179
- body {
180
- font-family: 'Times New Roman', serif;
181
- font-size: 12pt;
182
- }
183
-
184
- h1 {
185
- color: #2c3e50;
186
- border-bottom: 3px solid #3498db;
187
- }
188
-
189
- code {
190
- background-color: #f0f0f0;
191
- border: 1px solid #ccc;
192
- }
193
-
194
- @page {
195
- margin: 1in;
196
- @top-center {
197
- content: "Confidential Document";
198
- }
199
- }
200
- ```
201
-
202
- ### Batch Processing
203
- For converting multiple files, create a simple loop:
204
-
205
- ```bash
206
- for file in docs/*.md; do
207
- node ~/.fraim/scripts/markdown-to-pdf.js "$file" "output/$(basename "$file" .md).pdf"
208
- done
209
- ```
210
-
211
- ## Quality Assurance
212
-
213
- After conversion, verify:
214
- - All content is present and properly formatted
215
- - Images are displayed correctly
216
- - Code blocks maintain syntax highlighting
217
- - Tables are properly aligned
218
- - Page breaks occur at appropriate locations
219
- - Headers and footers appear as expected
220
-
221
- ## Best Practices
222
-
223
- 1. **Test with sample content** before processing important documents
224
- 2. **Use consistent styling** across related documents
225
- 3. **Optimize images** for better PDF file size
226
- 4. **Consider accessibility** when choosing fonts and colors
227
- 5. **Version control** both source markdown and generated PDFs when appropriate
228
-
229
- ## Integration with Other Workflows
230
-
231
- This workflow can be combined with:
232
- - Documentation generation workflows
233
- - Report automation processes
234
- - CI/CD pipelines for document publishing
235
- - Content review and approval workflows