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.
- package/bin/fraim.js +1 -1
- package/dist/src/cli/commands/doctor.js +1 -1
- package/dist/src/cli/commands/init-project.js +6 -12
- package/dist/src/cli/commands/list.js +1 -1
- package/dist/src/cli/commands/setup.js +15 -29
- package/dist/src/cli/commands/sync.js +36 -143
- package/dist/src/cli/fraim.js +0 -4
- package/dist/src/cli/setup/first-run.js +4 -4
- package/dist/src/cli/setup/ide-detector.js +15 -5
- package/dist/src/fraim/template-processor.js +7 -35
- package/dist/src/local-mcp-server/stdio-server.js +170 -181
- package/dist/src/utils/git-utils.js +2 -2
- package/dist/src/utils/object-utils.js +11 -0
- package/dist/src/utils/provider-utils.js +14 -0
- package/dist/src/utils/request-utils.js +23 -0
- package/dist/src/utils/workflow-parser.js +7 -7
- package/package.json +7 -5
- package/dist/registry/ai-manager-rules/customer-development-phases/phase1-customer-profiling.md +0 -101
- package/dist/registry/ai-manager-rules/customer-development-phases/phase2-platform-discovery.md +0 -235
- package/dist/registry/ai-manager-rules/customer-development-phases/phase3-prospect-qualification.md +0 -243
- package/dist/registry/ai-manager-rules/customer-development-phases/phase4-inventory-compilation.md +0 -206
- package/dist/registry/ai-manager-rules/design-phases/design-completeness-review.md +0 -73
- package/dist/registry/ai-manager-rules/design-phases/design-design.md +0 -145
- package/dist/registry/ai-manager-rules/design-phases/design.md +0 -108
- package/dist/registry/ai-manager-rules/design-phases/finalize.md +0 -60
- package/dist/registry/ai-manager-rules/design-phases/validate.md +0 -125
- package/dist/registry/ai-manager-rules/design.json +0 -97
- package/dist/registry/ai-manager-rules/implement-phases/code.md +0 -323
- package/dist/registry/ai-manager-rules/implement-phases/completeness-review.md +0 -94
- package/dist/registry/ai-manager-rules/implement-phases/finalize.md +0 -177
- package/dist/registry/ai-manager-rules/implement-phases/implement-code.md +0 -283
- package/dist/registry/ai-manager-rules/implement-phases/implement-completeness-review.md +0 -120
- package/dist/registry/ai-manager-rules/implement-phases/implement-regression.md +0 -173
- package/dist/registry/ai-manager-rules/implement-phases/implement-repro.md +0 -104
- package/dist/registry/ai-manager-rules/implement-phases/implement-scoping.md +0 -100
- package/dist/registry/ai-manager-rules/implement-phases/implement-smoke.md +0 -237
- package/dist/registry/ai-manager-rules/implement-phases/implement-spike.md +0 -121
- package/dist/registry/ai-manager-rules/implement-phases/implement-validate.md +0 -375
- package/dist/registry/ai-manager-rules/implement-phases/quality-review.md +0 -304
- package/dist/registry/ai-manager-rules/implement-phases/regression.md +0 -159
- package/dist/registry/ai-manager-rules/implement-phases/repro.md +0 -101
- package/dist/registry/ai-manager-rules/implement-phases/scoping.md +0 -93
- package/dist/registry/ai-manager-rules/implement-phases/smoke.md +0 -225
- package/dist/registry/ai-manager-rules/implement-phases/spike.md +0 -118
- package/dist/registry/ai-manager-rules/implement-phases/validate.md +0 -347
- package/dist/registry/ai-manager-rules/implement.json +0 -153
- package/dist/registry/ai-manager-rules/retrospective.md +0 -116
- package/dist/registry/ai-manager-rules/shared-phases/address-pr-feedback.md +0 -188
- package/dist/registry/ai-manager-rules/shared-phases/finalize.md +0 -169
- package/dist/registry/ai-manager-rules/shared-phases/submit-pr.md +0 -202
- package/dist/registry/ai-manager-rules/shared-phases/wait-for-pr-review.md +0 -170
- package/dist/registry/ai-manager-rules/spec-phases/finalize.md +0 -60
- package/dist/registry/ai-manager-rules/spec-phases/spec-competitor-analysis.md +0 -105
- package/dist/registry/ai-manager-rules/spec-phases/spec-completeness-review.md +0 -66
- package/dist/registry/ai-manager-rules/spec-phases/spec-spec.md +0 -139
- package/dist/registry/ai-manager-rules/spec-phases/spec.md +0 -102
- package/dist/registry/ai-manager-rules/spec-phases/validate.md +0 -118
- package/dist/registry/ai-manager-rules/spec.json +0 -112
- package/dist/registry/ai-manager-rules/test.json +0 -98
- package/dist/registry/ai-manager-rules/user-survey-phases/phase1-survey-scoping.md +0 -60
- package/dist/registry/ai-manager-rules/user-survey-phases/phase2-survey-build-linkedin.md +0 -23
- package/dist/registry/ai-manager-rules/user-survey-phases/phase3-survey-build-reddit.md +0 -22
- package/dist/registry/ai-manager-rules/user-survey-phases/phase4-survey-build-x.md +0 -21
- package/dist/registry/ai-manager-rules/user-survey-phases/phase5-survey-build-facebook.md +0 -19
- package/dist/registry/ai-manager-rules/user-survey-phases/phase6-survey-build-custom.md +0 -15
- package/dist/registry/ai-manager-rules/user-survey-phases/phase7-survey-dispatch.md +0 -45
- package/dist/registry/delivery/address-feedback.md +0 -83
- package/dist/registry/delivery/retrospective.md +0 -78
- package/dist/registry/delivery/submit.md +0 -79
- package/dist/registry/providers/ado.json +0 -19
- package/dist/registry/providers/delivery-conversation.json +0 -9
- package/dist/registry/providers/delivery-pr.json +0 -9
- package/dist/registry/providers/github.json +0 -19
- package/dist/registry/rules/agent-success-criteria.md +0 -101
- package/dist/registry/rules/agent-testing-guidelines.md +0 -502
- package/dist/registry/rules/architecture.md +0 -126
- package/dist/registry/rules/communication.md +0 -122
- package/dist/registry/rules/continuous-learning.md +0 -55
- package/dist/registry/rules/debugging-multitenancy-issues.md +0 -85
- package/dist/registry/rules/ephemeral-execution.md +0 -54
- package/dist/registry/rules/git-safe-commands.md +0 -34
- package/dist/registry/rules/hitl-ppe-record-analysis.md +0 -302
- package/dist/registry/rules/integrity-and-test-ethics.md +0 -275
- package/dist/registry/rules/local-development.md +0 -275
- package/dist/registry/rules/mandatory-pre-completion-reflection.md +0 -193
- package/dist/registry/rules/merge-requirements.md +0 -238
- package/dist/registry/rules/simplicity.md +0 -118
- package/dist/registry/rules/software-development-lifecycle.md +0 -105
- package/dist/registry/rules/spike-first-development.md +0 -205
- package/dist/registry/rules/successful-debugging-patterns.md +0 -488
- package/dist/registry/scripts/build-scripts-generator.js +0 -205
- package/dist/registry/scripts/cleanup-branch.js +0 -287
- package/dist/registry/scripts/evaluate-code-quality.js +0 -66
- package/dist/registry/scripts/exec-with-timeout.js +0 -142
- package/dist/registry/scripts/fraim-config.js +0 -61
- package/dist/registry/scripts/generate-engagement-emails.js +0 -705
- package/dist/registry/scripts/generic-issues-api.js +0 -100
- package/dist/registry/scripts/newsletter-helpers.js +0 -671
- package/dist/registry/scripts/openapi-generator.js +0 -664
- package/dist/registry/scripts/performance/profile-server.js +0 -390
- package/dist/registry/scripts/profile-server.js +0 -389
- package/dist/registry/scripts/run-thank-you-workflow.js +0 -92
- package/dist/registry/scripts/send-newsletter-simple.js +0 -85
- package/dist/registry/scripts/send-thank-you-emails.js +0 -54
- package/dist/registry/scripts/validate-openapi-limits.js +0 -311
- package/dist/registry/scripts/validate-test-coverage.js +0 -262
- package/dist/registry/scripts/verify-test-coverage.js +0 -66
- package/dist/registry/stubs/workflows/azure/cost-optimization.md +0 -11
- package/dist/registry/stubs/workflows/bootstrap/create-architecture.md +0 -11
- package/dist/registry/stubs/workflows/bootstrap/detect-broken-windows.md +0 -11
- package/dist/registry/stubs/workflows/bootstrap/evaluate-code-quality.md +0 -11
- package/dist/registry/stubs/workflows/bootstrap/verify-test-coverage.md +0 -11
- package/dist/registry/stubs/workflows/brainstorming/blue-sky-brainstorming.md +0 -11
- package/dist/registry/stubs/workflows/brainstorming/codebase-brainstorming.md +0 -11
- package/dist/registry/stubs/workflows/business-development/create-business-plan.md +0 -11
- package/dist/registry/stubs/workflows/business-development/ideate-business-opportunity.md +0 -11
- package/dist/registry/stubs/workflows/business-development/price-product.md +0 -18
- package/dist/registry/stubs/workflows/compliance/detect-compliance-requirements.md +0 -11
- package/dist/registry/stubs/workflows/compliance/generate-audit-evidence.md +0 -11
- package/dist/registry/stubs/workflows/compliance/soc2-evidence-generator.md +0 -11
- package/dist/registry/stubs/workflows/customer-development/insight-analysis.md +0 -11
- package/dist/registry/stubs/workflows/customer-development/insight-triage.md +0 -11
- package/dist/registry/stubs/workflows/customer-development/interview-preparation.md +0 -11
- package/dist/registry/stubs/workflows/customer-development/linkedin-outreach.md +0 -11
- package/dist/registry/stubs/workflows/customer-development/strategic-brainstorming.md +0 -11
- package/dist/registry/stubs/workflows/customer-development/thank-customers.md +0 -11
- package/dist/registry/stubs/workflows/customer-development/user-survey-dispatch.md +0 -11
- package/dist/registry/stubs/workflows/customer-development/users-to-target.md +0 -11
- package/dist/registry/stubs/workflows/customer-development/weekly-newsletter.md +0 -11
- package/dist/registry/stubs/workflows/deploy/cloud-deployment.md +0 -11
- package/dist/registry/stubs/workflows/improve-fraim/contribute.md +0 -11
- package/dist/registry/stubs/workflows/improve-fraim/file-issue.md +0 -11
- package/dist/registry/stubs/workflows/learning/build-skillset.md +0 -11
- package/dist/registry/stubs/workflows/learning/synthesize-learnings.md +0 -11
- package/dist/registry/stubs/workflows/legal/contract-review-analysis.md +0 -11
- package/dist/registry/stubs/workflows/legal/nda.md +0 -11
- package/dist/registry/stubs/workflows/legal/patent-filing.md +0 -11
- package/dist/registry/stubs/workflows/legal/saas-contract-development.md +0 -11
- package/dist/registry/stubs/workflows/legal/trademark-filing.md +0 -11
- package/dist/registry/stubs/workflows/marketing/content-creation.md +0 -11
- package/dist/registry/stubs/workflows/marketing/convert-to-pdf.md +0 -11
- package/dist/registry/stubs/workflows/marketing/create-modern-website.md +0 -11
- package/dist/registry/stubs/workflows/marketing/domain-registration.md +0 -11
- package/dist/registry/stubs/workflows/marketing/evangelize.md +0 -11
- package/dist/registry/stubs/workflows/marketing/hbr-article.md +0 -11
- package/dist/registry/stubs/workflows/marketing/launch-checklist.md +0 -11
- package/dist/registry/stubs/workflows/marketing/marketing-strategy.md +0 -11
- package/dist/registry/stubs/workflows/marketing/storytelling.md +0 -11
- package/dist/registry/stubs/workflows/performance/analyze-performance.md +0 -11
- package/dist/registry/stubs/workflows/product-building/design.md +0 -11
- package/dist/registry/stubs/workflows/product-building/implement.md +0 -11
- package/dist/registry/stubs/workflows/product-building/iterate-on-pr-comments.md +0 -11
- package/dist/registry/stubs/workflows/product-building/prep-issue.md +0 -11
- package/dist/registry/stubs/workflows/product-building/prototype.md +0 -11
- package/dist/registry/stubs/workflows/product-building/resolve.md +0 -11
- package/dist/registry/stubs/workflows/product-building/retrospect.md +0 -11
- package/dist/registry/stubs/workflows/product-building/spec.md +0 -11
- package/dist/registry/stubs/workflows/product-building/test.md +0 -11
- package/dist/registry/stubs/workflows/productivity-report/productivity-report.md +0 -11
- package/dist/registry/stubs/workflows/quality-assurance/browser-validation.md +0 -11
- package/dist/registry/stubs/workflows/quality-assurance/iterative-improvement-cycle.md +0 -11
- package/dist/registry/stubs/workflows/replicate/replicate-discovery.md +0 -11
- package/dist/registry/stubs/workflows/replicate/replicate-to-issues.md +0 -11
- package/dist/registry/stubs/workflows/reviewer/review-implementation-vs-design-spec.md +0 -11
- package/dist/registry/stubs/workflows/reviewer/review-implementation-vs-feature-spec.md +0 -11
- package/dist/registry/stubs/workflows/startup-credits/aws-activate-application.md +0 -11
- package/dist/registry/stubs/workflows/startup-credits/google-cloud-application.md +0 -11
- package/dist/registry/stubs/workflows/startup-credits/microsoft-azure-application.md +0 -11
- package/dist/registry/templates/bootstrap/ARCHITECTURE-TEMPLATE.md +0 -53
- package/dist/registry/templates/bootstrap/CODE-QUALITY-REPORT-TEMPLATE.md +0 -37
- package/dist/registry/templates/bootstrap/TEST-COVERAGE-REPORT-TEMPLATE.md +0 -35
- package/dist/registry/templates/business-development/IDEATION-REPORT-TEMPLATE.md +0 -29
- package/dist/registry/templates/business-development/PRICING-STRATEGY-TEMPLATE.md +0 -126
- package/dist/registry/templates/customer-development/customer-interview-template.md +0 -99
- package/dist/registry/templates/customer-development/customer-persona-template.md +0 -69
- package/dist/registry/templates/customer-development/follow-up-email-templates.md +0 -132
- package/dist/registry/templates/customer-development/insight-analysis-template.md +0 -74
- package/dist/registry/templates/customer-development/prospect-inventory-template.csv +0 -3
- package/dist/registry/templates/customer-development/search-strategy-template.md +0 -123
- package/dist/registry/templates/customer-development/strategic-recommendations-template.md +0 -53
- package/dist/registry/templates/customer-development/thank-you-email-template.html +0 -124
- package/dist/registry/templates/customer-development/thank-you-note-template.md +0 -16
- package/dist/registry/templates/customer-development/triage-log-template.md +0 -278
- package/dist/registry/templates/customer-development/weekly-newsletter-template.html +0 -204
- package/dist/registry/templates/evidence/Design-Evidence.md +0 -30
- package/dist/registry/templates/evidence/Implementation-BugEvidence.md +0 -122
- package/dist/registry/templates/evidence/Implementation-FeatureEvidence.md +0 -160
- package/dist/registry/templates/evidence/Spec-Evidence.md +0 -19
- package/dist/registry/templates/help/HelpNeeded.md +0 -14
- package/dist/registry/templates/legal/NDA-TEMPLATE.md +0 -170
- package/dist/registry/templates/legal/PATENT-TEMPLATE.md +0 -372
- package/dist/registry/templates/legal/TRADEMARK-TEMPLATE.md +0 -339
- package/dist/registry/templates/legal/contract-review-checklist.md +0 -193
- package/dist/registry/templates/legal/review-report-template.md +0 -198
- package/dist/registry/templates/legal/saas-terms-template.md +0 -174
- package/dist/registry/templates/legal/sow-template.md +0 -117
- package/dist/registry/templates/legal/template-variables.md +0 -131
- package/dist/registry/templates/marketing/DOMAIN-REGISTRATION-TEMPLATE.md +0 -194
- package/dist/registry/templates/marketing/EVANGELIZE-TEMPLATE.md +0 -102
- package/dist/registry/templates/marketing/HBR-ARTICLE-TEMPLATE.md +0 -66
- package/dist/registry/templates/marketing/STORYTELLING-TEMPLATE.md +0 -130
- package/dist/registry/templates/marketing/WEBSITE-TEMPLATE.md +0 -262
- package/dist/registry/templates/marketing/github-pages-workflow.yml +0 -64
- package/dist/registry/templates/replicate/implementation-checklist.md +0 -39
- package/dist/registry/templates/replicate/use-cases-template.md +0 -88
- package/dist/registry/templates/retrospective/RETROSPECTIVE-TEMPLATE.md +0 -55
- package/dist/registry/templates/specs/BUGSPEC-TEMPLATE.md +0 -37
- package/dist/registry/templates/specs/FEATURESPEC-TEMPLATE.md +0 -66
- package/dist/registry/templates/specs/TECHSPEC-TEMPLATE.md +0 -39
- package/dist/registry/workflows/azure/cost-optimization.md +0 -772
- package/dist/registry/workflows/bootstrap/create-architecture.md +0 -37
- package/dist/registry/workflows/bootstrap/detect-broken-windows.md +0 -300
- package/dist/registry/workflows/bootstrap/evaluate-code-quality.md +0 -35
- package/dist/registry/workflows/bootstrap/verify-test-coverage.md +0 -36
- package/dist/registry/workflows/brainstorming/blue-sky-brainstorming.md +0 -211
- package/dist/registry/workflows/brainstorming/codebase-brainstorming.md +0 -159
- package/dist/registry/workflows/business-development/create-business-plan.md +0 -737
- package/dist/registry/workflows/business-development/ideate-business-opportunity.md +0 -55
- package/dist/registry/workflows/business-development/price-product.md +0 -325
- package/dist/registry/workflows/compliance/detect-compliance-requirements.md +0 -80
- package/dist/registry/workflows/compliance/generate-audit-evidence.md +0 -80
- package/dist/registry/workflows/compliance/soc2-evidence-generator.md +0 -332
- package/dist/registry/workflows/customer-development/insight-analysis.md +0 -156
- package/dist/registry/workflows/customer-development/insight-triage.md +0 -933
- package/dist/registry/workflows/customer-development/interview-preparation.md +0 -452
- package/dist/registry/workflows/customer-development/linkedin-outreach.md +0 -599
- package/dist/registry/workflows/customer-development/strategic-brainstorming.md +0 -146
- package/dist/registry/workflows/customer-development/thank-customers.md +0 -203
- package/dist/registry/workflows/customer-development/user-survey-dispatch.md +0 -312
- package/dist/registry/workflows/customer-development/users-to-target.md +0 -427
- package/dist/registry/workflows/customer-development/weekly-newsletter.md +0 -366
- package/dist/registry/workflows/deploy/cloud-deployment.md +0 -310
- package/dist/registry/workflows/improve-fraim/contribute.md +0 -32
- package/dist/registry/workflows/improve-fraim/file-issue.md +0 -32
- package/dist/registry/workflows/learning/build-skillset.md +0 -212
- package/dist/registry/workflows/learning/synthesize-learnings.md +0 -369
- package/dist/registry/workflows/legal/contract-review-analysis.md +0 -382
- package/dist/registry/workflows/legal/nda.md +0 -69
- package/dist/registry/workflows/legal/patent-filing.md +0 -76
- package/dist/registry/workflows/legal/saas-contract-development.md +0 -204
- package/dist/registry/workflows/legal/trademark-filing.md +0 -77
- package/dist/registry/workflows/marketing/content-creation.md +0 -40
- package/dist/registry/workflows/marketing/convert-to-pdf.md +0 -265
- package/dist/registry/workflows/marketing/create-modern-website.md +0 -456
- package/dist/registry/workflows/marketing/domain-registration.md +0 -323
- package/dist/registry/workflows/marketing/evangelize.md +0 -426
- package/dist/registry/workflows/marketing/hbr-article.md +0 -73
- package/dist/registry/workflows/marketing/launch-checklist.md +0 -37
- package/dist/registry/workflows/marketing/marketing-strategy.md +0 -45
- package/dist/registry/workflows/marketing/storytelling.md +0 -65
- package/dist/registry/workflows/performance/analyze-performance.md +0 -65
- package/dist/registry/workflows/product-building/design.md +0 -263
- package/dist/registry/workflows/product-building/implement.md +0 -771
- package/dist/registry/workflows/product-building/iterate-on-pr-comments.md +0 -70
- package/dist/registry/workflows/product-building/prep-issue.md +0 -41
- package/dist/registry/workflows/product-building/prototype.md +0 -60
- package/dist/registry/workflows/product-building/resolve.md +0 -175
- package/dist/registry/workflows/product-building/retrospect.md +0 -86
- package/dist/registry/workflows/product-building/spec.md +0 -303
- package/dist/registry/workflows/product-building/test.md +0 -125
- package/dist/registry/workflows/productivity-report/productivity-report.md +0 -263
- package/dist/registry/workflows/quality-assurance/browser-validation.md +0 -221
- package/dist/registry/workflows/quality-assurance/iterative-improvement-cycle.md +0 -562
- package/dist/registry/workflows/replicate/replicate-discovery.md +0 -336
- package/dist/registry/workflows/replicate/replicate-to-issues.md +0 -319
- package/dist/registry/workflows/reviewer/review-implementation-vs-design-spec.md +0 -694
- package/dist/registry/workflows/reviewer/review-implementation-vs-feature-spec.md +0 -734
- package/dist/registry/workflows/startup-credits/aws-activate-application.md +0 -535
- package/dist/registry/workflows/startup-credits/google-cloud-application.md +0 -647
- package/dist/registry/workflows/startup-credits/microsoft-azure-application.md +0 -538
- package/dist/src/cli/commands/init.js +0 -148
- package/dist/src/cli/commands/mcp.js +0 -65
- package/dist/src/cli/commands/wizard.js +0 -35
- package/dist/src/fraim/issue-tracking/ado-provider.js +0 -304
- package/dist/src/fraim/issue-tracking/factory.js +0 -63
- package/dist/src/fraim/issue-tracking/github-provider.js +0 -200
- package/dist/src/fraim/issue-tracking/types.js +0 -7
- package/dist/src/fraim/issue-tracking-config.js +0 -83
- package/dist/src/fraim/retrospective-learner.js +0 -301
- 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.
|