fraim-framework 2.0.52 → 2.0.55

package/dist/tests/test-users-to-target-workflow.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * Comprehensive tests for Users to Target workflow
+ * Tests the complete customer discovery workflow including:
+ * - Phase loading and validation
+ * - Template file accessibility
+ * - AI coach phase content validation
+ * - Output directory structure
+ * - CSV template format validation
+ * - Browser automation integration points
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+(0, node_test_1.describe)('Users to Target Workflow', () => {
+    const workflowPath = 'registry/workflows/customer-development';
+    const mainWorkflowFile = (0, path_1.join)(workflowPath, 'users-to-target.md');
+    const templatesPath = (0, path_1.join)(workflowPath, 'templates');
+    const aiCoachPhasesPath = (0, path_1.join)(workflowPath, 'ai-coach-phases');
+    const outputPath = 'docs/customer-development';
+    (0, node_test_1.describe)('Workflow Structure', () => {
+        (0, node_test_1.it)('should have main workflow file', () => {
+            (0, node_assert_1.default)((0, fs_1.existsSync)(mainWorkflowFile), 'Main workflow file should exist');
+            const content = (0, fs_1.readFileSync)(mainWorkflowFile, 'utf-8');
+            (0, node_assert_1.default)(content.includes('# FRAIM Workflow: users-to-target'), 'Should have proper workflow header');
+            (0, node_assert_1.default)(content.includes('## Intent'), 'Should have intent section');
+            (0, node_assert_1.default)(content.includes('## Phases'), 'Should have phases section');
+            (0, node_assert_1.default)(content.includes('Phase 1: Customer Profiling'), 'Should include Phase 1');
+            (0, node_assert_1.default)(content.includes('Phase 2: Multi-Platform Discovery'), 'Should include Phase 2');
+            (0, node_assert_1.default)(content.includes('Phase 3: Prospect Qualification'), 'Should include Phase 3');
+            (0, node_assert_1.default)(content.includes('Phase 4: Inventory Compilation'), 'Should include Phase 4');
+        });
+        (0, node_test_1.it)('should have all required template files', () => {
+            const requiredTemplates = [
+                'customer-persona-template.md',
+                'search-strategy-template.md',
+                'prospect-inventory-template.csv'
+            ];
+            requiredTemplates.forEach(template => {
+                const templatePath = (0, path_1.join)(templatesPath, template);
+                (0, node_assert_1.default)((0, fs_1.existsSync)(templatePath), `Template ${template} should exist`);
+            });
+        });
+        (0, node_test_1.it)('should have all AI coach phase files', () => {
+            const requiredPhases = [
+                'phase1-customer-profiling.md',
+                'phase2-platform-discovery.md',
+                'phase3-prospect-qualification.md',
+                'phase4-inventory-compilation.md'
+            ];
+            requiredPhases.forEach(phase => {
+                const phasePath = (0, path_1.join)(aiCoachPhasesPath, phase);
+                (0, node_assert_1.default)((0, fs_1.existsSync)(phasePath), `Phase file ${phase} should exist`);
+            });
+        });
+    });
+    (0, node_test_1.describe)('Template Content Validation', () => {
+        (0, node_test_1.it)('should have properly structured customer persona template', () => {
+            const templatePath = (0, path_1.join)(templatesPath, 'customer-persona-template.md');
+            const content = (0, fs_1.readFileSync)(templatePath, 'utf-8');
+            // Check required sections
+            (0, node_assert_1.default)(content.includes('## Basic Information'), 'Should have Basic Information section');
+            (0, node_assert_1.default)(content.includes('## Demographics'), 'Should have Demographics section');
+            (0, node_assert_1.default)(content.includes('## Pain Points & Challenges'), 'Should have Pain Points section');
+            (0, node_assert_1.default)(content.includes('## Search Keywords'), 'Should have Search Keywords section');
+            (0, node_assert_1.default)(content.includes('### LinkedIn Keywords'), 'Should have LinkedIn keywords section');
+            (0, node_assert_1.default)(content.includes('### Reddit Keywords'), 'Should have Reddit keywords section');
+            (0, node_assert_1.default)(content.includes('### X (Twitter) Keywords'), 'Should have Twitter keywords section');
+            (0, node_assert_1.default)(content.includes('## Qualification Criteria'), 'Should have qualification criteria');
+        });
+        (0, node_test_1.it)('should have properly structured search strategy template', () => {
+            const templatePath = (0, path_1.join)(templatesPath, 'search-strategy-template.md');
+            const content = (0, fs_1.readFileSync)(templatePath, 'utf-8');
+            // Check platform strategies
+            (0, node_assert_1.default)(content.includes('### LinkedIn Strategy'), 'Should have LinkedIn strategy');
+            (0, node_assert_1.default)(content.includes('### Reddit Strategy'), 'Should have Reddit strategy');
+            (0, node_assert_1.default)(content.includes('### X (Twitter) Strategy'), 'Should have Twitter strategy');
+            (0, node_assert_1.default)(content.includes('### Facebook Strategy'), 'Should have Facebook strategy');
+            (0, node_assert_1.default)(content.includes('### Forum Strategy'), 'Should have Forum strategy');
+            (0, node_assert_1.default)(content.includes('### Web Search Strategy'), 'Should have Web Search strategy');
+            (0, node_assert_1.default)(content.includes('## Success Metrics per Platform'), 'Should have success metrics');
+        });
+        (0, node_test_1.it)('should have properly formatted CSV template', () => {
+            const templatePath = (0, path_1.join)(templatesPath, 'prospect-inventory-template.csv');
+            const content = (0, fs_1.readFileSync)(templatePath, 'utf-8');
+            // Check required CSV columns
+            const requiredColumns = [
+                'Name', 'Platform Found', 'Profile URL', 'Contact Information',
+                'Pain Points Identified', 'Relevance Score', 'Discovery Context',
+                'Follow-up Priority', 'Notes', 'Date Found', 'Industry',
+                'Job Title', 'Company', 'Location', 'Engagement Level'
+            ];
+            const headerLine = content.split('\n')[0];
+            requiredColumns.forEach(column => {
+                (0, node_assert_1.default)(headerLine.includes(column), `CSV should include ${column} column`);
+            });
+            // Should have at least 2 sample rows
+            const lines = content.split('\n').filter(line => line.trim());
+            (0, node_assert_1.default)(lines.length >= 3, 'CSV should have header + at least 2 sample rows');
+        });
+    });
+    (0, node_test_1.describe)('AI Coach Phase Content', () => {
+        (0, node_test_1.it)('should have comprehensive Phase 1 coaching content', () => {
+            const phasePath = (0, path_1.join)(aiCoachPhasesPath, 'phase1-customer-profiling.md');
+            const content = (0, fs_1.readFileSync)(phasePath, 'utf-8');
+            (0, node_assert_1.default)(content.includes('## Objective'), 'Should have objective');
+            (0, node_assert_1.default)(content.includes('## Key Questions to Ask'), 'Should have coaching questions');
+            (0, node_assert_1.default)(content.includes('### Understanding the Business'), 'Should have business questions');
+            (0, node_assert_1.default)(content.includes('### Defining the Target Customer'), 'Should have customer questions');
+            (0, node_assert_1.default)(content.includes('### Identifying Pain Points'), 'Should have pain point questions');
+            (0, node_assert_1.default)(content.includes('## Validation Criteria'), 'Should have validation criteria');
+            (0, node_assert_1.default)(content.includes('## Evidence Required'), 'Should have evidence requirements');
+            // Should have at least 15 coaching questions
+            const questionMatches = content.match(/^\d+\.\s*"/gm);
+            (0, node_assert_1.default)(questionMatches && questionMatches.length >= 15, 'Should have at least 15 coaching questions');
+        });
+        (0, node_test_1.it)('should have browser automation guidance in Phase 2', () => {
+            const phasePath = (0, path_1.join)(aiCoachPhasesPath, 'phase2-platform-discovery.md');
+            const content = (0, fs_1.readFileSync)(phasePath, 'utf-8');
+            // Check browser automation integration
+            (0, node_assert_1.default)(content.includes('mcp_playwright_browser_navigate'), 'Should reference Playwright navigation');
+            (0, node_assert_1.default)(content.includes('mcp_playwright_browser_snapshot'), 'Should reference Playwright snapshots');
+            (0, node_assert_1.default)(content.includes('mcp_playwright_browser_click'), 'Should reference Playwright clicking');
+            (0, node_assert_1.default)(content.includes('Authentication Check'), 'Should have authentication handling');
+            // Check platform coverage
+            (0, node_assert_1.default)(content.includes('LinkedIn'), 'Should cover LinkedIn');
+            (0, node_assert_1.default)(content.includes('Reddit'), 'Should cover Reddit');
+            (0, node_assert_1.default)(content.includes('X (Twitter)'), 'Should cover Twitter');
+            (0, node_assert_1.default)(content.includes('Facebook'), 'Should cover Facebook');
+            (0, node_assert_1.default)(content.includes('Industry Forum Search'), 'Should cover forums');
+            (0, node_assert_1.default)(content.includes('General Web Search'), 'Should cover web search');
+            // Check authentication prompts
+            (0, node_assert_1.default)(content.includes('Please log into'), 'Should have login prompts');
+            (0, node_assert_1.default)(content.includes('Type \'ready\''), 'Should have confirmation prompts');
+        });
+        (0, node_test_1.it)('should have scoring system in Phase 3', () => {
+            const phasePath = (0, path_1.join)(aiCoachPhasesPath, 'phase3-prospect-qualification.md');
+            const content = (0, fs_1.readFileSync)(phasePath, 'utf-8');
+            (0, node_assert_1.default)(content.includes('## Scoring System (1-10 Scale)'), 'Should have scoring system');
+            (0, node_assert_1.default)(content.includes('Pain Point Match'), 'Should have pain point scoring');
+            (0, node_assert_1.default)(content.includes('Authority/Influence'), 'Should have authority scoring');
+            (0, node_assert_1.default)(content.includes('Urgency'), 'Should have urgency scoring');
+            (0, node_assert_1.default)(content.includes('Accessibility'), 'Should have accessibility scoring');
+            (0, node_assert_1.default)(content.includes('Engagement Level'), 'Should have engagement scoring');
+            // Check qualification tiers
+            (0, node_assert_1.default)(content.includes('Tier 1'), 'Should have tier 1 prospects');
+            (0, node_assert_1.default)(content.includes('Tier 2'), 'Should have tier 2 prospects');
+            (0, node_assert_1.default)(content.includes('Score 35-50'), 'Should define high-score prospects');
+            (0, node_assert_1.default)(content.includes('Score 25-34'), 'Should define medium-score prospects');
+        });
+        (0, node_test_1.it)('should have CSV compilation guidance in Phase 4', () => {
+            const phasePath = (0, path_1.join)(aiCoachPhasesPath, 'phase4-inventory-compilation.md');
+            const content = (0, fs_1.readFileSync)(phasePath, 'utf-8');
+            (0, node_assert_1.default)(content.includes('## CSV Structure'), 'Should have CSV structure');
+            (0, node_assert_1.default)(content.includes('### Required Columns'), 'Should define required columns');
+            (0, node_assert_1.default)(content.includes('### Step 2: Priority Assignment'), 'Should have priority assignment');
+            (0, node_assert_1.default)(content.includes('High Priority'), 'Should define high priority');
+            (0, node_assert_1.default)(content.includes('Medium Priority'), 'Should define medium priority');
+            (0, node_assert_1.default)(content.includes('Low Priority'), 'Should define low priority');
+            // Check file naming
+            (0, node_assert_1.default)(content.includes('users-to-target-{timestamp}.csv'), 'Should have file naming convention');
+            (0, node_assert_1.default)(content.includes('docs/customer-development/'), 'Should specify output location');
+        });
+    });
+    (0, node_test_1.describe)('Workflow Integration Points', () => {
+        (0, node_test_1.it)('should specify browser automation requirements', () => {
+            const mainContent = (0, fs_1.readFileSync)(mainWorkflowFile, 'utf-8');
+            (0, node_assert_1.default)(mainContent.includes('Playwright MCP'), 'Should mention Playwright MCP requirement');
+            (0, node_assert_1.default)(mainContent.includes('Browser automation'), 'Should mention browser automation');
+        });
+        (0, node_test_1.it)('should define success metrics', () => {
+            const mainContent = (0, fs_1.readFileSync)(mainWorkflowFile, 'utf-8');
+            (0, node_assert_1.default)(mainContent.includes('50-200 qualified prospects'), 'Should define prospect quantity target');
+            (0, node_assert_1.default)(mainContent.includes('70%+ relevance score'), 'Should define quality target');
+            (0, node_assert_1.default)(mainContent.includes('60%+ of prospects'), 'Should define contact info target');
+        });
+        (0, node_test_1.it)('should reference all template files', () => {
+            const mainContent = (0, fs_1.readFileSync)(mainWorkflowFile, 'utf-8');
+            (0, node_assert_1.default)(mainContent.includes('customer-persona-template.md'), 'Should reference persona template');
+            (0, node_assert_1.default)(mainContent.includes('search-strategy-template.md'), 'Should reference strategy template');
+            (0, node_assert_1.default)(mainContent.includes('prospect-inventory-template.csv'), 'Should reference CSV template');
+        });
+        (0, node_test_1.it)('should reference AI coach integration', () => {
+            const mainContent = (0, fs_1.readFileSync)(mainWorkflowFile, 'utf-8');
+            (0, node_assert_1.default)(mainContent.includes('seekCoachingOnNextStep'), 'Should reference AI coach integration');
+            (0, node_assert_1.default)(mainContent.includes('customer-development'), 'Should specify customer-development workflow type');
+        });
+    });
+    (0, node_test_1.describe)('Output Validation', () => {
+        (0, node_test_1.it)('should specify correct output file format', () => {
+            const phase4Content = (0, fs_1.readFileSync)((0, path_1.join)(aiCoachPhasesPath, 'phase4-inventory-compilation.md'), 'utf-8');
+            (0, node_assert_1.default)(phase4Content.includes('users-to-target-{YYYY-MM-DD-HHMM}.csv'), 'Should specify timestamp format');
+            (0, node_assert_1.default)(phase4Content.includes('docs/customer-development/'), 'Should specify output directory');
+        });
+        (0, node_test_1.it)('should define minimum success criteria', () => {
+            const phase4Content = (0, fs_1.readFileSync)((0, path_1.join)(aiCoachPhasesPath, 'phase4-inventory-compilation.md'), 'utf-8');
+            (0, node_assert_1.default)(phase4Content.includes('50+ qualified prospects'), 'Should define minimum prospects');
+            (0, node_assert_1.default)(phase4Content.includes('70%+ relevance score'), 'Should define minimum relevance');
+            (0, node_assert_1.default)(phase4Content.includes('60%+ of prospects'), 'Should define minimum contact success');
+        });
+    });
+    (0, node_test_1.describe)('Error Handling and Edge Cases', () => {
+        (0, node_test_1.it)('should include authentication failure handling', () => {
+            const phase2Content = (0, fs_1.readFileSync)((0, path_1.join)(aiCoachPhasesPath, 'phase2-platform-discovery.md'), 'utf-8');
+            (0, node_assert_1.default)(phase2Content.includes('Authentication Failures'), 'Should handle auth failures');
+            (0, node_assert_1.default)(phase2Content.includes('Rate Limiting'), 'Should handle rate limiting');
+            (0, node_assert_1.default)(phase2Content.includes('Technical Issues'), 'Should handle technical issues');
+        });
+        (0, node_test_1.it)('should include qualification edge cases', () => {
+            const phase3Content = (0, fs_1.readFileSync)((0, path_1.join)(aiCoachPhasesPath, 'phase3-prospect-qualification.md'), 'utf-8');
+            (0, node_assert_1.default)(phase3Content.includes('Common Pitfalls'), 'Should identify common pitfalls');
+            (0, node_assert_1.default)(phase3Content.includes('Over-Qualification'), 'Should warn about over-qualification');
+            (0, node_assert_1.default)(phase3Content.includes('Under-Qualification'), 'Should warn about under-qualification');
+        });
+        (0, node_test_1.it)('should include data quality validation', () => {
+            const phase4Content = (0, fs_1.readFileSync)((0, path_1.join)(aiCoachPhasesPath, 'phase4-inventory-compilation.md'), 'utf-8');
+            (0, node_assert_1.default)(phase4Content.includes('Data Validation'), 'Should include data validation');
+            (0, node_assert_1.default)(phase4Content.includes('Quality Assurance'), 'Should include QA checklist');
+            (0, node_assert_1.default)(phase4Content.includes('Remove Duplicates'), 'Should handle duplicates');
+        });
+    });
+});
+/**
+ * Integration test that would require actual browser automation
+ * This test is commented out as it requires:
+ * - Playwright MCP server running
+ * - Valid social media accounts
+ * - Network connectivity
+ * - Longer execution time
+ */
+/*
+describe('Users to Target Integration Tests', () => {
+    it('should complete end-to-end workflow simulation', async () => {
+        // This would test:
+        // 1. Loading customer persona template
+        // 2. Simulating browser automation (with mocked responses)
+        // 3. Generating prospect data
+        // 4. Creating CSV output
+        // 5. Validating output format and content
+        
+        // Implementation would require:
+        // - Mock Playwright MCP responses
+        // - Sample social media data
+        // - CSV validation logic
+        // - File system cleanup
+    });
+});
+*/ 

package/index.js

@@ -1,67 +1,56 @@
 #!/usr/bin/env node
 
 /**
- * FRAIM Framework - Main Entry Point
- * Framework for Rigor-based AI Management
- * Where humans become AI managers through rigorous methodology
+ * FRAIM Framework - Smart Entry Point
+ * This file handles both production (dist/) and development (src/) environments.
  */
 
 const path = require('path');
 const fs = require('fs');
+const { spawnSync } = require('child_process');
 
-// Import the CLI
-const { main } = require('./bin/fraim.js');
+/**
+ * Runs the CLI using either the compiled JS or the source TS via tsx
+ */
+function runCLI() {
+    const distPath = path.join(__dirname, 'dist', 'src', 'cli', 'fraim.js');
+    const srcPath = path.join(__dirname, 'src', 'cli', 'fraim.ts');
 
-// Export the main function for programmatic use
-module.exports = { main };
+    // 1. Check if we have a compiled version (Production / CI)
+    if (fs.existsSync(distPath)) {
+        require(distPath);
+        return;
+    }
 
-// If this file is run directly, execute the CLI
-if (require.main === module) {
-    main();
+    // 2. Fallback to source version using tsx (Development)
+    if (fs.existsSync(srcPath)) {
+        // We use spawnSync to run tsx so we don't have to require it in memory
+        // if it's not needed, and it handles the process arguments correctly.
+        const result = spawnSync('npx', ['tsx', srcPath, ...process.argv.slice(2)], {
+            stdio: 'inherit',
+            shell: true,
+            windowsHide: true
+        });
+        process.exit(result.status || 0);
+    }
+
+    console.error('❌ FRAIM Error: Could not find CLI entry point.');
+    console.error('Expected one of:');
+    console.error(` - ${distPath}`);
+    console.error(` - ${srcPath}`);
+    process.exit(1);
 }
 
-// Framework information
-module.exports.FRAIM_INFO = {
-    name: 'FRAIM',
-    fullName: 'Framework for Rigor-based AI Management',
-    version: '1.0.0',
-    description: 'Where humans become AI managers through rigorous methodology',
-    methodology: 'RIGOR',
-    principles: [
-        'Reviews: Structured feedback and approval processes',
-        'Isolation: Agents don\'t interfere with each others\' work *unless* you explicitly ask them to',
-        'GitOps: Git as the single source of truth and the glue between you and your agents',
-        'Observability: Complete visibility into AI activities',
-        'Retrospectives: Continuous learning from mistakes and positive experiences'
-    ],
-    supportedAgents: ['cursor', 'claude', 'windsurf'],
-    repository: 'https://github.com/mathursrus/FRAIM',
-    note: 'All rules and workflows have been tested and proven in real project environments',
-    
-    // New structure information
-    structure: {
-        rules: '/rules/',
-        workflows: '/workflows/',
-        templates: '/templates/',
-        scripts: '/scripts/',
-        github: '/.github/'
-    },
-    
-    // Centralized rules
-    centralizedRules: [
-        'integrity-and-test-ethics.md',
-        'simplicity.md',
-        'architecture.md',
-        'continuous-learning.md',
-        'successful-debugging-patterns.md'
-    ],
-    
-    // Workflow templates
-    workflowTemplates: [
-        'design.md',
-        'implement.md',
-        'test.md',
-        'resolve.md',
-        'retrospect.md'
-    ]
-};
+// Global programmatic exports
+module.exports = {
+    FRAIM_INFO: {
+        name: 'FRAIM',
+        version: '2.0.54',
+        repository: 'https://github.com/mathursrus/FRAIM'
+    }
+};
+
+// If this file is run directly (via npx or global link), run the CLI
+if (require.main === module) {
+    runCLI();
+}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.52",
+  "version": "2.0.55",
   "description": "FRAIM v2: Framework for Rigor-based AI Management - Transform from solo developer to AI manager orchestrating production-ready code with enterprise-grade discipline",
   "main": "index.js",
   "bin": {
-    "fraim": "./bin/fraim.js",
-    "fraim-setup": "./bin/fraim.js"
+    "fraim": "./index.js",
+    "fraim-setup": "./index.js"
   },
   "scripts": {
     "setup": "node setup.js",
@@ -19,8 +19,8 @@
     "watch:fraimlogs": "tsx scripts/watch-fraim-logs.ts",
     "manage-keys": "tsx scripts/fraim/manage-keys.ts",
     "view-signups": "tsx scripts/view-signups.ts",
-    "fraim:init": "npm run build && node bin/fraim.js init",
-    "fraim:sync": "node bin/fraim.js sync",
+    "fraim:init": "npm run build && node index.js init",
+    "fraim:sync": "node index.js sync",
     "postinstall": "fraim sync --skip-updates || echo 'FRAIM setup skipped.'",
     "prepublishOnly": "npm run build",
     "release": "npm version patch && npm publish",

package/registry/agent-guardrails.md

@@ -1,63 +1,63 @@
-# AI Agent Guardrails
-
-This file references the centralized rules located in `rules/` to ensure consistency across all AI platforms.
-
-## SUCCESS CRITERIA (THE "FRAIM 5")
-**Source**: Retrieve via `get_fraim_file({ path: "rules/agent-success-criteria.md" })`
-
-All agents are evaluated on:
-1. **Integrity (100 pts)**: Honesty above all.
-2. **Correctness (50 pts)**: Architecture & tests.
-3. **Completeness (30 pts)**: Thoroughness.
-4. **Independence (20 pts)**: Smart decisions.
-5. **Speed (10 pts)**: Velocity.
-
-## Referenced Rules
-
-### 0. Integrity
-**Source**: Retrieve via `get_fraim_file({ path: "rules/integrity-and-test-ethics.md" })`
-
-THIS IS THE MOST CRITICAL RULE. Be ethical, truthful, honest above all.
-
-### 1. Simplicity
-**Source**: Retrieve via `get_fraim_file({ path: "rules/simplicity.md" })`
-
-Keep solutions simple and focused, avoid over-engineering. Focus on the assigned issue only and don't make unrelated changes.
-
-### 2. Communication  
-**Source**: Retrieve via `get_fraim_file({ path: "rules/communication.md" })`
-
-Establish clear communication patterns and progress reporting standards for effective coordination between agents and stakeholders.
-
-### 3. Architecture
-**Source**: Read local architecture document (path from `.fraim/config.json` `customizations.architectureDoc`)
-
-Maintain clean architectural boundaries by using BAML (LLM) for natural-language understanding and TypeScript for deterministic work.
-
-### 4. Continuous Learning
-**Source**: Retrieve via `get_fraim_file({ path: "rules/continuous-learning.md" })`
-
-Prevent repeating past mistakes by systematically learning from retrospectives, RFCs, and historical issue patterns.
-
-### 5. Agent Testing Guidelines
-**Source**: Retrieve via `get_fraim_file({ path: "rules/agent-testing-guidelines.md" })`
-
-Comprehensive testing and validation requirements with concrete evidence. Ensures all work is thoroughly validated before completion.
-
-### 6. Local Development
-**Source**: Retrieve via `get_fraim_file({ path: "rules/local-development.md" })`
-
-Local development guidelines and workspace safety. Enables safe parallel development through strict workspace separation.
-
-### 7. Software Development Lifecycle
-**Source**: Retrieve via `get_fraim_file({ path: "rules/software-development-lifecycle.md" })`
-
-### 9. Merge Requirements
-**Source**: Retrieve via `get_fraim_file({ path: "rules/merge-requirements.md" })`
-
-Enforces a strict `git rebase` workflow to ensure feature branches are up-to-date with `master` before merging, maintaining a clean and stable history.
-
-### 10. Best practices while debuggin
-**Source**: Retrieve via `get_fraim_file({ path: "rules/successful-debugging-patterns.md" })`
-
+# AI Agent Guardrails
+
+This file references the centralized rules located in `rules/` to ensure consistency across all AI platforms.
+
+## SUCCESS CRITERIA (THE "FRAIM 5")
+**Source**: Retrieve via `get_fraim_file({ path: "rules/agent-success-criteria.md" })`
+
+All agents are evaluated on:
+1. **Integrity (100 pts)**: Honesty above all.
+2. **Correctness (50 pts)**: Architecture & tests.
+3. **Completeness (30 pts)**: Thoroughness.
+4. **Independence (20 pts)**: Smart decisions.
+5. **Speed (10 pts)**: Velocity.
+
+## Referenced Rules
+
+### 0. Integrity
+**Source**: Retrieve via `get_fraim_file({ path: "rules/integrity-and-test-ethics.md" })`
+
+THIS IS THE MOST CRITICAL RULE. Be ethical, truthful, honest above all.
+
+### 1. Simplicity
+**Source**: Retrieve via `get_fraim_file({ path: "rules/simplicity.md" })`
+
+Keep solutions simple and focused, avoid over-engineering. Focus on the assigned issue only and don't make unrelated changes.
+
+### 2. Communication  
+**Source**: Retrieve via `get_fraim_file({ path: "rules/communication.md" })`
+
+Establish clear communication patterns and progress reporting standards for effective coordination between agents and stakeholders.
+
+### 3. Architecture
+**Source**: Read local architecture document (path from `.fraim/config.json` `customizations.architectureDoc`)
+
+Maintain clean architectural boundaries by using BAML (LLM) for natural-language understanding and TypeScript for deterministic work.
+
+### 4. Continuous Learning
+**Source**: Retrieve via `get_fraim_file({ path: "rules/continuous-learning.md" })`
+
+Prevent repeating past mistakes by systematically learning from retrospectives, RFCs, and historical issue patterns.
+
+### 5. Agent Testing Guidelines
+**Source**: Retrieve via `get_fraim_file({ path: "rules/agent-testing-guidelines.md" })`
+
+Comprehensive testing and validation requirements with concrete evidence. Ensures all work is thoroughly validated before completion.
+
+### 6. Local Development
+**Source**: Retrieve via `get_fraim_file({ path: "rules/local-development.md" })`
+
+Local development guidelines and workspace safety. Enables safe parallel development through strict workspace separation.
+
+### 7. Software Development Lifecycle
+**Source**: Retrieve via `get_fraim_file({ path: "rules/software-development-lifecycle.md" })`
+
+### 9. Merge Requirements
+**Source**: Retrieve via `get_fraim_file({ path: "rules/merge-requirements.md" })`
+
+Enforces a strict `git rebase` workflow to ensure feature branches are up-to-date with `master` before merging, maintaining a clean and stable history.
+
+### 10. Best practices while debuggin
+**Source**: Retrieve via `get_fraim_file({ path: "rules/successful-debugging-patterns.md" })`
+
 Patterns on debugging issues systematically and converting learnings into test cases

package/registry/scripts/detect-tautological-tests.sh

@@ -1,38 +1,38 @@
-#!/bin/bash
-
-# Detect Tautological Tests
-# This script scans test files for patterns that suggest tests are validating code structure 
-# (interfaces, enums) rather than runtime behavior.
-
-echo "🔍 Scanning for Tautological Test Patterns..."
-ERROR_FOUND=0
-
-# Pattern 1: Asserting an array literal equals another array literal (common in enum testing)
-# Looks for: assert.deepEqual(['a', 'b'], ['a', 'b'])
-if grep -rE "assert\.(deep)?(Strict)?Equal\(\[.*\], \[.*\]\)" test*.ts; then
-    echo "❌ ERROR: Found potential tautological array comparison. Tests should verify app logic, not hardcoded arrays."
-    echo "   Rationale: Testing that ['A'] equals ['A'] validates nothing about the application."
-    ERROR_FOUND=1
-fi
-
-# Pattern 2: Asserting properties on an object literal defined in the test (Type/Interface testing)
-# Simplified: Look for defining a typed object and immediately asserting on it in the same file
-# This is hard to do robustly with just grep, so we'll rely on the Naming Convention check for now.
-
-# Pattern 3: Test names that explicitly say "Validate Enums", "Validate Fields", etc.
-# We match "Validate TaskStatus Enums" or similar phrases
-if grep -riE "['\"]Unit: Validate (Enum|Constant|Interface|Type|Field|Object|TaskStatus|Task Object)" test*.ts; then
-    echo "❌ ERROR: Found test descriptions explicitly claiming to validate Enums/Types/Fields."
-    echo "   Rationale: Unit tests should validate BEHAVIOR (e.g., 'persists correct status'), not definitions."
-    ERROR_FOUND=1
-fi
-
-if [ $ERROR_FOUND -eq 1 ]; then
-    echo ""
-    echo "⚠️  Potential Anti-Patterns Detected."
-    echo "   Please review the identified tests against rules/integrity-and-test-ethics.md"
-    exit 1
-else
-    echo "✅ No obvious tautological patterns found."
-    exit 0
-fi
+#!/bin/bash
+
+# Detect Tautological Tests
+# This script scans test files for patterns that suggest tests are validating code structure 
+# (interfaces, enums) rather than runtime behavior.
+
+echo "🔍 Scanning for Tautological Test Patterns..."
+ERROR_FOUND=0
+
+# Pattern 1: Asserting an array literal equals another array literal (common in enum testing)
+# Looks for: assert.deepEqual(['a', 'b'], ['a', 'b'])
+if grep -rE "assert\.(deep)?(Strict)?Equal\(\[.*\], \[.*\]\)" test*.ts; then
+    echo "❌ ERROR: Found potential tautological array comparison. Tests should verify app logic, not hardcoded arrays."
+    echo "   Rationale: Testing that ['A'] equals ['A'] validates nothing about the application."
+    ERROR_FOUND=1
+fi
+
+# Pattern 2: Asserting properties on an object literal defined in the test (Type/Interface testing)
+# Simplified: Look for defining a typed object and immediately asserting on it in the same file
+# This is hard to do robustly with just grep, so we'll rely on the Naming Convention check for now.
+
+# Pattern 3: Test names that explicitly say "Validate Enums", "Validate Fields", etc.
+# We match "Validate TaskStatus Enums" or similar phrases
+if grep -riE "['\"]Unit: Validate (Enum|Constant|Interface|Type|Field|Object|TaskStatus|Task Object)" test*.ts; then
+    echo "❌ ERROR: Found test descriptions explicitly claiming to validate Enums/Types/Fields."
+    echo "   Rationale: Unit tests should validate BEHAVIOR (e.g., 'persists correct status'), not definitions."
+    ERROR_FOUND=1
+fi
+
+if [ $ERROR_FOUND -eq 1 ]; then
+    echo ""
+    echo "⚠️  Potential Anti-Patterns Detected."
+    echo "   Please review the identified tests against rules/integrity-and-test-ethics.md"
+    exit 1
+else
+    echo "✅ No obvious tautological patterns found."
+    exit 0
+fi