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