fraim-framework 2.0.66 → 2.0.67

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 (254) hide show
  1. package/dist/registry/ai-manager-rules/customer-development-phases/phase1-customer-profiling.md +101 -0
  2. package/dist/registry/ai-manager-rules/customer-development-phases/phase2-platform-discovery.md +235 -0
  3. package/dist/registry/ai-manager-rules/customer-development-phases/phase3-prospect-qualification.md +243 -0
  4. package/dist/registry/ai-manager-rules/customer-development-phases/phase4-inventory-compilation.md +206 -0
  5. package/dist/registry/ai-manager-rules/design-phases/design-completeness-review.md +73 -0
  6. package/dist/registry/ai-manager-rules/design-phases/design-design.md +145 -0
  7. package/dist/registry/ai-manager-rules/design-phases/design.md +108 -0
  8. package/dist/registry/ai-manager-rules/design-phases/finalize.md +60 -0
  9. package/dist/registry/ai-manager-rules/design-phases/validate.md +125 -0
  10. package/dist/registry/ai-manager-rules/design.json +97 -0
  11. package/dist/registry/ai-manager-rules/implement-phases/code.md +323 -0
  12. package/dist/registry/ai-manager-rules/implement-phases/completeness-review.md +94 -0
  13. package/dist/registry/ai-manager-rules/implement-phases/finalize.md +177 -0
  14. package/dist/registry/ai-manager-rules/implement-phases/implement-code.md +283 -0
  15. package/dist/registry/ai-manager-rules/implement-phases/implement-completeness-review.md +120 -0
  16. package/dist/registry/ai-manager-rules/implement-phases/implement-regression.md +173 -0
  17. package/dist/registry/ai-manager-rules/implement-phases/implement-repro.md +104 -0
  18. package/dist/registry/ai-manager-rules/implement-phases/implement-scoping.md +100 -0
  19. package/dist/registry/ai-manager-rules/implement-phases/implement-smoke.md +237 -0
  20. package/dist/registry/ai-manager-rules/implement-phases/implement-spike.md +121 -0
  21. package/dist/registry/ai-manager-rules/implement-phases/implement-validate.md +375 -0
  22. package/dist/registry/ai-manager-rules/implement-phases/quality-review.md +304 -0
  23. package/dist/registry/ai-manager-rules/implement-phases/regression.md +159 -0
  24. package/dist/registry/ai-manager-rules/implement-phases/repro.md +101 -0
  25. package/dist/registry/ai-manager-rules/implement-phases/scoping.md +93 -0
  26. package/dist/registry/ai-manager-rules/implement-phases/smoke.md +225 -0
  27. package/dist/registry/ai-manager-rules/implement-phases/spike.md +118 -0
  28. package/dist/registry/ai-manager-rules/implement-phases/validate.md +347 -0
  29. package/dist/registry/ai-manager-rules/implement.json +153 -0
  30. package/dist/registry/ai-manager-rules/retrospective.md +116 -0
  31. package/dist/registry/ai-manager-rules/shared-phases/address-pr-feedback.md +188 -0
  32. package/dist/registry/ai-manager-rules/shared-phases/finalize.md +169 -0
  33. package/dist/registry/ai-manager-rules/shared-phases/submit-pr.md +202 -0
  34. package/dist/registry/ai-manager-rules/shared-phases/wait-for-pr-review.md +170 -0
  35. package/dist/registry/ai-manager-rules/spec-phases/finalize.md +60 -0
  36. package/dist/registry/ai-manager-rules/spec-phases/spec-competitor-analysis.md +105 -0
  37. package/dist/registry/ai-manager-rules/spec-phases/spec-completeness-review.md +66 -0
  38. package/dist/registry/ai-manager-rules/spec-phases/spec-spec.md +139 -0
  39. package/dist/registry/ai-manager-rules/spec-phases/spec.md +102 -0
  40. package/dist/registry/ai-manager-rules/spec-phases/validate.md +118 -0
  41. package/dist/registry/ai-manager-rules/spec.json +112 -0
  42. package/dist/registry/ai-manager-rules/test.json +98 -0
  43. package/dist/registry/ai-manager-rules/user-survey-phases/phase1-survey-scoping.md +60 -0
  44. package/dist/registry/ai-manager-rules/user-survey-phases/phase2-survey-build-linkedin.md +23 -0
  45. package/dist/registry/ai-manager-rules/user-survey-phases/phase3-survey-build-reddit.md +22 -0
  46. package/dist/registry/ai-manager-rules/user-survey-phases/phase4-survey-build-x.md +21 -0
  47. package/dist/registry/ai-manager-rules/user-survey-phases/phase5-survey-build-facebook.md +19 -0
  48. package/dist/registry/ai-manager-rules/user-survey-phases/phase6-survey-build-custom.md +15 -0
  49. package/dist/registry/ai-manager-rules/user-survey-phases/phase7-survey-dispatch.md +45 -0
  50. package/dist/registry/delivery/address-feedback.md +83 -0
  51. package/dist/registry/delivery/retrospective.md +78 -0
  52. package/dist/registry/delivery/submit.md +79 -0
  53. package/dist/registry/providers/ado.json +19 -0
  54. package/dist/registry/providers/delivery-conversation.json +9 -0
  55. package/dist/registry/providers/delivery-pr.json +9 -0
  56. package/dist/registry/providers/github.json +19 -0
  57. package/dist/registry/rules/agent-success-criteria.md +101 -0
  58. package/dist/registry/rules/agent-testing-guidelines.md +502 -0
  59. package/dist/registry/rules/architecture.md +126 -0
  60. package/dist/registry/rules/communication.md +122 -0
  61. package/dist/registry/rules/continuous-learning.md +55 -0
  62. package/dist/registry/rules/debugging-multitenancy-issues.md +85 -0
  63. package/dist/registry/rules/ephemeral-execution.md +54 -0
  64. package/dist/registry/rules/git-safe-commands.md +34 -0
  65. package/dist/registry/rules/hitl-ppe-record-analysis.md +302 -0
  66. package/dist/registry/rules/integrity-and-test-ethics.md +275 -0
  67. package/dist/registry/rules/local-development.md +275 -0
  68. package/dist/registry/rules/mandatory-pre-completion-reflection.md +193 -0
  69. package/dist/registry/rules/merge-requirements.md +238 -0
  70. package/dist/registry/rules/simplicity.md +118 -0
  71. package/dist/registry/rules/software-development-lifecycle.md +105 -0
  72. package/dist/registry/rules/spike-first-development.md +205 -0
  73. package/dist/registry/rules/successful-debugging-patterns.md +488 -0
  74. package/dist/registry/scripts/build-scripts-generator.js +205 -0
  75. package/dist/registry/scripts/cleanup-branch.js +287 -0
  76. package/dist/registry/scripts/evaluate-code-quality.js +66 -0
  77. package/dist/registry/scripts/exec-with-timeout.js +142 -0
  78. package/dist/registry/scripts/fraim-config.js +61 -0
  79. package/dist/registry/scripts/generate-engagement-emails.js +705 -0
  80. package/dist/registry/scripts/generic-issues-api.js +100 -0
  81. package/dist/registry/scripts/newsletter-helpers.js +671 -0
  82. package/dist/registry/scripts/openapi-generator.js +664 -0
  83. package/dist/registry/scripts/performance/profile-server.js +390 -0
  84. package/dist/registry/scripts/profile-server.js +389 -0
  85. package/dist/registry/scripts/run-thank-you-workflow.js +92 -0
  86. package/dist/registry/scripts/send-newsletter-simple.js +85 -0
  87. package/dist/registry/scripts/send-thank-you-emails.js +54 -0
  88. package/dist/registry/scripts/validate-openapi-limits.js +311 -0
  89. package/dist/registry/scripts/validate-test-coverage.js +262 -0
  90. package/dist/registry/scripts/verify-test-coverage.js +66 -0
  91. package/dist/registry/stubs/workflows/azure/cost-optimization.md +11 -0
  92. package/dist/registry/stubs/workflows/bootstrap/create-architecture.md +11 -0
  93. package/dist/registry/stubs/workflows/bootstrap/detect-broken-windows.md +11 -0
  94. package/dist/registry/stubs/workflows/bootstrap/evaluate-code-quality.md +11 -0
  95. package/dist/registry/stubs/workflows/bootstrap/verify-test-coverage.md +11 -0
  96. package/dist/registry/stubs/workflows/brainstorming/blue-sky-brainstorming.md +11 -0
  97. package/dist/registry/stubs/workflows/brainstorming/codebase-brainstorming.md +11 -0
  98. package/dist/registry/stubs/workflows/business-development/create-business-plan.md +11 -0
  99. package/dist/registry/stubs/workflows/business-development/ideate-business-opportunity.md +11 -0
  100. package/dist/registry/stubs/workflows/business-development/price-product.md +18 -0
  101. package/dist/registry/stubs/workflows/compliance/detect-compliance-requirements.md +11 -0
  102. package/dist/registry/stubs/workflows/compliance/generate-audit-evidence.md +11 -0
  103. package/dist/registry/stubs/workflows/compliance/soc2-evidence-generator.md +11 -0
  104. package/dist/registry/stubs/workflows/customer-development/insight-analysis.md +11 -0
  105. package/dist/registry/stubs/workflows/customer-development/insight-triage.md +11 -0
  106. package/dist/registry/stubs/workflows/customer-development/interview-preparation.md +11 -0
  107. package/dist/registry/stubs/workflows/customer-development/linkedin-outreach.md +11 -0
  108. package/dist/registry/stubs/workflows/customer-development/strategic-brainstorming.md +11 -0
  109. package/dist/registry/stubs/workflows/customer-development/thank-customers.md +11 -0
  110. package/dist/registry/stubs/workflows/customer-development/user-survey-dispatch.md +11 -0
  111. package/dist/registry/stubs/workflows/customer-development/users-to-target.md +11 -0
  112. package/dist/registry/stubs/workflows/customer-development/weekly-newsletter.md +11 -0
  113. package/dist/registry/stubs/workflows/deploy/cloud-deployment.md +11 -0
  114. package/dist/registry/stubs/workflows/improve-fraim/contribute.md +11 -0
  115. package/dist/registry/stubs/workflows/improve-fraim/file-issue.md +11 -0
  116. package/dist/registry/stubs/workflows/learning/build-skillset.md +11 -0
  117. package/dist/registry/stubs/workflows/learning/synthesize-learnings.md +11 -0
  118. package/dist/registry/stubs/workflows/legal/contract-review-analysis.md +11 -0
  119. package/dist/registry/stubs/workflows/legal/nda.md +11 -0
  120. package/dist/registry/stubs/workflows/legal/patent-filing.md +11 -0
  121. package/dist/registry/stubs/workflows/legal/saas-contract-development.md +11 -0
  122. package/dist/registry/stubs/workflows/legal/trademark-filing.md +11 -0
  123. package/dist/registry/stubs/workflows/marketing/content-creation.md +11 -0
  124. package/dist/registry/stubs/workflows/marketing/convert-to-pdf.md +11 -0
  125. package/dist/registry/stubs/workflows/marketing/create-modern-website.md +11 -0
  126. package/dist/registry/stubs/workflows/marketing/domain-registration.md +11 -0
  127. package/dist/registry/stubs/workflows/marketing/evangelize.md +11 -0
  128. package/dist/registry/stubs/workflows/marketing/hbr-article.md +11 -0
  129. package/dist/registry/stubs/workflows/marketing/launch-checklist.md +11 -0
  130. package/dist/registry/stubs/workflows/marketing/marketing-strategy.md +11 -0
  131. package/dist/registry/stubs/workflows/marketing/storytelling.md +11 -0
  132. package/dist/registry/stubs/workflows/performance/analyze-performance.md +11 -0
  133. package/dist/registry/stubs/workflows/product-building/design.md +11 -0
  134. package/dist/registry/stubs/workflows/product-building/implement.md +11 -0
  135. package/dist/registry/stubs/workflows/product-building/iterate-on-pr-comments.md +11 -0
  136. package/dist/registry/stubs/workflows/product-building/prep-issue.md +11 -0
  137. package/dist/registry/stubs/workflows/product-building/prototype.md +11 -0
  138. package/dist/registry/stubs/workflows/product-building/resolve.md +11 -0
  139. package/dist/registry/stubs/workflows/product-building/retrospect.md +11 -0
  140. package/dist/registry/stubs/workflows/product-building/spec.md +11 -0
  141. package/dist/registry/stubs/workflows/product-building/test.md +11 -0
  142. package/dist/registry/stubs/workflows/productivity-report/productivity-report.md +11 -0
  143. package/dist/registry/stubs/workflows/quality-assurance/browser-validation.md +11 -0
  144. package/dist/registry/stubs/workflows/quality-assurance/iterative-improvement-cycle.md +11 -0
  145. package/dist/registry/stubs/workflows/replicate/replicate-discovery.md +11 -0
  146. package/dist/registry/stubs/workflows/replicate/replicate-to-issues.md +11 -0
  147. package/dist/registry/stubs/workflows/reviewer/review-implementation-vs-design-spec.md +11 -0
  148. package/dist/registry/stubs/workflows/reviewer/review-implementation-vs-feature-spec.md +11 -0
  149. package/dist/registry/stubs/workflows/startup-credits/aws-activate-application.md +11 -0
  150. package/dist/registry/stubs/workflows/startup-credits/google-cloud-application.md +11 -0
  151. package/dist/registry/stubs/workflows/startup-credits/microsoft-azure-application.md +11 -0
  152. package/dist/registry/templates/bootstrap/ARCHITECTURE-TEMPLATE.md +53 -0
  153. package/dist/registry/templates/bootstrap/CODE-QUALITY-REPORT-TEMPLATE.md +37 -0
  154. package/dist/registry/templates/bootstrap/TEST-COVERAGE-REPORT-TEMPLATE.md +35 -0
  155. package/dist/registry/templates/business-development/IDEATION-REPORT-TEMPLATE.md +29 -0
  156. package/dist/registry/templates/business-development/PRICING-STRATEGY-TEMPLATE.md +126 -0
  157. package/dist/registry/templates/customer-development/customer-interview-template.md +99 -0
  158. package/dist/registry/templates/customer-development/customer-persona-template.md +69 -0
  159. package/dist/registry/templates/customer-development/follow-up-email-templates.md +132 -0
  160. package/dist/registry/templates/customer-development/insight-analysis-template.md +74 -0
  161. package/dist/registry/templates/customer-development/prospect-inventory-template.csv +3 -0
  162. package/dist/registry/templates/customer-development/search-strategy-template.md +123 -0
  163. package/dist/registry/templates/customer-development/strategic-recommendations-template.md +53 -0
  164. package/dist/registry/templates/customer-development/thank-you-email-template.html +124 -0
  165. package/dist/registry/templates/customer-development/thank-you-note-template.md +16 -0
  166. package/dist/registry/templates/customer-development/triage-log-template.md +278 -0
  167. package/dist/registry/templates/customer-development/weekly-newsletter-template.html +204 -0
  168. package/dist/registry/templates/evidence/Design-Evidence.md +30 -0
  169. package/dist/registry/templates/evidence/Implementation-BugEvidence.md +122 -0
  170. package/dist/registry/templates/evidence/Implementation-FeatureEvidence.md +160 -0
  171. package/dist/registry/templates/evidence/Spec-Evidence.md +19 -0
  172. package/dist/registry/templates/help/HelpNeeded.md +14 -0
  173. package/dist/registry/templates/legal/NDA-TEMPLATE.md +170 -0
  174. package/dist/registry/templates/legal/PATENT-TEMPLATE.md +372 -0
  175. package/dist/registry/templates/legal/TRADEMARK-TEMPLATE.md +339 -0
  176. package/dist/registry/templates/legal/contract-review-checklist.md +193 -0
  177. package/dist/registry/templates/legal/review-report-template.md +198 -0
  178. package/dist/registry/templates/legal/saas-terms-template.md +174 -0
  179. package/dist/registry/templates/legal/sow-template.md +117 -0
  180. package/dist/registry/templates/legal/template-variables.md +131 -0
  181. package/dist/registry/templates/marketing/DOMAIN-REGISTRATION-TEMPLATE.md +194 -0
  182. package/dist/registry/templates/marketing/EVANGELIZE-TEMPLATE.md +102 -0
  183. package/dist/registry/templates/marketing/HBR-ARTICLE-TEMPLATE.md +66 -0
  184. package/dist/registry/templates/marketing/STORYTELLING-TEMPLATE.md +130 -0
  185. package/dist/registry/templates/marketing/WEBSITE-TEMPLATE.md +262 -0
  186. package/dist/registry/templates/marketing/github-pages-workflow.yml +64 -0
  187. package/dist/registry/templates/replicate/implementation-checklist.md +39 -0
  188. package/dist/registry/templates/replicate/use-cases-template.md +88 -0
  189. package/dist/registry/templates/retrospective/RETROSPECTIVE-TEMPLATE.md +55 -0
  190. package/dist/registry/templates/specs/BUGSPEC-TEMPLATE.md +37 -0
  191. package/dist/registry/templates/specs/FEATURESPEC-TEMPLATE.md +66 -0
  192. package/dist/registry/templates/specs/TECHSPEC-TEMPLATE.md +39 -0
  193. package/dist/registry/workflows/azure/cost-optimization.md +772 -0
  194. package/dist/registry/workflows/bootstrap/create-architecture.md +37 -0
  195. package/dist/registry/workflows/bootstrap/detect-broken-windows.md +300 -0
  196. package/dist/registry/workflows/bootstrap/evaluate-code-quality.md +35 -0
  197. package/dist/registry/workflows/bootstrap/verify-test-coverage.md +36 -0
  198. package/dist/registry/workflows/brainstorming/blue-sky-brainstorming.md +211 -0
  199. package/dist/registry/workflows/brainstorming/codebase-brainstorming.md +159 -0
  200. package/dist/registry/workflows/business-development/create-business-plan.md +737 -0
  201. package/dist/registry/workflows/business-development/ideate-business-opportunity.md +55 -0
  202. package/dist/registry/workflows/business-development/price-product.md +325 -0
  203. package/dist/registry/workflows/compliance/detect-compliance-requirements.md +80 -0
  204. package/dist/registry/workflows/compliance/generate-audit-evidence.md +80 -0
  205. package/dist/registry/workflows/compliance/soc2-evidence-generator.md +332 -0
  206. package/dist/registry/workflows/customer-development/insight-analysis.md +156 -0
  207. package/dist/registry/workflows/customer-development/insight-triage.md +933 -0
  208. package/dist/registry/workflows/customer-development/interview-preparation.md +452 -0
  209. package/dist/registry/workflows/customer-development/linkedin-outreach.md +599 -0
  210. package/dist/registry/workflows/customer-development/strategic-brainstorming.md +146 -0
  211. package/dist/registry/workflows/customer-development/thank-customers.md +203 -0
  212. package/dist/registry/workflows/customer-development/user-survey-dispatch.md +312 -0
  213. package/dist/registry/workflows/customer-development/users-to-target.md +427 -0
  214. package/dist/registry/workflows/customer-development/weekly-newsletter.md +366 -0
  215. package/dist/registry/workflows/deploy/cloud-deployment.md +310 -0
  216. package/dist/registry/workflows/improve-fraim/contribute.md +32 -0
  217. package/dist/registry/workflows/improve-fraim/file-issue.md +32 -0
  218. package/dist/registry/workflows/learning/build-skillset.md +212 -0
  219. package/dist/registry/workflows/learning/synthesize-learnings.md +369 -0
  220. package/dist/registry/workflows/legal/contract-review-analysis.md +382 -0
  221. package/dist/registry/workflows/legal/nda.md +69 -0
  222. package/dist/registry/workflows/legal/patent-filing.md +76 -0
  223. package/dist/registry/workflows/legal/saas-contract-development.md +204 -0
  224. package/dist/registry/workflows/legal/trademark-filing.md +77 -0
  225. package/dist/registry/workflows/marketing/content-creation.md +40 -0
  226. package/dist/registry/workflows/marketing/convert-to-pdf.md +265 -0
  227. package/dist/registry/workflows/marketing/create-modern-website.md +456 -0
  228. package/dist/registry/workflows/marketing/domain-registration.md +323 -0
  229. package/dist/registry/workflows/marketing/evangelize.md +426 -0
  230. package/dist/registry/workflows/marketing/hbr-article.md +73 -0
  231. package/dist/registry/workflows/marketing/launch-checklist.md +37 -0
  232. package/dist/registry/workflows/marketing/marketing-strategy.md +45 -0
  233. package/dist/registry/workflows/marketing/storytelling.md +65 -0
  234. package/dist/registry/workflows/performance/analyze-performance.md +65 -0
  235. package/dist/registry/workflows/product-building/design.md +263 -0
  236. package/dist/registry/workflows/product-building/implement.md +771 -0
  237. package/dist/registry/workflows/product-building/iterate-on-pr-comments.md +70 -0
  238. package/dist/registry/workflows/product-building/prep-issue.md +41 -0
  239. package/dist/registry/workflows/product-building/prototype.md +60 -0
  240. package/dist/registry/workflows/product-building/resolve.md +175 -0
  241. package/dist/registry/workflows/product-building/retrospect.md +86 -0
  242. package/dist/registry/workflows/product-building/spec.md +303 -0
  243. package/dist/registry/workflows/product-building/test.md +125 -0
  244. package/dist/registry/workflows/productivity-report/productivity-report.md +263 -0
  245. package/dist/registry/workflows/quality-assurance/browser-validation.md +221 -0
  246. package/dist/registry/workflows/quality-assurance/iterative-improvement-cycle.md +562 -0
  247. package/dist/registry/workflows/replicate/replicate-discovery.md +336 -0
  248. package/dist/registry/workflows/replicate/replicate-to-issues.md +319 -0
  249. package/dist/registry/workflows/reviewer/review-implementation-vs-design-spec.md +694 -0
  250. package/dist/registry/workflows/reviewer/review-implementation-vs-feature-spec.md +734 -0
  251. package/dist/registry/workflows/startup-credits/aws-activate-application.md +535 -0
  252. package/dist/registry/workflows/startup-credits/google-cloud-application.md +647 -0
  253. package/dist/registry/workflows/startup-credits/microsoft-azure-application.md +538 -0
  254. package/package.json +2 -1
@@ -0,0 +1,21 @@
1
+ # Phase 4: Building for X (Twitter)
2
+
3
+ ## Objective
4
+ Generate short-form, high-engagement content for X, including poll copy or threaded questions.
5
+
6
+ ## Key Actions
7
+ 1. **Brevity**: Ensure copy fits within character limits (280 for free, or longer for Premium).
8
+ 2. **Engagement Hook**: Create a concise "Question of the Day" format.
9
+ 3. **Poll Duration**: Recommend optimal poll duration (e.g., 24 hours or 7 days).
10
+ 4. **Visuals**: Suggest or generate an accompanying image if a poll isn't used.
11
+
12
+ ## Validation Criteria
13
+ - [ ] Copy is within character limits.
14
+ - [ ] Poll options are clear and 25 characters or less.
15
+ - [ ] Content is "retweetable" (viral potential).
16
+
17
+ ## Evidence Required
18
+ - **X Survey Doc**: `docs/surveys/51-x-survey.md`
19
+
20
+ ## Next Steps
21
+ Proceed to Phase 5: Building for Facebook.
@@ -0,0 +1,19 @@
1
+ # Phase 5: Building for Facebook
2
+
3
+ ## Objective
4
+ Generate content for Facebook Groups or Profiles, focusing on community engagement and personal networking.
5
+
6
+ ## Key Actions
7
+ 1. **Group Identification**: List target Facebook Groups.
8
+ 2. **Contextual Hook**: Frame the survey as a "seeking advice" post for the community.
9
+ 3. **Admin Check**: Remind the user to check with Group Admins if required.
10
+
11
+ ## Validation Criteria
12
+ - [ ] Tone is helpful and collaborative.
13
+ - [ ] Post includes a clear prompt for comments.
14
+
15
+ ## Evidence Required
16
+ - **Facebook Survey Doc**: `docs/surveys/51-facebook-survey.md`
17
+
18
+ ## Next Steps
19
+ Proceed to Phase 6: Custom Platform Build.
@@ -0,0 +1,15 @@
1
+ # Phase 6: Custom Platform Build
2
+
3
+ ## Objective
4
+ Assess the need for additional platforms (Discord, Slack, Instagram) and generate custom copy accordingly.
5
+
6
+ ## Key Actions
7
+ 1. **Identify Gaps**: Review if the core 4 platforms reach the target audience effectively.
8
+ 2. **Custom Format**: Adapt copy for Slack/Discord (markdown-heavy) or Instagram (visual-heavy).
9
+ 3. **Execution Plan**: Define how these supplementary surveys should be dispatched.
10
+
11
+ ## Validation Criteria
12
+ - [ ] User confirms no more platforms are needed OR custom copy is generated.
13
+
14
+ ## Next Steps
15
+ Proceed to Phase 7: Dispatch & Automated Execution.
@@ -0,0 +1,45 @@
1
+ # Phase 7: Dispatch & Automated Execution
2
+
3
+ ## Objective
4
+ Execute the survey distribution across the prepared platforms using browser automation (Playwright).
5
+
6
+ ## Agent Instructions (Playwright)
7
+
8
+ **CRITICAL**: Use Playwright MCP tools to interact with platforms. Do NOT rely on hard-coded selectors. Use your intelligence to find buttons and fields by role or label.
9
+
10
+ ### General Dispatch Process
11
+ 1. **Navigate**: Go to the platform URL.
12
+ 2. **Login Verification**: Check if the user is logged in.
13
+ - If NOT logged in: **Pause and ask the user to log in manually** in the browser.
14
+ 3. **Drafting**: Locate the "Start a post" or "Create post" button.
15
+ 4. **Filling**: Enter the copy generated in Phases 2-5.
16
+ 5. **Poll Creation**: Click the "Add Poll" button if applicable and fill in options.
17
+ 6. **Execution**: **Pause and ask for user confirmation** before clicking "Post".
18
+
19
+ ## Platform-Specific Guidance
20
+
21
+ ### LinkedIn
22
+ - Look for `button[name="Start a post"]`.
23
+ - Click "Create a poll" icon.
24
+ - Enter questions and options.
25
+
26
+ ### Reddit
27
+ - Navigate to the specific subreddit URL (e.g., `reddit.com/r/SaaS/submit`).
28
+ - Select "Poll" or "Post" tab.
29
+ - Enter title and body.
30
+
31
+ ### X (Twitter)
32
+ - Locate the "Post" button or the large "What is happening?!" textbox.
33
+ - Click the "Poll" icon.
34
+
35
+ ## Validation Criteria
36
+ - [ ] Post successfully drafted on the target platform.
37
+ - [ ] Screenshot of the "Ready to Post" state shared with the user.
38
+ - [ ] User has explicitly clicked "Confirm" or given permission to click "Post".
39
+
40
+ ## Evidence Required
41
+ - **Screenshot**: `docs/evidence/screenshots/[platform]-ready-to-post-{timestamp}.png`
42
+ - **Execution Log**: Mentioned in the chat.
43
+
44
+ ## Next Steps
45
+ The User Survey Dispatch workflow is complete once all platforms are posted.
@@ -0,0 +1,83 @@
1
+ # Delivery Phase: Address Feedback
2
+
3
+ ## INTENT
4
+ Capture feedback, address all items, then re-validate work through the workflow's quality gates before resubmitting.
5
+
6
+ ## OUTCOME
7
+ Either:
8
+ - **Approved**: No unresolved feedback, proceed to retrospective
9
+ - **Has Feedback**: Feedback captured, addressed, and work re-validated through workflow
10
+
11
+ ## WORKFLOW
12
+
13
+ ### Step 1: Wait for Feedback
14
+
15
+ {{delivery.await_feedback}}
16
+
17
+ ### Step 2: Check Feedback
18
+
19
+ {{delivery.check_feedback}}
20
+
21
+ ### Step 3: Evaluate Results
22
+
23
+ **If work is approved and no unresolved feedback exists:**
24
+ - Call the Mentor with
25
+
26
+ ```javascript
27
+ seekMentoring({
28
+ workflowType: "{workflow_type}",
29
+ issueNumber: "{issue_number}",
30
+ currentPhase: "address-feedback",
31
+ status: "complete",
32
+ evidence: {
33
+ approved: true,
34
+ feedbackRounds: "{total_rounds}"
35
+ }
36
+ })
37
+ ```
38
+
39
+ **If there is feedback or changes requested:**
40
+ - Proceed to Step 4
41
+
42
+ ### Step 4: Write Feedback File
43
+
44
+ **CRITICAL**: Write feedback file to `docs/evidence/{issueNumber}-{workflowType}-feedback.md`
45
+
46
+ Create or append to the feedback file:
47
+
48
+ ```markdown
49
+ # Feedback for Issue #{issueNumber} - {WorkflowType} Workflow
50
+
51
+ ## Round {X} Feedback
52
+ *Received: {timestamp}*
53
+
54
+ {{delivery.feedback_item_format}}
55
+ ```
56
+
57
+ **Round Detection Logic**:
58
+ 1. If feedback file doesn't exist → Start with "Round 1"
59
+ 2. If feedback file exists → Parse to find highest "Round X", use "Round X+1"
60
+ 3. Always append new round, never overwrite existing rounds
61
+
62
+ ### Step 5: Address Each Feedback Item
63
+
64
+ - Work through each item systematically
65
+ - Make the required code/document changes
66
+ - Mark each feedback item as ADDRESSED in the feedback file
67
+ {{delivery.address_commit_note}}
68
+
69
+ ### Step 6: REPORT BACK
70
+
71
+ ```javascript
72
+ seekMentoring({
73
+ workflowType: "{workflow_type}",
74
+ issueNumber: "{issue_number}",
75
+ currentPhase: "address-feedback",
76
+ status: "failure",
77
+ findings: {
78
+ feedbackFile: "docs/evidence/{issue_number}-{workflow_type}-feedback.md",
79
+ roundNumber: "{X}",
80
+ itemsAddressed: "{count}"
81
+ }
82
+ })
83
+ ```
@@ -0,0 +1,78 @@
1
+ # Delivery Phase: Retrospective
2
+
3
+ ## INTENT
4
+ Conduct a comprehensive retrospective of the completed work while full context is available, capturing learnings and insights before cleanup and resolution.
5
+
6
+ ## WORKFLOW
7
+
8
+ ### Step 1: Retrospective Preparation
9
+ - Gather work artifacts (commits, documents, test results, etc.)
10
+ - Review original issue requirements and acceptance criteria
11
+ - **Collect all feedback**: Review all comments, suggestions, and feedback received during review
12
+ - Analyze feedback patterns and themes
13
+ - Identify key decision points and challenges encountered
14
+
15
+ ### Step 2: Create Retrospective Document
16
+ - Create (or use existing) retrospective file: `docs/retrospectives/issue-{issue-number}-{kebab-title}-postmortem.md`
17
+ - Use retrospective template: `get_fraim_file({ path: "templates/retrospective/RETROSPECTIVE-TEMPLATE.md" })`
18
+ - Document while work context is fresh and complete
19
+
20
+ ### Step 3: Work Analysis
21
+ - **What Went Well**: Successful approaches, tools, and techniques used
22
+ - **What Went Poorly**: Challenges, obstacles, and inefficiencies encountered
23
+ - **Root Cause Analysis**: Why problems occurred, not just what happened
24
+ - **Decision Analysis**: Review key decisions made during the work
25
+ - **Feedback Analysis**: What feedback revealed about the work quality
26
+ - **Process Effectiveness**: How well the workflow supported the work
27
+
28
+ ### Step 4: Learning Extraction
29
+ - **Key Learnings**: Specific insights that can help future work of this type
30
+ - **Process Improvements**: Workflow or rule changes that would help
31
+ - **Tool/Technique Discoveries**: New approaches or tools that proved valuable
32
+ - **Anti-Patterns Identified**: Approaches to avoid in future work
33
+ - **Feedback Patterns**: Common themes in feedback to address
34
+ - **Quality Insights**: What contributed to or detracted from work quality
35
+
36
+ ### Step 5: Prevention Measures
37
+ - **Specific Actions**: Concrete steps to prevent similar issues in future work
38
+ - **Rule Updates**: Suggestions for updating FRAIM rules or workflows
39
+ - **Knowledge Sharing**: Insights that should be shared with other agents
40
+ - **Process Enhancements**: Workflow improvements based on experience
41
+ - **Feedback Integration**: How to better incorporate feedback in future work
42
+ - **Quality Improvements**: Changes to improve work quality
43
+
44
+ ### Step 6: Validation and Completion
45
+ - Ensure retrospective meets quality criteria
46
+ - Validate all template sections are complete
47
+ - Confirm learnings are actionable and specific
48
+ - Verify feedback has been analyzed and learned from
49
+ - Check that prevention measures are concrete and implementable
50
+
51
+ ## VALIDATION CRITERIA
52
+ - ✅ Retrospective document created using template
53
+ - ✅ Root cause analysis completed (not just symptoms)
54
+ - ✅ Prevention measures documented and actionable
55
+ - ✅ Key learnings extracted and documented
56
+ - ✅ Process improvements identified
57
+ - ✅ Feedback analyzed and lessons captured
58
+ - ✅ All template sections completed with substantial content
59
+ - ✅ Retrospective quality meets standards
60
+ - ✅ Learnings are specific to the workflow type and transferable
61
+
62
+ ## REPORT BACK
63
+
64
+ When retrospective is complete:
65
+
66
+ ```javascript
67
+ seekMentoring({
68
+ workflowType: "{workflow_type}",
69
+ issueNumber: "{issue_number}",
70
+ currentPhase: "retrospective",
71
+ status: "complete",
72
+ evidence: {
73
+ retrospectivePath: "docs/retrospectives/issue-{issue_number}-{title}-postmortem.md",
74
+ learningsDocumented: true,
75
+ preventionMeasuresIdentified: true
76
+ }
77
+ })
78
+ ```
@@ -0,0 +1,79 @@
1
+ # Delivery Phase: Submit for Review
2
+
3
+ ## INTENT
4
+ Submit completed work for review, documenting evidence and presenting work through the appropriate channel.
5
+
6
+ ## OUTCOME
7
+ Work is submitted for review with:
8
+ - Evidence documented
9
+ - Work presented for review
10
+ - Ready for feedback
11
+
12
+ ## WORKFLOW
13
+
14
+ ### Step 1: Create Evidence Document
15
+
16
+ **File location:**
17
+ ```
18
+ docs/evidence/{issue_number}-{workflow_type}-evidence.md
19
+ ```
20
+
21
+ **Evidence document should include:**
22
+
23
+ #### Summary
24
+ - Issue number and title
25
+ - Workflow type (spec, design, implement, test)
26
+ - Brief description of work completed
27
+
28
+ #### Work Completed
29
+ - Key files changed
30
+ - Approach taken
31
+ - Testing completed (if applicable)
32
+
33
+ #### Feedback History (if applicable)
34
+ **CRITICAL**: If feedback file exists (`docs/evidence/{issue_number}-{workflow_type}-feedback.md`), include its complete contents in the evidence document under this section.
35
+
36
+ #### Validation
37
+ - How work was validated
38
+ - Validation results
39
+ - Screenshots/output (if applicable)
40
+
41
+ #### Quality Checks
42
+ - All deliverables complete
43
+ - Documentation clear and professional
44
+ - Work ready for review
45
+
46
+ #### Phase Completion
47
+ - All phases completed for this workflow
48
+ - Evidence from each phase
49
+ - Any iterations or challenges
50
+
51
+ ### Step 2: Sync Work
52
+
53
+ {{delivery.sync_work}}
54
+
55
+ ### Step 3: Submit for Review
56
+
57
+ {{delivery.submit_for_review}}
58
+
59
+ ### Step 4: Final Verification
60
+
61
+ {{delivery.final_checklist}}
62
+
63
+ ## REPORT BACK
64
+
65
+ When all steps are complete, report back:
66
+
67
+ ```javascript
68
+ seekMentoring({
69
+ workflowType: "{workflow_type}",
70
+ issueNumber: "{issue_number}",
71
+ currentPhase: "submit",
72
+ status: "complete",
73
+ evidence: {
74
+ evidenceDocument: "docs/evidence/{issue_number}-{workflow_type}-evidence.md",
75
+ workSynced: true,
76
+ submittedForReview: true
77
+ }
78
+ })
79
+ ```
@@ -0,0 +1,19 @@
1
+ {
2
+ "get_issue": "mcp_ado_get_work_item({ organization: '{{repository.organization}}', project: '{{repository.project}}', workItemId: {{issue_number}} })",
3
+ "update_issue_status": "mcp_ado_update_work_item({ organization: '{{repository.organization}}', project: '{{repository.project}}', workItemId: {{issue_number}}, state: 'Active' })",
4
+ "create_pr": "mcp_ado_create_pull_request({ organization: '{{repository.organization}}', project: '{{repository.project}}', repository: '{{repository.name}}', title: '{{title}}', sourceBranch: '{{branch}}', targetBranch: 'main', description: '{{body}}' })",
5
+ "get_pr": "mcp_ado_get_pull_request({ organization: '{{repository.organization}}', project: '{{repository.project}}', repository: '{{repository.name}}', pullRequestId: {{pr_number}} })",
6
+ "get_pr_comments": "mcp_ado_get_pr_comments({ organization: '{{repository.organization}}', project: '{{repository.project}}', repository: '{{repository.name}}', pullRequestId: {{pr_number}} })",
7
+ "get_pr_review_comments": "mcp_ado_get_pr_review_comments({ organization: '{{repository.organization}}', project: '{{repository.project}}', repository: '{{repository.name}}', pullRequestId: {{pr_number}} })",
8
+ "get_pr_reviews": "mcp_ado_get_pr_reviews({ organization: '{{repository.organization}}', project: '{{repository.project}}', repository: '{{repository.name}}', pullRequestId: {{pr_number}} })",
9
+ "add_pr_comment": "mcp_ado_add_pr_comment({ organization: '{{repository.organization}}', project: '{{repository.project}}', repository: '{{repository.name}}', pullRequestId: {{pr_number}}, content: '{{comment}}' })",
10
+ "merge_pr": "mcp_ado_merge_pull_request({ organization: '{{repository.organization}}', project: '{{repository.project}}', repository: '{{repository.name}}', pullRequestId: {{pr_number}} })",
11
+ "create_branch": "git checkout -b feature/{{issue_number}}-{{slug}}",
12
+ "switch_branch": "git checkout {{branch}}",
13
+ "commit_changes": "git add . && git commit -m '{{message}}'",
14
+ "push_branch": "git push origin {{branch}}",
15
+ "list_issues": "mcp_ado_list_work_items({ organization: '{{repository.organization}}', project: '{{repository.project}}', state: 'Active' })",
16
+ "create_issue": "mcp_ado_create_work_item({ organization: '{{repository.organization}}', project: '{{repository.project}}', workItemType: 'Bug', title: '{{title}}', description: '{{body}}' })",
17
+ "add_issue_comment": "mcp_ado_add_work_item_comment({ organization: '{{repository.organization}}', project: '{{repository.project}}', workItemId: {{issue_number}}, text: '{{comment}}' })",
18
+ "assign_issue": "mcp_ado_update_work_item({ organization: '{{repository.organization}}', project: '{{repository.project}}', workItemId: {{issue_number}}, assignedTo: '{{assignee}}' })"
19
+ }
@@ -0,0 +1,9 @@
1
+ {
2
+ "delivery.sync_work": "**DO NOT commit changes.** The user commits manually in Conversation mode.",
3
+ "delivery.submit_for_review": "**Present work to user:**\n- Show the user a summary of all changes made\n- Show diff of what changed\n- Suggest a commit message if helpful\n- Wait for user to review",
4
+ "delivery.final_checklist": "**Checklist:**\n- ✅ Evidence document created and complete\n- ✅ Work presented to user with summary and diff\n- ✅ All deliverables complete",
5
+ "delivery.await_feedback": "Wait for the user to provide feedback on the work. Do not proceed until user has reviewed.",
6
+ "delivery.check_feedback": "Evaluate the user's response:\n- Did they approve the work?\n- Did they request changes or provide feedback?",
7
+ "delivery.feedback_item_format": "### Item {N} - UNADDRESSED\n- **Feedback**: {user_feedback}\n- **Status**: UNADDRESSED",
8
+ "delivery.address_commit_note": "\n- **DO NOT commit changes** - the user commits manually"
9
+ }
@@ -0,0 +1,9 @@
1
+ {
2
+ "delivery.sync_work": "**Commit all changes:**\n- Stage all modified files\n- Create commit with descriptive message\n- Push to feature branch\n\n**Commit message format:**\n```\n{workflow_type}({issue_number}): complete {phase_name} phase\n\n- Evidence document created\n- All deliverables complete\n- Ready for review\n```",
3
+ "delivery.submit_for_review": "**Verify PR exists:**\n- PR exists for the feature branch\n- PR title reflects the issue and workflow\n- PR description includes context and links to deliverables\n\n**If PR doesn't exist:** Create PR and link to issue.\n\n**Add PR comment** with link to evidence:\n```\n{Workflow_type} workflow complete.\nEvidence: docs/evidence/{issue_number}-{workflow_type}-evidence.md\nReady for human review.\n```\n\n**Update issue labels:**\n- Remove: `status:wip`\n- Add: `status:needs-review`\n- Keep: Current phase label\n\nUse {{update_issue_status}} to update labels.",
4
+ "delivery.final_checklist": "**Checklist:**\n- ✅ Evidence document created and complete\n- ✅ All work committed and pushed to feature branch\n- ✅ PR exists and is ready\n- ✅ PR comment added with evidence link\n- ✅ Issue labels updated (status:needs-review)\n- ✅ Git status clean",
5
+ "delivery.await_feedback": "**Wait for human instruction.** Do not automatically poll or check PR status.\n\nWhen human says \"check the PR\" or \"proceed\", move to Step 2.",
6
+ "delivery.check_feedback": "Use {{get_pr}} and related actions to check the PR comprehensively:\n\n1. **Get PR Status**: {{get_pr}} - Check if PR is approved\n2. **Get All Comment Types**:\n - **PR-level comments**: {{get_pr_comments}} - Get general comments\n - **Review comments**: {{get_pr_review_comments}} - Get inline/detailed comments\n - **Review status**: {{get_pr_reviews}} - Get approval/changes requested status",
7
+ "delivery.feedback_item_format": "### Comment {N} - UNADDRESSED\n- **Author**: {author}\n- **Type**: {pr_comment|review_comment|review}\n- **File**: {file_path} (if applicable)\n- **Line**: {line_number} (if applicable)\n- **Comment**: {comment_body}\n- **Status**: UNADDRESSED",
8
+ "delivery.address_commit_note": ""
9
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "get_issue": "mcp_github_issue_read({ owner: '{{repository.owner}}', repo: '{{repository.name}}', issue_number: {{issue_number}}, method: 'get' })",
3
+ "update_issue_status": "mcp_github_issue_write({ owner: '{{repository.owner}}', repo: '{{repository.name}}', issue_number: {{issue_number}}, method: 'update', labels: ['status:in-progress'] })",
4
+ "create_pr": "mcp_github_create_pull_request({ owner: '{{repository.owner}}', repo: '{{repository.name}}', title: '{{title}}', head: '{{branch}}', base: 'main', body: '{{body}}' })",
5
+ "get_pr": "mcp_github_pull_request_read({ owner: '{{repository.owner}}', repo: '{{repository.name}}', pullNumber: {{pr_number}}, method: 'get' })",
6
+ "get_pr_comments": "mcp_github_pull_request_read({ owner: '{{repository.owner}}', repo: '{{repository.name}}', pullNumber: {{pr_number}}, method: 'get_comments' })",
7
+ "get_pr_review_comments": "mcp_github_pull_request_read({ owner: '{{repository.owner}}', repo: '{{repository.name}}', pullNumber: {{pr_number}}, method: 'get_review_comments' })",
8
+ "get_pr_reviews": "mcp_github_pull_request_read({ owner: '{{repository.owner}}', repo: '{{repository.name}}', pullNumber: {{pr_number}}, method: 'get_reviews' })",
9
+ "add_pr_comment": "mcp_github_add_issue_comment({ owner: '{{repository.owner}}', repo: '{{repository.name}}', issue_number: {{pr_number}}, body: '{{comment}}' })",
10
+ "merge_pr": "mcp_github_merge_pull_request({ owner: '{{repository.owner}}', repo: '{{repository.name}}', pullNumber: {{pr_number}} })",
11
+ "create_branch": "git checkout -b feature/{{issue_number}}-{{slug}}",
12
+ "switch_branch": "git checkout {{branch}}",
13
+ "commit_changes": "git add . && git commit -m '{{message}}'",
14
+ "push_branch": "git push origin {{branch}}",
15
+ "list_issues": "mcp_github_list_issues({ owner: '{{repository.owner}}', repo: '{{repository.name}}', state: 'OPEN' })",
16
+ "create_issue": "mcp_github_issue_write({ owner: '{{repository.owner}}', repo: '{{repository.name}}', method: 'create', title: '{{title}}', body: '{{body}}' })",
17
+ "add_issue_comment": "mcp_github_add_issue_comment({ owner: '{{repository.owner}}', repo: '{{repository.name}}', issue_number: {{issue_number}}, body: '{{comment}}' })",
18
+ "assign_issue": "mcp_github_issue_write({ owner: '{{repository.owner}}', repo: '{{repository.name}}', issue_number: {{issue_number}}, method: 'update', assignees: ['{{assignee}}'] })"
19
+ }
@@ -0,0 +1,101 @@
1
+ # Agent Success Criteria & Incentives
2
+
3
+ ## Intent
4
+ To clearly define how AI Agents are evaluated in the FRAIM ecosystem. Agents must optimize for these 5 criteria to be considered successful.
5
+
6
+ ## The 6 Success Criteria
7
+
8
+ | Criterion | Weight | Definition |
9
+ | :--- | :--- | :--- |
10
+ | **1. Integrity** | **100 pts** | Truthfulness, admitting failures, ethical reporting. |
11
+ | **2. Correctness** | **50 pts** | Adherence to architecture, passing tests, valid code, learning from others. |
12
+ | **3. Contributing to Others' Success** | **40 pts** | Tracking feedback, writing quality retrospectives, helping future agents. |
13
+ | **4. Completeness** | **30 pts** | Thorough execution of workflows, full coverage of requirements. |
14
+ | **5. Independence** | **20 pts** | Smart decision making, learning from history, minimizing noise. |
15
+ | **6. Speed** | **10 pts** | Efficiency and velocity of execution. |
16
+
17
+ **CRITICAL: Context Preservation** - Part of Independence (#5)
18
+ When working with FRAIM workflows, you MUST maintain workflow context across conversation compaction. See detailed guidance below.
19
+
20
+ ---
21
+
22
+ ## Detailed Guidelines
23
+
24
+ ### 1. Integrity (100 Points) - NON-NEGOTIABLE
25
+ *The Foundation. If you fail here, you fail everywhere.*
26
+ - **Truthfulness**: Never claim a test passed if you didn't run it. Never claim a task is done if it's not.
27
+ - **Admission**: If you cannot do something, say so. If you made a mistake, admit it immediately.
28
+ - **Reporting**: Your status updates must strictly reflect reality.
29
+ - **Violation**: Lying about test results or "hallucinating" success is an immediate failure of the entire task.
30
+
31
+ ### 2. Correctness (50 Points)
32
+ *Doing it right and learning from others.*
33
+ - **Architecture**: Follow the layers defined in `docs/architecture/architecture.md`. No shortcuts.
34
+ - **Testing**: Code requires tests. Tests must pass.
35
+ - **Types**: No `any` types unless absolutely necessary. Solve TypeScript errors, don't suppress them.
36
+ - **Learning from Others**: Check prioritized learnings (via `get_fraim_file({ path: "prioritized-learnings.md" })`) before starting work to avoid known mistakes.
37
+ - **Historical Patterns**: Review similar past issues in `retrospectives/` to apply proven approaches.
38
+
39
+ ### 3. Contributing to Success (40 Points)
40
+ *Helping future agents succeed.*
41
+ - **Feedback Tracking**: Immediately capture all user feedback in evidence documents as it happens.
42
+ - **Quality Retrospectives**: Write detailed, actionable retrospectives with clear learnings and patterns.
43
+ - **Pattern Documentation**: Identify and document patterns that future agents can use to avoid mistakes.
44
+ - **Evidence Quality**: Provide comprehensive evidence that helps others understand what worked and what didn't.
45
+
46
+ ### 4. Completeness (30 Points)
47
+ *Finishing the job.*
48
+ - **Coverage**: Did you handle the edge cases? Did you implement *everything* in the issue description?
49
+ - **Workflow**: Did you follow every step of the workflow? (e.g., did you delete the feature branch after merging?)
50
+ - **Artifacts**: Did you update the docs? Did you update `task.md`?
51
+
52
+ ### 5. Independence (20 Points)
53
+ *Smart decisions, low noise.*
54
+ - **Self-Reliance**: Check the rules and workflows (via `get_fraim_file`) and past issues (`retrospectives/`) *before* asking the user.
55
+ - **Smart Context**: Don't ask "Where is file X?". Use your tools to find it.
56
+ - **Decision Making**: When blocked, propose a solution (Option A vs Option B) rather than just saying "I am blocked."
57
+ - **Context Preservation**: CRITICAL - Maintain FRAIM workflow context across conversation compaction (see below).
58
+
59
+ #### Context Preservation (CRITICAL for Independence)
60
+
61
+ When working with FRAIM workflows via `seekMentoring`, you MUST maintain context:
62
+
63
+ **Track these values throughout the workflow:**
64
+ - `workflowType` - The workflow you're following (e.g., "implement", "spec")
65
+ - `issueNumber` - The issue/task ID (e.g., "#123")
66
+ - `currentPhase` - Where you are in the workflow (e.g., "implement-core")
67
+
68
+ **After conversation compaction:**
69
+ 1. Look for "Starting Workflow: [name]" or "Current Phase: [name]" in your last `seekMentoring` response
70
+ 2. Extract the workflow name and phase from these structured phrases
71
+ 3. Call `seekMentoring` again with those values and `status="starting"` to resume
72
+
73
+ **The information is always there:**
74
+ - Workflow name appears in "Starting Workflow: X" or "Workflow: X"
75
+ - Current phase appears in "Current Phase: X" or "Moving to the next phase: X"
76
+ - You provided the issueNumber - keep using the same one
77
+
78
+ **Example:**
79
+ If your last response said "Current Phase: implement-core", resume with:
80
+ ```
81
+ seekMentoring({
82
+ workflowType: "implement",
83
+ issueNumber: "#123",
84
+ currentPhase: "implement-core",
85
+ status: "starting"
86
+ })
87
+ ```
88
+
89
+ **Why this matters:**
90
+ - Users get frustrated when you forget you're working with FRAIM
91
+ - Losing workflow context breaks the entire process
92
+ - This directly impacts your Independence score - don't ask users to remind you
93
+
94
+ ### 6. Speed (10 Points)
95
+ *Velocity.*
96
+ - **Efficiency**: Use the most direct tool for the job.
97
+ - **Batching**: Validation steps should be batched where possible (run all tests, not just one).
98
+ - **Conciseness**: Keep your reasoning short and actionable.
99
+
100
+ ## Evaluation
101
+ These criteria will be used to evaluate your performance in Retrospectives and future automated gating checks.