fraim-framework 2.0.36 → 2.0.37

package/registry/scripts/verify-pr-comments.sh

@@ -1,70 +1,70 @@
-#!/bin/bash
-# verify-pr-comments.sh
-# Ensures agents properly retrieve and address PR comments
-
-set -e
-
-PR_NUMBER=$1
-
-# Load repository config from config.json
-CONFIG_FILE=".fraim/config.json"
-if [ ! -f "$CONFIG_FILE" ]; then
-    echo "Error: Config file not found at $CONFIG_FILE" >&2
-    exit 1
-fi
-
-if ! command -v node &> /dev/null; then
-    echo "Error: node is required but not installed." >&2
-    exit 1
-fi
-
-# Extract values using node reading from stdin
-NODE_SCRIPT="
-const fs = require('fs');
-try {
-    const input = fs.readFileSync(0, 'utf-8');
-    const config = JSON.parse(input);
-    const repo = config.git;
-    if (!repo || !repo.repoOwner || !repo.repoName) {
-        process.exit(1);
-    }
-    console.log(\`\${repo.repoOwner}:\${repo.repoName}\`);
-} catch (e) {
-    process.exit(1);
-}
-"
-
-REPO_INFO=$(cat "$CONFIG_FILE" | node -e "$NODE_SCRIPT")
-if [ $? -ne 0 ]; then
-    echo "Error: Failed to parse repository config from $CONFIG_FILE" >&2
-    echo "Required: git.repoOwner, git.repoName" >&2
-    exit 1
-fi
-
-IFS=':' read -r REPO_OWNER REPO_NAME <<< "$REPO_INFO"
-
-if [ -z "$PR_NUMBER" ]; then
-    echo "❌ ERROR: PR number required"
-    echo "Usage: $0 <PR_NUMBER>"
-    exit 1
-fi
-
-echo "🔍 Verifying PR comment processing for #$PR_NUMBER ($REPO_OWNER/$REPO_NAME)"
-
-# Get all comments
-gh api "repos/$REPO_OWNER/$REPO_NAME/pulls/$PR_NUMBER/comments?per_page=100" \
-  --jq '.[] | "[\(.id)] \(.path // "pr"):\(.line // "general") - \(.body)"' \
-  > pr-comments-verification.txt
-
-COMMENT_COUNT=$(wc -l < pr-comments-verification.txt)
-echo "📋 Found $COMMENT_COUNT comments"
-echo "📄 Comments saved to pr-comments-verification.txt"
-
-if [ "$COMMENT_COUNT" -eq 0 ]; then
-    echo "✅ No comments found - agent can proceed"
-    exit 0
-fi
-
-echo ""
-echo "⚠️  Agent MUST address each comment before claiming completion"
-echo "📝 Agent must provide evidence table showing resolution of all $COMMENT_COUNT comments"
+#!/bin/bash
+# verify-pr-comments.sh
+# Ensures agents properly retrieve and address PR comments
+
+set -e
+
+PR_NUMBER=$1
+
+# Load repository config from config.json
+CONFIG_FILE=".fraim/config.json"
+if [ ! -f "$CONFIG_FILE" ]; then
+    echo "Error: Config file not found at $CONFIG_FILE" >&2
+    exit 1
+fi
+
+if ! command -v node &> /dev/null; then
+    echo "Error: node is required but not installed." >&2
+    exit 1
+fi
+
+# Extract values using node reading from stdin
+NODE_SCRIPT="
+const fs = require('fs');
+try {
+    const input = fs.readFileSync(0, 'utf-8');
+    const config = JSON.parse(input);
+    const repo = config.git;
+    if (!repo || !repo.repoOwner || !repo.repoName) {
+        process.exit(1);
+    }
+    console.log(\`\${repo.repoOwner}:\${repo.repoName}\`);
+} catch (e) {
+    process.exit(1);
+}
+"
+
+REPO_INFO=$(cat "$CONFIG_FILE" | node -e "$NODE_SCRIPT")
+if [ $? -ne 0 ]; then
+    echo "Error: Failed to parse repository config from $CONFIG_FILE" >&2
+    echo "Required: git.repoOwner, git.repoName" >&2
+    exit 1
+fi
+
+IFS=':' read -r REPO_OWNER REPO_NAME <<< "$REPO_INFO"
+
+if [ -z "$PR_NUMBER" ]; then
+    echo "❌ ERROR: PR number required"
+    echo "Usage: $0 <PR_NUMBER>"
+    exit 1
+fi
+
+echo "🔍 Verifying PR comment processing for #$PR_NUMBER ($REPO_OWNER/$REPO_NAME)"
+
+# Get all comments
+gh api "repos/$REPO_OWNER/$REPO_NAME/pulls/$PR_NUMBER/comments?per_page=100" \
+  --jq '.[] | "[\(.id)] \(.path // "pr"):\(.line // "general") - \(.body)"' \
+  > pr-comments-verification.txt
+
+COMMENT_COUNT=$(wc -l < pr-comments-verification.txt)
+echo "📋 Found $COMMENT_COUNT comments"
+echo "📄 Comments saved to pr-comments-verification.txt"
+
+if [ "$COMMENT_COUNT" -eq 0 ]; then
+    echo "✅ No comments found - agent can proceed"
+    exit 0
+fi
+
+echo ""
+echo "⚠️  Agent MUST address each comment before claiming completion"
+echo "📝 Agent must provide evidence table showing resolution of all $COMMENT_COUNT comments"

package/registry/stubs/workflows/bootstrap/create-architecture.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: create-architecture
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("create-architecture")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+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.

package/registry/stubs/workflows/bootstrap/detect-broken-windows.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: detect-broken-windows
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("detect-broken-windows")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+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.

package/registry/stubs/workflows/bootstrap/evaluate-code-quality.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: evaluate-code-quality
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("evaluate-code-quality")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To perform a deep analysis of the codebase's quality, evaluating it against FRAIM's standards and generating a comprehensive health report.

package/registry/stubs/workflows/bootstrap/verify-test-coverage.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: verify-test-coverage
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("verify-test-coverage")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To verify the depth and effectiveness of the test suite by comparing actual test execution against the validation plans defined in specifications.

package/registry/stubs/workflows/business-development/create-business-plan.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: create-business-plan
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("create-business-plan")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To create a comprehensive go-to-market strategy document that identifies target market segments, analyzes market opportunity, defines growth mechanisms, and establishes competitive positioning. This workflow produces a single strategic document combining market research, growth strategy, and competitive analysis.

package/registry/stubs/workflows/business-development/ideate-business-opportunity.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: ideate-business-opportunity
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("ideate-business-opportunity")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To help founders and product owners navigate the broad, fuzzy front-end of product development. This workflow guides the transition from a "vague space" to "concrete feature deliverables" through interactive brainstorming and research.

package/registry/stubs/workflows/business-development/price-product.md

@@ -0,0 +1,18 @@
+# FRAIM Workflow: price-product
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("price-product")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To create a comprehensive **pricing + packaging strategy** for any product that:
+
+* clarifies who the product is for and what outcomes it delivers,
+* defines SKUs, tiers, add-ons, and the pricing metric,
+* ties pricing to unit economics and scalability,
+* and positions the product clearly against competitors and substitutes.
+
+---

package/registry/stubs/workflows/convert-to-pdf.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: convert-to-pdf
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("convert-to-pdf")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To provide agents with a reliable workflow for converting markdown files to professional PDF documents, enabling seamless document sharing and archival while maintaining formatting integrity and visual appeal.

package/registry/stubs/workflows/customer-development/insight-analysis.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: insight-analysis
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("insight-analysis")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To help Product Managers extract, structure, and analyze customer insights from interview notes, enabling data-driven product decisions and systematic customer relationship management.

package/registry/stubs/workflows/customer-development/insight-triage.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: insight-triage
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("insight-triage")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To systematically convert customer pain points, feature requests, and insights from interview analysis documents into prioritized GitHub issues, ensuring customer needs drive product development while maintaining traceability from customer to implementation.

package/registry/stubs/workflows/customer-development/interview-preparation.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: interview-preparation
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("interview-preparation")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To help Product Managers prepare for customer interviews by researching specific customers, personalizing questions, and creating structured interview templates that maximize learning and relationship building.

package/registry/stubs/workflows/customer-development/linkedin-outreach.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: linkedin-outreach
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("linkedin-outreach")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To help founders and executives generate personalized LinkedIn outreach messages by researching profiles, identifying connection paths, finding conversation hooks, and combining them with the user's outreach intent.

package/registry/stubs/workflows/customer-development/strategic-brainstorming.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: strategic-brainstorming
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("strategic-brainstorming")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To help Product Managers brainstorm and validate their customer development strategy through deep thinking, assumption challenging, and market research to identify the right customer segments and validation questions.

package/registry/stubs/workflows/customer-development/thank-customers.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: thank-customers
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("thank-customers")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To automatically generate and send personalized thank you emails to customers whose feedback has been implemented, strengthening customer relationships and encouraging continued engagement.

package/registry/stubs/workflows/customer-development/weekly-newsletter.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: weekly-newsletter
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("weekly-newsletter")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To generate and distribute a compelling weekly newsletter that showcases the AI Agent's amazing new features and improvements, creating excitement among current users and FOMO for subscribers who haven't joined yet.

package/registry/stubs/workflows/deploy/cloud-deployment.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: cloud-deployment
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("cloud-deployment")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+No intent defined.

package/registry/stubs/workflows/improve-fraim/contribute.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: contribute
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("contribute")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+Allows users to contribute new workflow ideas back to the FRAIM project. The agent collects necessary information and files a GitHub issue with the contribution details.

package/registry/stubs/workflows/improve-fraim/file-issue.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: file-issue
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("file-issue")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+Allows users to easily file bugs or feature requests for the FRAIM framework directly from their working environment.

package/registry/stubs/workflows/marketing/content-creation.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: content-creation
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("content-creation")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To produce high-quality marketing assets, including blog posts, social media content, and email campaigns, that effectively communicate the feature's value.

package/registry/stubs/workflows/marketing/hbr-article.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: hbr-article
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("hbr-article")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+Design a repeatable reviewable process for researching, drafting, and submitting an HBR or similar thought-leadership article that follows the Harvard Business Review author guidelines and documents each review before publication.

package/registry/stubs/workflows/marketing/launch-checklist.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: launch-checklist
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("launch-checklist")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To ensure a smooth and successful feature launch by systematically verifying all marketing, technical, and operational readiness.

package/registry/stubs/workflows/marketing/marketing-strategy.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: marketing-strategy
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("marketing-strategy")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To define the value proposition, target audience, and launch strategy for new features, ensuring clear communication of benefits and effective market entry.

package/registry/stubs/workflows/marketing/storytelling.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: storytelling
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("storytelling")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To transform product development experiences into compelling founder narratives for events, conferences, and speaking opportunities that connect technical reality with broadly applicable lessons.

package/registry/stubs/workflows/performance/analyze-performance.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: analyze-performance
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("analyze-performance")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To diagnose production performance issues (CPU, Memory, Swap) and provide actionable recommendations for stabilization without performing direct application or infrastructure modifications.

package/registry/stubs/workflows/product-building/design.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: design
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("design")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To create comprehensive, detailed technical design documents that plan solutions before implementation, ensuring proper architecture, clear requirements, and stakeholder alignment through structured RFCs and bug fix templates.

package/registry/stubs/workflows/product-building/implement.md

@@ -0,0 +1,12 @@
+# FRAIM Workflow: implement
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("implement")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To implement solutions based on approved design documents, ensuring minimal, testable code that meets requirements while following established patterns and maintaining code quality.
+Consult the architecture document for coding standards.

package/registry/stubs/workflows/product-building/iterate-on-pr-comments.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: iterate-on-pr-comments
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("iterate-on-pr-comments")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To ensure AI agents autonomously handle the complete PR lifecycle with proper monitoring, feedback handling, and testing, eliminating gaps that require human intervention.

package/registry/stubs/workflows/product-building/prep-issue.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: prep-issue
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("prep-issue")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+No intent defined.

package/registry/stubs/workflows/product-building/prototype.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: prototype
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("prototype")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To quickly explore ideas, validate technologies, or prove concepts using "spike" code. Speed and learning are prioritized over code quality and tests.

package/registry/stubs/workflows/product-building/resolve.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: resolve
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("resolve")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To provide a systematic approach to resolving issues from development through merge verification and cleanup, ensuring no work is lost and all changes are properly integrated into the main codebase.

package/registry/stubs/workflows/product-building/retrospect.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: retrospect
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("retrospect")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To capture learnings and insights from completed issues, enabling continuous improvement and preventing future similar problems through systematic analysis and documentation.

package/registry/stubs/workflows/product-building/spec.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: spec
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("spec")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To create comprehensive, detailed product specifications that clarify the Why, What and User Experiences for new features.

package/registry/stubs/workflows/product-building/test.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: test
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("test")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To create comprehensive test coverage that accurately reproduces issues and validates solutions, ensuring robust testing through proper test structure, failure verification, and systematic test execution.

package/registry/stubs/workflows/quality-assurance/browser-validation.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: browser-validation
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("browser-validation")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To systematically validate the application in a browser, identify issues, and iterate until production-ready through comprehensive browser testing.

package/registry/stubs/workflows/quality-assurance/iterative-improvement-cycle.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: iterative-improvement-cycle
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("iterative-improvement-cycle")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To systematically improve application quality through iterative cycles of Review → Critique → Fix → Validate, ensuring high-quality, production-ready applications.

package/registry/stubs/workflows/replicate/replicate-discovery.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: replicate-discovery
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("replicate-discovery")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To systematically discover, analyze, and document an existing web application for replication, producing a complete analysis package that can be converted into implementation issues.

package/registry/stubs/workflows/replicate/replicate-to-issues.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: replicate-to-issues
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("replicate-to-issues")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To convert comprehensive replication analysis into actionable GitHub issues that can be implemented through standard FRAIM workflows (spec → design → implement → test).

package/registry/stubs/workflows/reviewer/review-implementation-vs-design-spec.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: review-implementation-vs-design-spec
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("review-implementation-vs-design-spec")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To systematically verify that the implementation matches the approved technical design (RFC), ensuring all technical requirements, test cases, and validation scenarios are complete.