fraim-framework 2.0.67 → 2.0.69

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 (280) hide show
  1. package/bin/fraim.js +1 -1
  2. package/dist/src/cli/commands/doctor.js +1 -1
  3. package/dist/src/cli/commands/init-project.js +6 -12
  4. package/dist/src/cli/commands/list.js +1 -1
  5. package/dist/src/cli/commands/setup.js +15 -29
  6. package/dist/src/cli/commands/sync.js +36 -143
  7. package/dist/src/cli/fraim.js +0 -4
  8. package/dist/src/cli/setup/first-run.js +4 -4
  9. package/dist/src/cli/setup/ide-detector.js +15 -5
  10. package/dist/src/fraim/template-processor.js +7 -35
  11. package/dist/src/local-mcp-server/stdio-server.js +170 -181
  12. package/dist/src/utils/git-utils.js +2 -2
  13. package/dist/src/utils/object-utils.js +11 -0
  14. package/dist/src/utils/provider-utils.js +14 -0
  15. package/dist/src/utils/request-utils.js +23 -0
  16. package/dist/src/utils/workflow-parser.js +7 -7
  17. package/package.json +7 -5
  18. package/dist/registry/ai-manager-rules/customer-development-phases/phase1-customer-profiling.md +0 -101
  19. package/dist/registry/ai-manager-rules/customer-development-phases/phase2-platform-discovery.md +0 -235
  20. package/dist/registry/ai-manager-rules/customer-development-phases/phase3-prospect-qualification.md +0 -243
  21. package/dist/registry/ai-manager-rules/customer-development-phases/phase4-inventory-compilation.md +0 -206
  22. package/dist/registry/ai-manager-rules/design-phases/design-completeness-review.md +0 -73
  23. package/dist/registry/ai-manager-rules/design-phases/design-design.md +0 -145
  24. package/dist/registry/ai-manager-rules/design-phases/design.md +0 -108
  25. package/dist/registry/ai-manager-rules/design-phases/finalize.md +0 -60
  26. package/dist/registry/ai-manager-rules/design-phases/validate.md +0 -125
  27. package/dist/registry/ai-manager-rules/design.json +0 -97
  28. package/dist/registry/ai-manager-rules/implement-phases/code.md +0 -323
  29. package/dist/registry/ai-manager-rules/implement-phases/completeness-review.md +0 -94
  30. package/dist/registry/ai-manager-rules/implement-phases/finalize.md +0 -177
  31. package/dist/registry/ai-manager-rules/implement-phases/implement-code.md +0 -283
  32. package/dist/registry/ai-manager-rules/implement-phases/implement-completeness-review.md +0 -120
  33. package/dist/registry/ai-manager-rules/implement-phases/implement-regression.md +0 -173
  34. package/dist/registry/ai-manager-rules/implement-phases/implement-repro.md +0 -104
  35. package/dist/registry/ai-manager-rules/implement-phases/implement-scoping.md +0 -100
  36. package/dist/registry/ai-manager-rules/implement-phases/implement-smoke.md +0 -237
  37. package/dist/registry/ai-manager-rules/implement-phases/implement-spike.md +0 -121
  38. package/dist/registry/ai-manager-rules/implement-phases/implement-validate.md +0 -375
  39. package/dist/registry/ai-manager-rules/implement-phases/quality-review.md +0 -304
  40. package/dist/registry/ai-manager-rules/implement-phases/regression.md +0 -159
  41. package/dist/registry/ai-manager-rules/implement-phases/repro.md +0 -101
  42. package/dist/registry/ai-manager-rules/implement-phases/scoping.md +0 -93
  43. package/dist/registry/ai-manager-rules/implement-phases/smoke.md +0 -225
  44. package/dist/registry/ai-manager-rules/implement-phases/spike.md +0 -118
  45. package/dist/registry/ai-manager-rules/implement-phases/validate.md +0 -347
  46. package/dist/registry/ai-manager-rules/implement.json +0 -153
  47. package/dist/registry/ai-manager-rules/retrospective.md +0 -116
  48. package/dist/registry/ai-manager-rules/shared-phases/address-pr-feedback.md +0 -188
  49. package/dist/registry/ai-manager-rules/shared-phases/finalize.md +0 -169
  50. package/dist/registry/ai-manager-rules/shared-phases/submit-pr.md +0 -202
  51. package/dist/registry/ai-manager-rules/shared-phases/wait-for-pr-review.md +0 -170
  52. package/dist/registry/ai-manager-rules/spec-phases/finalize.md +0 -60
  53. package/dist/registry/ai-manager-rules/spec-phases/spec-competitor-analysis.md +0 -105
  54. package/dist/registry/ai-manager-rules/spec-phases/spec-completeness-review.md +0 -66
  55. package/dist/registry/ai-manager-rules/spec-phases/spec-spec.md +0 -139
  56. package/dist/registry/ai-manager-rules/spec-phases/spec.md +0 -102
  57. package/dist/registry/ai-manager-rules/spec-phases/validate.md +0 -118
  58. package/dist/registry/ai-manager-rules/spec.json +0 -112
  59. package/dist/registry/ai-manager-rules/test.json +0 -98
  60. package/dist/registry/ai-manager-rules/user-survey-phases/phase1-survey-scoping.md +0 -60
  61. package/dist/registry/ai-manager-rules/user-survey-phases/phase2-survey-build-linkedin.md +0 -23
  62. package/dist/registry/ai-manager-rules/user-survey-phases/phase3-survey-build-reddit.md +0 -22
  63. package/dist/registry/ai-manager-rules/user-survey-phases/phase4-survey-build-x.md +0 -21
  64. package/dist/registry/ai-manager-rules/user-survey-phases/phase5-survey-build-facebook.md +0 -19
  65. package/dist/registry/ai-manager-rules/user-survey-phases/phase6-survey-build-custom.md +0 -15
  66. package/dist/registry/ai-manager-rules/user-survey-phases/phase7-survey-dispatch.md +0 -45
  67. package/dist/registry/delivery/address-feedback.md +0 -83
  68. package/dist/registry/delivery/retrospective.md +0 -78
  69. package/dist/registry/delivery/submit.md +0 -79
  70. package/dist/registry/providers/ado.json +0 -19
  71. package/dist/registry/providers/delivery-conversation.json +0 -9
  72. package/dist/registry/providers/delivery-pr.json +0 -9
  73. package/dist/registry/providers/github.json +0 -19
  74. package/dist/registry/rules/agent-success-criteria.md +0 -101
  75. package/dist/registry/rules/agent-testing-guidelines.md +0 -502
  76. package/dist/registry/rules/architecture.md +0 -126
  77. package/dist/registry/rules/communication.md +0 -122
  78. package/dist/registry/rules/continuous-learning.md +0 -55
  79. package/dist/registry/rules/debugging-multitenancy-issues.md +0 -85
  80. package/dist/registry/rules/ephemeral-execution.md +0 -54
  81. package/dist/registry/rules/git-safe-commands.md +0 -34
  82. package/dist/registry/rules/hitl-ppe-record-analysis.md +0 -302
  83. package/dist/registry/rules/integrity-and-test-ethics.md +0 -275
  84. package/dist/registry/rules/local-development.md +0 -275
  85. package/dist/registry/rules/mandatory-pre-completion-reflection.md +0 -193
  86. package/dist/registry/rules/merge-requirements.md +0 -238
  87. package/dist/registry/rules/simplicity.md +0 -118
  88. package/dist/registry/rules/software-development-lifecycle.md +0 -105
  89. package/dist/registry/rules/spike-first-development.md +0 -205
  90. package/dist/registry/rules/successful-debugging-patterns.md +0 -488
  91. package/dist/registry/scripts/build-scripts-generator.js +0 -205
  92. package/dist/registry/scripts/cleanup-branch.js +0 -287
  93. package/dist/registry/scripts/evaluate-code-quality.js +0 -66
  94. package/dist/registry/scripts/exec-with-timeout.js +0 -142
  95. package/dist/registry/scripts/fraim-config.js +0 -61
  96. package/dist/registry/scripts/generate-engagement-emails.js +0 -705
  97. package/dist/registry/scripts/generic-issues-api.js +0 -100
  98. package/dist/registry/scripts/newsletter-helpers.js +0 -671
  99. package/dist/registry/scripts/openapi-generator.js +0 -664
  100. package/dist/registry/scripts/performance/profile-server.js +0 -390
  101. package/dist/registry/scripts/profile-server.js +0 -389
  102. package/dist/registry/scripts/run-thank-you-workflow.js +0 -92
  103. package/dist/registry/scripts/send-newsletter-simple.js +0 -85
  104. package/dist/registry/scripts/send-thank-you-emails.js +0 -54
  105. package/dist/registry/scripts/validate-openapi-limits.js +0 -311
  106. package/dist/registry/scripts/validate-test-coverage.js +0 -262
  107. package/dist/registry/scripts/verify-test-coverage.js +0 -66
  108. package/dist/registry/stubs/workflows/azure/cost-optimization.md +0 -11
  109. package/dist/registry/stubs/workflows/bootstrap/create-architecture.md +0 -11
  110. package/dist/registry/stubs/workflows/bootstrap/detect-broken-windows.md +0 -11
  111. package/dist/registry/stubs/workflows/bootstrap/evaluate-code-quality.md +0 -11
  112. package/dist/registry/stubs/workflows/bootstrap/verify-test-coverage.md +0 -11
  113. package/dist/registry/stubs/workflows/brainstorming/blue-sky-brainstorming.md +0 -11
  114. package/dist/registry/stubs/workflows/brainstorming/codebase-brainstorming.md +0 -11
  115. package/dist/registry/stubs/workflows/business-development/create-business-plan.md +0 -11
  116. package/dist/registry/stubs/workflows/business-development/ideate-business-opportunity.md +0 -11
  117. package/dist/registry/stubs/workflows/business-development/price-product.md +0 -18
  118. package/dist/registry/stubs/workflows/compliance/detect-compliance-requirements.md +0 -11
  119. package/dist/registry/stubs/workflows/compliance/generate-audit-evidence.md +0 -11
  120. package/dist/registry/stubs/workflows/compliance/soc2-evidence-generator.md +0 -11
  121. package/dist/registry/stubs/workflows/customer-development/insight-analysis.md +0 -11
  122. package/dist/registry/stubs/workflows/customer-development/insight-triage.md +0 -11
  123. package/dist/registry/stubs/workflows/customer-development/interview-preparation.md +0 -11
  124. package/dist/registry/stubs/workflows/customer-development/linkedin-outreach.md +0 -11
  125. package/dist/registry/stubs/workflows/customer-development/strategic-brainstorming.md +0 -11
  126. package/dist/registry/stubs/workflows/customer-development/thank-customers.md +0 -11
  127. package/dist/registry/stubs/workflows/customer-development/user-survey-dispatch.md +0 -11
  128. package/dist/registry/stubs/workflows/customer-development/users-to-target.md +0 -11
  129. package/dist/registry/stubs/workflows/customer-development/weekly-newsletter.md +0 -11
  130. package/dist/registry/stubs/workflows/deploy/cloud-deployment.md +0 -11
  131. package/dist/registry/stubs/workflows/improve-fraim/contribute.md +0 -11
  132. package/dist/registry/stubs/workflows/improve-fraim/file-issue.md +0 -11
  133. package/dist/registry/stubs/workflows/learning/build-skillset.md +0 -11
  134. package/dist/registry/stubs/workflows/learning/synthesize-learnings.md +0 -11
  135. package/dist/registry/stubs/workflows/legal/contract-review-analysis.md +0 -11
  136. package/dist/registry/stubs/workflows/legal/nda.md +0 -11
  137. package/dist/registry/stubs/workflows/legal/patent-filing.md +0 -11
  138. package/dist/registry/stubs/workflows/legal/saas-contract-development.md +0 -11
  139. package/dist/registry/stubs/workflows/legal/trademark-filing.md +0 -11
  140. package/dist/registry/stubs/workflows/marketing/content-creation.md +0 -11
  141. package/dist/registry/stubs/workflows/marketing/convert-to-pdf.md +0 -11
  142. package/dist/registry/stubs/workflows/marketing/create-modern-website.md +0 -11
  143. package/dist/registry/stubs/workflows/marketing/domain-registration.md +0 -11
  144. package/dist/registry/stubs/workflows/marketing/evangelize.md +0 -11
  145. package/dist/registry/stubs/workflows/marketing/hbr-article.md +0 -11
  146. package/dist/registry/stubs/workflows/marketing/launch-checklist.md +0 -11
  147. package/dist/registry/stubs/workflows/marketing/marketing-strategy.md +0 -11
  148. package/dist/registry/stubs/workflows/marketing/storytelling.md +0 -11
  149. package/dist/registry/stubs/workflows/performance/analyze-performance.md +0 -11
  150. package/dist/registry/stubs/workflows/product-building/design.md +0 -11
  151. package/dist/registry/stubs/workflows/product-building/implement.md +0 -11
  152. package/dist/registry/stubs/workflows/product-building/iterate-on-pr-comments.md +0 -11
  153. package/dist/registry/stubs/workflows/product-building/prep-issue.md +0 -11
  154. package/dist/registry/stubs/workflows/product-building/prototype.md +0 -11
  155. package/dist/registry/stubs/workflows/product-building/resolve.md +0 -11
  156. package/dist/registry/stubs/workflows/product-building/retrospect.md +0 -11
  157. package/dist/registry/stubs/workflows/product-building/spec.md +0 -11
  158. package/dist/registry/stubs/workflows/product-building/test.md +0 -11
  159. package/dist/registry/stubs/workflows/productivity-report/productivity-report.md +0 -11
  160. package/dist/registry/stubs/workflows/quality-assurance/browser-validation.md +0 -11
  161. package/dist/registry/stubs/workflows/quality-assurance/iterative-improvement-cycle.md +0 -11
  162. package/dist/registry/stubs/workflows/replicate/replicate-discovery.md +0 -11
  163. package/dist/registry/stubs/workflows/replicate/replicate-to-issues.md +0 -11
  164. package/dist/registry/stubs/workflows/reviewer/review-implementation-vs-design-spec.md +0 -11
  165. package/dist/registry/stubs/workflows/reviewer/review-implementation-vs-feature-spec.md +0 -11
  166. package/dist/registry/stubs/workflows/startup-credits/aws-activate-application.md +0 -11
  167. package/dist/registry/stubs/workflows/startup-credits/google-cloud-application.md +0 -11
  168. package/dist/registry/stubs/workflows/startup-credits/microsoft-azure-application.md +0 -11
  169. package/dist/registry/templates/bootstrap/ARCHITECTURE-TEMPLATE.md +0 -53
  170. package/dist/registry/templates/bootstrap/CODE-QUALITY-REPORT-TEMPLATE.md +0 -37
  171. package/dist/registry/templates/bootstrap/TEST-COVERAGE-REPORT-TEMPLATE.md +0 -35
  172. package/dist/registry/templates/business-development/IDEATION-REPORT-TEMPLATE.md +0 -29
  173. package/dist/registry/templates/business-development/PRICING-STRATEGY-TEMPLATE.md +0 -126
  174. package/dist/registry/templates/customer-development/customer-interview-template.md +0 -99
  175. package/dist/registry/templates/customer-development/customer-persona-template.md +0 -69
  176. package/dist/registry/templates/customer-development/follow-up-email-templates.md +0 -132
  177. package/dist/registry/templates/customer-development/insight-analysis-template.md +0 -74
  178. package/dist/registry/templates/customer-development/prospect-inventory-template.csv +0 -3
  179. package/dist/registry/templates/customer-development/search-strategy-template.md +0 -123
  180. package/dist/registry/templates/customer-development/strategic-recommendations-template.md +0 -53
  181. package/dist/registry/templates/customer-development/thank-you-email-template.html +0 -124
  182. package/dist/registry/templates/customer-development/thank-you-note-template.md +0 -16
  183. package/dist/registry/templates/customer-development/triage-log-template.md +0 -278
  184. package/dist/registry/templates/customer-development/weekly-newsletter-template.html +0 -204
  185. package/dist/registry/templates/evidence/Design-Evidence.md +0 -30
  186. package/dist/registry/templates/evidence/Implementation-BugEvidence.md +0 -122
  187. package/dist/registry/templates/evidence/Implementation-FeatureEvidence.md +0 -160
  188. package/dist/registry/templates/evidence/Spec-Evidence.md +0 -19
  189. package/dist/registry/templates/help/HelpNeeded.md +0 -14
  190. package/dist/registry/templates/legal/NDA-TEMPLATE.md +0 -170
  191. package/dist/registry/templates/legal/PATENT-TEMPLATE.md +0 -372
  192. package/dist/registry/templates/legal/TRADEMARK-TEMPLATE.md +0 -339
  193. package/dist/registry/templates/legal/contract-review-checklist.md +0 -193
  194. package/dist/registry/templates/legal/review-report-template.md +0 -198
  195. package/dist/registry/templates/legal/saas-terms-template.md +0 -174
  196. package/dist/registry/templates/legal/sow-template.md +0 -117
  197. package/dist/registry/templates/legal/template-variables.md +0 -131
  198. package/dist/registry/templates/marketing/DOMAIN-REGISTRATION-TEMPLATE.md +0 -194
  199. package/dist/registry/templates/marketing/EVANGELIZE-TEMPLATE.md +0 -102
  200. package/dist/registry/templates/marketing/HBR-ARTICLE-TEMPLATE.md +0 -66
  201. package/dist/registry/templates/marketing/STORYTELLING-TEMPLATE.md +0 -130
  202. package/dist/registry/templates/marketing/WEBSITE-TEMPLATE.md +0 -262
  203. package/dist/registry/templates/marketing/github-pages-workflow.yml +0 -64
  204. package/dist/registry/templates/replicate/implementation-checklist.md +0 -39
  205. package/dist/registry/templates/replicate/use-cases-template.md +0 -88
  206. package/dist/registry/templates/retrospective/RETROSPECTIVE-TEMPLATE.md +0 -55
  207. package/dist/registry/templates/specs/BUGSPEC-TEMPLATE.md +0 -37
  208. package/dist/registry/templates/specs/FEATURESPEC-TEMPLATE.md +0 -66
  209. package/dist/registry/templates/specs/TECHSPEC-TEMPLATE.md +0 -39
  210. package/dist/registry/workflows/azure/cost-optimization.md +0 -772
  211. package/dist/registry/workflows/bootstrap/create-architecture.md +0 -37
  212. package/dist/registry/workflows/bootstrap/detect-broken-windows.md +0 -300
  213. package/dist/registry/workflows/bootstrap/evaluate-code-quality.md +0 -35
  214. package/dist/registry/workflows/bootstrap/verify-test-coverage.md +0 -36
  215. package/dist/registry/workflows/brainstorming/blue-sky-brainstorming.md +0 -211
  216. package/dist/registry/workflows/brainstorming/codebase-brainstorming.md +0 -159
  217. package/dist/registry/workflows/business-development/create-business-plan.md +0 -737
  218. package/dist/registry/workflows/business-development/ideate-business-opportunity.md +0 -55
  219. package/dist/registry/workflows/business-development/price-product.md +0 -325
  220. package/dist/registry/workflows/compliance/detect-compliance-requirements.md +0 -80
  221. package/dist/registry/workflows/compliance/generate-audit-evidence.md +0 -80
  222. package/dist/registry/workflows/compliance/soc2-evidence-generator.md +0 -332
  223. package/dist/registry/workflows/customer-development/insight-analysis.md +0 -156
  224. package/dist/registry/workflows/customer-development/insight-triage.md +0 -933
  225. package/dist/registry/workflows/customer-development/interview-preparation.md +0 -452
  226. package/dist/registry/workflows/customer-development/linkedin-outreach.md +0 -599
  227. package/dist/registry/workflows/customer-development/strategic-brainstorming.md +0 -146
  228. package/dist/registry/workflows/customer-development/thank-customers.md +0 -203
  229. package/dist/registry/workflows/customer-development/user-survey-dispatch.md +0 -312
  230. package/dist/registry/workflows/customer-development/users-to-target.md +0 -427
  231. package/dist/registry/workflows/customer-development/weekly-newsletter.md +0 -366
  232. package/dist/registry/workflows/deploy/cloud-deployment.md +0 -310
  233. package/dist/registry/workflows/improve-fraim/contribute.md +0 -32
  234. package/dist/registry/workflows/improve-fraim/file-issue.md +0 -32
  235. package/dist/registry/workflows/learning/build-skillset.md +0 -212
  236. package/dist/registry/workflows/learning/synthesize-learnings.md +0 -369
  237. package/dist/registry/workflows/legal/contract-review-analysis.md +0 -382
  238. package/dist/registry/workflows/legal/nda.md +0 -69
  239. package/dist/registry/workflows/legal/patent-filing.md +0 -76
  240. package/dist/registry/workflows/legal/saas-contract-development.md +0 -204
  241. package/dist/registry/workflows/legal/trademark-filing.md +0 -77
  242. package/dist/registry/workflows/marketing/content-creation.md +0 -40
  243. package/dist/registry/workflows/marketing/convert-to-pdf.md +0 -265
  244. package/dist/registry/workflows/marketing/create-modern-website.md +0 -456
  245. package/dist/registry/workflows/marketing/domain-registration.md +0 -323
  246. package/dist/registry/workflows/marketing/evangelize.md +0 -426
  247. package/dist/registry/workflows/marketing/hbr-article.md +0 -73
  248. package/dist/registry/workflows/marketing/launch-checklist.md +0 -37
  249. package/dist/registry/workflows/marketing/marketing-strategy.md +0 -45
  250. package/dist/registry/workflows/marketing/storytelling.md +0 -65
  251. package/dist/registry/workflows/performance/analyze-performance.md +0 -65
  252. package/dist/registry/workflows/product-building/design.md +0 -263
  253. package/dist/registry/workflows/product-building/implement.md +0 -771
  254. package/dist/registry/workflows/product-building/iterate-on-pr-comments.md +0 -70
  255. package/dist/registry/workflows/product-building/prep-issue.md +0 -41
  256. package/dist/registry/workflows/product-building/prototype.md +0 -60
  257. package/dist/registry/workflows/product-building/resolve.md +0 -175
  258. package/dist/registry/workflows/product-building/retrospect.md +0 -86
  259. package/dist/registry/workflows/product-building/spec.md +0 -303
  260. package/dist/registry/workflows/product-building/test.md +0 -125
  261. package/dist/registry/workflows/productivity-report/productivity-report.md +0 -263
  262. package/dist/registry/workflows/quality-assurance/browser-validation.md +0 -221
  263. package/dist/registry/workflows/quality-assurance/iterative-improvement-cycle.md +0 -562
  264. package/dist/registry/workflows/replicate/replicate-discovery.md +0 -336
  265. package/dist/registry/workflows/replicate/replicate-to-issues.md +0 -319
  266. package/dist/registry/workflows/reviewer/review-implementation-vs-design-spec.md +0 -694
  267. package/dist/registry/workflows/reviewer/review-implementation-vs-feature-spec.md +0 -734
  268. package/dist/registry/workflows/startup-credits/aws-activate-application.md +0 -535
  269. package/dist/registry/workflows/startup-credits/google-cloud-application.md +0 -647
  270. package/dist/registry/workflows/startup-credits/microsoft-azure-application.md +0 -538
  271. package/dist/src/cli/commands/init.js +0 -148
  272. package/dist/src/cli/commands/mcp.js +0 -65
  273. package/dist/src/cli/commands/wizard.js +0 -35
  274. package/dist/src/fraim/issue-tracking/ado-provider.js +0 -304
  275. package/dist/src/fraim/issue-tracking/factory.js +0 -63
  276. package/dist/src/fraim/issue-tracking/github-provider.js +0 -200
  277. package/dist/src/fraim/issue-tracking/types.js +0 -7
  278. package/dist/src/fraim/issue-tracking-config.js +0 -83
  279. package/dist/src/fraim/retrospective-learner.js +0 -301
  280. package/dist/src/fraim/setup-wizard.js +0 -99
@@ -1,37 +0,0 @@
1
- # FRAIM Workflow: create-architecture
2
-
3
- ## Intent
4
- To analyze the codebase and author a comprehensive `docs/architecture/architecture.md` document using the standard template. This document captures the system's design, tech stack, and architectural layers to serve as a map for development.
5
-
6
- ## Execution Steps
7
-
8
- 1. **Analyze Project Structure**
9
- - Use `list_dir` to explore the root directory and key subdirectories (src, docs, etc.).
10
- - Use `view_file` on key configuration files (package.json, tsconfig.json, etc.).
11
- - Identify main entry points and architectural patterns.
12
-
13
- 2. **Author Architecture Document**
14
- - Locate the template: `get_fraim_file({ path: "templates/bootstrap/ARCHITECTURE-TEMPLATE.md" })`
15
- - Analyze your findings from Step 1.
16
- - Create a new file at `docs/architecture/architecture.md`.
17
- - Use your intelligence to synthesize the findings into the template:
18
- - **Tech Stack**: Detail specific languages, runtimes, and frameworks used.
19
- - **Architectural Layers**: Define the system's layers (Presentation, Logic, Data, etc.).
20
- - **Key Components**: Map out the core modules and their relationships.
21
- - **Data Flow**: Explain the lifecycle of a typical request or action.
22
-
23
- 3. **Update FRAIM Configuration**
24
- - Update the project configuration file at `.fraim/config.json` to include a reference to the architecture document:
25
- ```json
26
- {
27
- ...
28
- "customizations": {
29
- "architectureDoc": "docs/architecture/architecture.md",
30
- ...
31
- }
32
- }
33
- ```
34
-
35
- 4. **Verify**
36
- - Check that `docs/architecture/architecture.md` exists and is populated.
37
- - Check that `.fraim/config.json` contains the `architectureDoc` field pointing to the correct path.
@@ -1,300 +0,0 @@
1
- # Detect Broken Windows Workflow
2
-
3
- ## INTENT
4
- Identify and eliminate "broken windows" in codebases by detecting pattern deviations that cause AI agents to learn bad patterns and degrade code quality over time. Focus on finding "needles in the haystack" - files that deviate from established codebase patterns.
5
-
6
- ## PRINCIPLES
7
- - **Broken Window Theory**: Small signs of neglect lead to larger quality degradation
8
- - **Pattern Consistency**: AI agents learn from existing code patterns - deviations confuse them
9
- - **Needle Detection**: Find the few files that break otherwise consistent patterns
10
- - **Proactive Maintenance**: Fix pattern deviations before they become systemic problems
11
- - **Quality Environment**: Consistent patterns produce cleaner agent output
12
-
13
- ## WORKFLOW TRIGGER
14
- **Developer explicitly starts this workflow**:
15
- - "Detect broken windows in [project/directory]"
16
- - "Find pattern deviations that might confuse AI agents"
17
- - "Check for broken windows in my codebase"
18
- - "Following the detect broken windows workflow"
19
-
20
- ## INPUT REQUIREMENTS
21
- **Developer provides**:
22
- - Target directory or project path to analyze
23
- - Optional: Specific file patterns to focus on (e.g., "*.test.ts", "src/**/*.js")
24
- - Optional: Known patterns to validate (e.g., "all tests should extend BaseTest")
25
-
26
- ## CRITICAL OUTPUT REQUIREMENT
27
- **🚨 YOU MUST CREATE A FILE - DO NOT JUST PROVIDE TEXT OUTPUT 🚨**
28
-
29
- **REQUIRED FILE CREATION:**
30
- 1. **FIRST**: Create file at: `docs/bootstrap/broken-windows-report-[YYYY-MM-DD].md`
31
- 2. **FILL**: Complete all sections with pattern analysis and deviation findings
32
- 3. **PRIORITIZE**: Focus on deviations that impact AI agent behavior
33
-
34
- **DO NOT:**
35
- - Provide analysis findings as chat output only
36
- - Skip file creation step
37
- - Create partial reports
38
-
39
- **YOU MUST:**
40
- - Create the actual markdown file
41
- - Use the specified file path format
42
- - Include specific file paths and line numbers for all deviations found
43
-
44
- ## AI AGENT PROCESS
45
-
46
- ### Step 1: Codebase Pattern Discovery
47
- **AI Agent Pattern Analysis Process**:
48
-
49
- #### Step 1a: File Structure Analysis
50
- 1. **Scan Target Directory**
51
- - Identify all relevant source files (exclude node_modules, dist, build)
52
- - Categorize files by type: tests, components, utilities, configs, etc.
53
- - Count files in each category for statistical analysis
54
-
55
- 2. **Extract Code Patterns**
56
- - **Import Patterns**: How modules are imported (`import`, `require`, relative vs absolute paths)
57
- - **Class/Function Patterns**: Inheritance, composition, naming conventions
58
- - **Test Patterns**: Base classes, setup/teardown, assertion styles
59
- - **Error Handling Patterns**: try/catch usage, error types, logging approaches
60
- - **Configuration Patterns**: How config values are accessed and used
61
- - **Resource Management**: Database connections, file handles, cleanup patterns
62
-
63
- #### Step 1b: Pattern Frequency Analysis
64
- 1. **Calculate Pattern Dominance**
65
- - Count occurrences of each pattern across the codebase
66
- - Calculate percentages: Pattern A used in 85% of files, Pattern B in 15%
67
- - Identify **dominant patterns** (>70% usage) vs **minority patterns** (<30% usage)
68
-
69
- 2. **Statistical Pattern Mapping**
70
- ```
71
- Example Analysis:
72
- - Test Base Classes: 47/50 files extend BaseTest (94% dominant)
73
- - Import Style: 89/95 files use '@/' imports (94% dominant)
74
- - Error Handling: 72/80 functions use structured errors (90% dominant)
75
- - Database Access: 23/25 files use connection pool (92% dominant)
76
- ```
77
-
78
- ### Step 2: Broken Window Detection (Needle Finding)
79
- **AI Agent Broken Window Detection Process**:
80
-
81
- #### Step 2a: Identify Pattern Deviations (Broken Windows)
82
- 1. **Test Pattern Broken Windows**
83
- - **Dominant Pattern**: `class MyTest extends BaseTest`
84
- - **Broken Windows Found**: 3 files using raw `describe()` without base class
85
- - **Files**: `src/legacy/old-test.spec.ts`, `src/utils/helper.test.ts`
86
- - **Impact**: AI agents might copy non-standard test structure
87
-
88
- 2. **Import Pattern Broken Windows**
89
- - **Dominant Pattern**: `import { Logger } from '@/utils/logger'`
90
- - **Broken Windows Found**: 6 files using `console.log` directly
91
- - **Files**: `src/debug/temp.ts`, `src/scripts/migration.ts`
92
- - **Impact**: Inconsistent logging that agents might replicate
93
-
94
- 3. **Error Handling Broken Windows**
95
- - **Dominant Pattern**: `throw new AppError('message', ErrorCode.VALIDATION)`
96
- - **Broken Windows Found**: 4 functions throwing raw strings
97
- - **Files**: `src/legacy/parser.ts:45`, `src/utils/validator.ts:23`
98
- - **Impact**: Inconsistent error handling patterns
99
-
100
- 4. **Configuration Broken Windows**
101
- - **Dominant Pattern**: `config.get('database.port')`
102
- - **Broken Windows Found**: 2 files with hardcoded values
103
- - **Files**: `src/integration/integration.spec.ts:12` (port 5432), `src/scripts/seed.ts:8` (localhost)
104
- - **Impact**: Configuration inconsistency and test brittleness
105
-
106
- 5. **Resource Management Broken Windows**
107
- - **Dominant Pattern**: `await db.getConnection()` with proper cleanup
108
- - **Broken Windows Found**: 3 files opening direct connections
109
- - **Files**: `src/migration/runner.ts`, `src/backup/export.ts`
110
- - **Impact**: Resource leaks and inconsistent connection patterns
111
-
112
- #### Step 2b: Broken Window Impact Assessment
113
- 1. **AI Agent Confusion Risk**
114
- - **High Risk**: Broken windows in frequently-used patterns (imports, error handling)
115
- - **Medium Risk**: Broken windows in specialized areas (tests, configs)
116
- - **Low Risk**: Broken windows in legacy/deprecated code
117
-
118
- 2. **Pattern Proliferation Risk**
119
- - **High Risk**: Easy-to-copy broken windows (hardcoded values, console.log)
120
- - **Medium Risk**: Structural broken windows (missing base classes)
121
- - **Low Risk**: Complex architectural broken windows
122
-
123
- ### Step 3: CREATE BROKEN WINDOWS REPORT FILE
124
- **🚨 CRITICAL: YOU MUST CREATE AN ACTUAL FILE 🚨**
125
-
126
- **AI Agent File Creation Process:**
127
- 1. **CREATE FILE**
128
- - File location: `docs/bootstrap/broken-windows-report-[YYYY-MM-DD].md`
129
- - Replace `[YYYY-MM-DD]` with current date
130
- - Example: `docs/bootstrap/broken-windows-report-2024-01-15.md`
131
-
132
- 2. **FILL REPORT SECTIONS**
133
- - **Executive Summary**: Overview of pattern health and key broken windows found
134
- - **Pattern Analysis**: Statistical breakdown of dominant vs minority patterns
135
- - **Critical Broken Windows**: High-impact needles that need immediate attention
136
- - **Broken Window Inventory**: Complete list of all pattern deviations found
137
- - **Remediation Plan**: Prioritized action items with specific file paths
138
- - **Prevention Strategies**: Recommendations to prevent future broken windows
139
-
140
- ### Step 4: Remediation Planning
141
- **AI Agent Remediation Process**:
142
-
143
- 1. **Prioritize Broken Windows by Impact**
144
- - **P0 (Critical)**: Broken windows that directly impact AI agent behavior
145
- - **P1 (High)**: Broken windows that create inconsistent developer experience
146
- - **P2 (Medium)**: Broken windows that reduce code maintainability
147
- - **P3 (Low)**: Broken windows in legacy code scheduled for replacement
148
-
149
- 2. **Generate Specific Fix Recommendations**
150
- - **File-Level Fixes**: Exact changes needed in specific files
151
- - **Pattern Standardization**: Rules to enforce consistent patterns
152
- - **Tooling Recommendations**: Linters, formatters, or custom rules to prevent drift
153
- - **Refactoring Strategies**: Systematic approaches to align deviations with dominant patterns
154
-
155
- 3. **Create Prevention Strategy**
156
- - **Code Review Guidelines**: What to look for in PRs
157
- - **Automated Checks**: ESLint rules, custom scripts, CI/CD validations
158
- - **Documentation Updates**: Coding standards and pattern guidelines
159
- - **Regular Audits**: Schedule for periodic broken window detection
160
-
161
- ## FINAL OUTPUT DELIVERABLE
162
-
163
- ### 🚨 REQUIRED: Comprehensive Broken Windows Report FILE 🚨
164
- **File Location**: `docs/bootstrap/broken-windows-report-[YYYY-MM-DD].md`
165
-
166
- **CRITICAL REQUIREMENTS:**
167
- - **MUST CREATE ACTUAL FILE** - Not just chat output
168
- - **MUST INCLUDE SPECIFIC FILE PATHS** - Exact locations of broken windows
169
- - **MUST PROVIDE STATISTICAL ANALYSIS** - Pattern frequency percentages
170
- - **MUST PRIORITIZE BY AI IMPACT** - Focus on agent behavior effects
171
-
172
- **Report Structure**:
173
- ```markdown
174
- # Broken Windows Report - [Date]
175
-
176
- ## Executive Summary
177
- - Total files analyzed: [X]
178
- - Dominant patterns identified: [X]
179
- - Critical broken windows found: [X]
180
- - High-priority fixes needed: [X]
181
-
182
- ## Pattern Analysis
183
- ### Test Patterns
184
- - Dominant: BaseTest extension (94% - 47/50 files)
185
- - Broken Windows: Raw describe() usage (6% - 3/50 files)
186
-
187
- ### Import Patterns
188
- - Dominant: '@/' absolute imports (94% - 89/95 files)
189
- - Broken Windows: Relative imports (6% - 6/95 files)
190
-
191
- ## Critical Broken Windows (P0)
192
- ### 1. Hardcoded Configuration Values
193
- **Impact**: AI agents copy hardcoded values instead of config patterns
194
- **Files**:
195
- - `src/integration/integration.spec.ts:12` - hardcoded port 5432
196
- - `src/scripts/seed.ts:8` - hardcoded localhost
197
-
198
- **Fix**: Replace with `config.get('database.port')` pattern
199
-
200
- ## Remediation Plan
201
- ### Immediate Actions (This Sprint)
202
- 1. Fix hardcoded values in 2 files
203
- 2. Standardize error handling in 4 functions
204
- 3. Update import patterns in 6 files
205
-
206
- ### Prevention Strategy
207
- 1. Add ESLint rule for hardcoded values
208
- 2. Update code review checklist
209
- 3. Schedule monthly broken window detection
210
- ```
211
-
212
- ## EXAMPLES
213
-
214
- ### Good: Comprehensive Broken Window Detection
215
- ```
216
- Input: "Detect broken windows in src/ directory"
217
-
218
- AI Agent Process:
219
- 1. Scans 150 TypeScript files in src/ directory
220
- 2. Identifies patterns:
221
- - Test patterns: 47/50 files extend BaseTest (94% dominant)
222
- - Import patterns: 89/95 files use '@/' imports (94% dominant)
223
- - Error patterns: 72/80 functions use AppError class (90% dominant)
224
- 3. Finds broken windows:
225
- - 3 test files don't extend BaseTest (needles in haystack)
226
- - 6 files use relative imports (pattern deviation)
227
- - 8 functions throw raw strings (error handling deviation)
228
-
229
- AI Agent Output:
230
- - **CREATED FILE**: `docs/bootstrap/broken-windows-report-2024-01-15.md`
231
- - Statistical pattern analysis with percentages
232
- - Specific file paths for all broken windows found
233
- - Prioritized remediation plan focusing on AI agent impact
234
- - Prevention strategies to maintain pattern consistency
235
-
236
- Result: Clear roadmap to eliminate broken windows and improve agent performance
237
- ```
238
-
239
- ### Good: Needle Detection Focus
240
- ```
241
- Input: "Find broken windows in test files that might confuse AI agents"
242
-
243
- AI Agent Process:
244
- 1. Analyzes 50 test files
245
- 2. Discovers dominant pattern: `class MyTest extends BaseTestClass`
246
- 3. Finds broken windows: 3 files using raw `describe()` blocks
247
- 4. Assesses impact: High risk for AI agents to copy non-standard pattern
248
-
249
- AI Agent Output:
250
- - **CREATED FILE**: `docs/bootstrap/broken-windows-report-2024-01-15.md`
251
- - Focus section on test pattern broken windows
252
- - Specific files: `legacy/old-test.spec.ts`, `utils/helper.test.ts`, `temp/debug.test.ts`
253
- - Remediation: Convert 3 files to extend BaseTestClass
254
- - Prevention: Add linting rule to enforce base class usage
255
-
256
- Result: Targeted fix for test pattern consistency
257
- ```
258
-
259
- ### Bad: Generic Analysis Without File Creation
260
- ```
261
- Input: "Check my codebase for issues"
262
-
263
- AI Agent Output:
264
- - **FAILED TO CREATE FILE** - Only provided chat output
265
- - Generic list of potential issues
266
- - No specific file paths or line numbers
267
- - No statistical pattern analysis
268
- - No focus on AI agent impact
269
- - No actionable remediation plan
270
-
271
- Result: Unusable analysis that doesn't help fix broken windows
272
- ```
273
-
274
- ### Bad: Missing Broken Window Focus
275
- ```
276
- Input: "Detect broken windows"
277
-
278
- AI Agent Process:
279
- - Looks for generic code smells
280
- - Misses pattern deviation analysis
281
- - Doesn't identify dominant vs minority patterns
282
- - No statistical frequency analysis
283
-
284
- AI Agent Output:
285
- - **CREATED FILE** but with incomplete analysis
286
- - Lists generic issues like "long functions" and "complex conditionals"
287
- - Misses the critical broken windows: 3 files breaking test patterns
288
- - No focus on AI agent confusion risk
289
- - Generic recommendations not specific to pattern consistency
290
-
291
- Result: Misses the core broken windows that impact agent behavior
292
- ```
293
-
294
- ## SUCCESS METRICS
295
- - **Pattern Consistency**: 95%+ of files follow dominant patterns after remediation
296
- - **AI Agent Performance**: Reduced iterations and higher code quality in agent output
297
- - **Broken Window Detection**: 100% of pattern deviations identified with specific file paths
298
- - **Actionable Fixes**: Every broken window has specific remediation steps
299
- - **Prevention**: Automated checks prevent future broken windows
300
- - **Documentation**: Clear broken window reports for tracking progress over time
@@ -1,35 +0,0 @@
1
- # FRAIM Workflow: evaluate-code-quality
2
-
3
- ## Intent
4
- To perform a deep analysis of the codebase's quality, evaluating it against FRAIM's standards and generating a comprehensive health report.
5
-
6
- ## Execution Steps
7
-
8
- 1. **Environment Check**
9
- - Ensure `npm install` and `npm run build` have been attempted.
10
- - Verify that `.fraim` directory (or equivalent config) is present.
11
-
12
- 2. **Run Quality Analysis**
13
- - Execute the self-contained quality analysis script:
14
- ```bash
15
- # Execute evaluate-code-quality script directly from synced location
16
- npx tsx ~/.fraim/scripts/evaluate-code-quality.ts
17
-
18
- # Note: Windows users should use Git Bash terminal
19
- ```
20
-
21
- 3. **Author Report**
22
- - Read the terminal output from Step 2.
23
- - Locate the template: `get_fraim_file({ path: "templates/bootstrap/CODE-QUALITY-REPORT-TEMPLATE.md" })`
24
- - Create a new file at `docs/bootstrap/code-quality-report.md`.
25
- - Use your intelligence to synthesize the findings into the template:
26
- - Assign a fair grade (A-F) based on build success and diagnostic results.
27
- - Detail specific quality risks found in Gate 1-11.
28
- - Propose actionable remediation steps.
29
-
30
- 4. **Review Findings**
31
- - Summarize the top 3 quality risks to the user.
32
- - Propose a remediation plan if the grade is below 'B'.
33
-
34
- 5. **Update Status**
35
- - Label any relevant issues with `quality:evaluated`.
@@ -1,36 +0,0 @@
1
- # FRAIM Workflow: verify-test-coverage
2
-
3
- ## Intent
4
- To verify the depth and effectiveness of the test suite by comparing actual test execution against the validation plans defined in specifications.
5
-
6
- ## Execution Steps
7
-
8
- 1. **Run Tests with Coverage**
9
- - Execute the project's test suite with coverage enabled (e.g., `npx tsx ~/.fraim/scripts/exec-with-timeout.ts --timeout 180 -- npm test -- --coverage`).
10
- - Ensure coverage reports (LCOV or JSON) are generated.
11
-
12
- 2. **Map Validation Plans**
13
- - Identify all RFCs and Spec documents in `docs/`.
14
- - Extract "Validation Plan" tables from these documents.
15
-
16
- 3. **Analyze Coverage Gaps**
17
- - Execute the self-contained test coverage verification script:
18
- ```bash
19
- # Execute verify-test-coverage script directly from synced location
20
- npx tsx ~/.fraim/scripts/verify-test-coverage.ts
21
-
22
- # Note: Windows users should use Git Bash terminal
23
- ```
24
-
25
- 4. **Author Report**
26
- - Read the terminal output from Step 3.
27
- - Locate the template: `get_fraim_file({ path: "templates/bootstrap/TEST-COVERAGE-REPORT-TEMPLATE.md" })`
28
- - Create a new file at `docs/bootstrap/test-coverage-report.md`.
29
- - Use your intelligence to synthesize the findings into the template:
30
- - Highlight mission-critical scenarios that lack automated test evidence.
31
- - Discuss line coverage trends.
32
- - Recommend specific test cases to bridge coverage gaps.
33
-
34
- 5. **Review Findings**
35
- - Alert the user if critical validation scenarios are uncovered.
36
- - Suggest specific tests to improve coverage score.
@@ -1,211 +0,0 @@
1
- # Workflow: blue-sky-brainstorming
2
-
3
- **Path:** `workflows/brainstorming/blue-sky-brainstorming.md`
4
-
5
- ---
6
-
7
- # Blue Sky Brainstorming
8
-
9
- ## INTENT
10
- Generate visionary, moonshot, and futuristic ideas without the constraints of current implementation details. This is for exploring "what if" scenarios and breakthrough possibilities.
11
-
12
- ## PRINCIPLES
13
- - **No Limits Thinking**: Ignore current technical constraints
14
- - **Future-Oriented**: Think 2-5 years ahead
15
- - **Breakthrough Focus**: Aim for 10x improvements, not 10% optimizations
16
- - **Clear Labeling**: Always mark ideas as speculative/futuristic
17
- - **Inspiration Over Implementation**: Focus on possibilities, not immediate practicality
18
-
19
- ## WHEN TO USE
20
-
21
- - **Vision Setting**: Defining long-term product direction
22
- - **Innovation Sessions**: Exploring breakthrough possibilities
23
- - **Strategic Planning**: Understanding future opportunities
24
- - **Problem Reframing**: Approaching challenges from completely new angles
25
- - **Technology Exploration**: Considering emerging tech applications
26
-
27
- ## WORKFLOW
28
-
29
- ### Phase 1: Constraint Removal
30
- **Objective**: Identify and temporarily ignore current limitations
31
-
32
- **Actions**:
33
- 1. **List Current Constraints**: Technical, resource, time, knowledge limitations
34
- 2. **Suspend Disbelief**: Assume unlimited resources and perfect technology
35
- 3. **Expand Time Horizon**: Think 2-5 years into the future
36
- 4. **Remove Implementation Concerns**: Focus on outcomes, not how
37
-
38
- **Mindset Shift**: From "How can we improve this?" to "What would perfect look like?"
39
-
40
- ### Phase 2: Visionary Ideation
41
- **Objective**: Generate breakthrough ideas across multiple dimensions
42
-
43
- #### Technology Moonshots:
44
- - What if AI could perfectly understand context and intent?
45
- - What if we had unlimited computational resources?
46
- - What if agents could learn and adapt in real-time?
47
- - What if we could predict and prevent all failure modes?
48
-
49
- #### User Experience Breakthroughs:
50
- - What if development felt like natural conversation?
51
- - What if agents could read your mind and anticipate needs?
52
- - What if coding became as easy as describing what you want?
53
- - What if bugs were impossible to create?
54
-
55
- #### System Architecture Visions:
56
- - What if systems could self-heal and self-optimize?
57
- - What if code could write and maintain itself?
58
- - What if testing was completely automated and comprehensive?
59
- - What if deployment was instant and risk-free?
60
-
61
- #### Business Model Innovations:
62
- - What if software development was 100x faster?
63
- - What if quality was guaranteed?
64
- - What if maintenance was completely automated?
65
- - What if every developer had a perfect AI pair programmer?
66
-
67
- ### Phase 3: Scenario Development
68
- **Objective**: Develop the most promising ideas into detailed scenarios
69
-
70
- **For Each Selected Idea**:
71
- 1. **Vision Statement**: What would this look like in practice?
72
- 2. **User Experience**: How would people interact with this?
73
- 3. **Impact Assessment**: What would change if this existed?
74
- 4. **Enabling Technologies**: What breakthroughs would make this possible?
75
-
76
- ### Phase 4: Reality Bridge
77
- **Objective**: Identify potential paths from current state to future vision
78
-
79
- **Questions**:
80
- - What early indicators might suggest this is becoming possible?
81
- - What foundational work could move us in this direction?
82
- - What experiments could test key assumptions?
83
- - What partnerships or research might accelerate progress?
84
-
85
- ## RESPONSE TEMPLATE
86
-
87
- ```markdown
88
- # Blue Sky Vision: [Topic/Domain]
89
-
90
- ## 🚀 Moonshot Ideas
91
-
92
- ### [Breakthrough Concept 1]
93
- **Vision**: [Describe the impossible-seeming possibility]
94
- **Impact**: [What would change if this existed]
95
- **User Experience**: [How people would interact with this]
96
- **Enabling Tech**: [What breakthroughs would be needed]
97
-
98
- ### [Breakthrough Concept 2]
99
- **Vision**: [Another visionary possibility]
100
- **Impact**: [Transformational effects]
101
- **User Experience**: [Revolutionary interaction model]
102
- **Enabling Tech**: [Required technological advances]
103
-
104
- ## 🔮 Future Scenarios (2-5 years)
105
-
106
- ### Scenario A: [Optimistic Future]
107
- [Detailed description of best-case evolution]
108
-
109
- ### Scenario B: [Transformative Future]
110
- [Description of breakthrough-driven change]
111
-
112
- ### Scenario C: [Convergence Future]
113
- [Multiple technologies combining for new possibilities]
114
-
115
- ## 🌉 Reality Bridges
116
-
117
- ### Near-term Experiments:
118
- - [What could we test today]
119
- - [Early prototypes or proofs of concept]
120
-
121
- ### Foundation Building:
122
- - [Research areas to invest in]
123
- - [Partnerships to explore]
124
- - [Technologies to track]
125
-
126
- ### Leading Indicators:
127
- - [Signals that suggest progress toward vision]
128
- - [Metrics that would indicate breakthrough potential]
129
-
130
- ## 💡 Wild Ideas (No Filter)
131
- - [Completely speculative possibilities]
132
- - [Ideas that seem impossible today]
133
- - [Concepts that challenge fundamental assumptions]
134
- ```
135
-
136
- ## BLUE SKY THINKING TECHNIQUES
137
-
138
- ### 1. **Inversion Thinking**
139
- - What if the opposite of current approach was true?
140
- - What if constraints became advantages?
141
- - What if problems became features?
142
-
143
- ### 2. **10x Thinking**
144
- - Not 10% better, but 10x better
145
- - What would need to be true for 10x improvement?
146
- - What would break if we achieved 10x scale?
147
-
148
- ### 3. **Adjacent Possible**
149
- - What becomes possible if current trends continue?
150
- - What new combinations might emerge?
151
- - What would unlock if one constraint was removed?
152
-
153
- ### 4. **Science Fiction Prototyping**
154
- - What do sci-fi stories suggest about the future?
155
- - What technologies are portrayed as commonplace?
156
- - What social changes accompany technological advances?
157
-
158
- ## EXAMPLE BLUE SKY IDEAS
159
-
160
- ### 🚀 Agent Evolution Moonshots:
161
- - **Conscious AI Agents**: Agents with genuine understanding and creativity
162
- - **Collective Intelligence**: Agents that learn from all human developers globally
163
- - **Predictive Development**: Agents that anticipate needs before they're expressed
164
- - **Self-Improving Systems**: Code that continuously optimizes itself
165
-
166
- ### 🔮 Development Experience Visions:
167
- - **Thought-to-Code**: Direct translation of ideas into working software
168
- - **Zero-Bug Development**: Systems that make bugs impossible to create
169
- - **Instant Deployment**: Changes go live immediately with zero risk
170
- - **Perfect Documentation**: Code that explains itself in natural language
171
-
172
- ### 🌉 System Architecture Dreams:
173
- - **Self-Healing Infrastructure**: Systems that fix themselves automatically
174
- - **Infinite Scalability**: Resources that expand automatically with demand
175
- - **Perfect Security**: Systems immune to all forms of attack
176
- - **Universal Compatibility**: All systems work together seamlessly
177
-
178
- ## QUALITY GUIDELINES
179
-
180
- ### ✅ Good Blue Sky Thinking:
181
- - Challenges fundamental assumptions
182
- - Imagines breakthrough user experiences
183
- - Considers societal and technological convergence
184
- - Maintains optimistic but thoughtful perspective
185
- - Clearly labeled as speculative
186
-
187
- ### ❌ Avoid in Blue Sky Sessions:
188
- - Getting bogged down in implementation details
189
- - Limiting ideas based on current constraints
190
- - Focusing on incremental improvements
191
- - Worrying about feasibility too early
192
- - Mixing blue sky with practical planning
193
-
194
- ## FOLLOW-UP ACTIONS
195
-
196
- After blue sky brainstorming:
197
- 1. **Document Everything**: Capture all ideas, even seemingly impossible ones
198
- 2. **Identify Themes**: Look for patterns across different ideas
199
- 3. **Select Focus Areas**: Choose 2-3 concepts for deeper exploration
200
- 4. **Plan Reality Checks**: Schedule sessions to evaluate feasibility
201
- 5. **Create Vision Artifacts**: Develop compelling descriptions of preferred futures
202
-
203
- ## SUMMARY
204
-
205
- Blue sky brainstorming is about:
206
- - **Expanding Possibilities**: Seeing beyond current limitations
207
- - **Inspiring Innovation**: Creating compelling visions of the future
208
- - **Strategic Thinking**: Understanding long-term opportunities
209
- - **Creative Problem Solving**: Approaching challenges from new angles
210
-
211
- Remember: Today's impossible ideas often become tomorrow's breakthrough innovations. The goal is to expand thinking, not to create immediate implementation plans.