Lens Framework Integration + Business Memory Filtering

.kilocode/rules/# Soulfield OS - Workspace Rules.md

@@ -0,0 +1,108 @@
+# Soulfield OS - Workspace Rules
+
+**CRITICAL:** These rules apply to ALL work in the Soulfield project.
+
+---
+
+## MANDATORY: 6-Lens Framework Integration
+
+**Every agent MUST integrate with the 6-lens framework. Non-negotiable.**
+
+### Required Pattern:
+
+```javascript
+const LensOrchestrator = require('../../lenses/LensOrchestrator.js');
+const lensOrchestrator = new LensOrchestrator();
+
+async function handleRequest(prompt, context = {}) {
+  try {
+    const response = "Agent response...";
+
+    // MANDATORY: Apply lens validation
+    const lensResult = await lensOrchestrator.applyAll(response, {
+      agent: 'agentId',
+      query: prompt,
+      domain: 'agent domain'
+    });
+
+    return {
+      response: response,
+      lensResult: lensResult,
+      quality_score: lensResult.overall.quality_score
+    };
+  } catch (error) {
+    throw new Error(`Agent error: ${error.message}`);
+  }
+}
+
+module.exports = { handleRequest };
+```
+
+---
+
+## File Structure
+
+- Agent handlers: `backend/agents/handlers/{agentId}.cjs`
+- Agent config: `backend/data/agents.json`
+- Tests: `backend/tests/{agentId}.test.cjs`
+
+---
+
+## Testing Requirements
+
+- ✅ 20+ test cases per agent
+- ✅ All tests must pass (20/20)
+- ✅ Quality score >0.90
+- ✅ All 6 lenses must pass
+
+---
+
+## Reference Files
+
+- `backend/agents/handlers/legal.cjs` - Complete agent with 6-lens integration
+- `backend/agents/handlers/seo.cjs` - Example agent with MCP
+- `backend/data/agents.json` - System prompt patterns
+- `backend/tests/legal.test.cjs` - Comprehensive test structure
+
+## CRITICAL: Pinecone Metadata Constraints
+
+**Pinecone metadata MUST use primitives only** (string, number, boolean, or array of strings)
+
+❌ **WRONG** - Do NOT pass objects:
+```javascript
+metadata: {
+  context: context,  // ❌ Object not allowed
+  config: { foo: 'bar' }  // ❌ Nested object not allowed
+}
+```
+
+✅ **CORRECT** - Extract and convert to primitives:
+```javascript
+metadata: {
+  jurisdiction: String(context.jurisdiction || 'general'),  // ✅
+  document_type: String(context.document_type || 'general'),  // ✅
+  quality_score: lensResult.aggregated.metrics.overall_quality_score,  // ✅ number
+  timestamp: new Date().toISOString(),  // ✅ string
+  domain: 'agent-domain'  // ✅ string
+}
+```
+
+---
+
+## High-Risk Zones 🔴
+
+DO NOT MODIFY without user permission:
+- `backend/jobs.js` (lines 679-711)
+- `backend/council.js` (lines 275-342)
+- `backend/services/memory/memory-pinecone.cjs`
+
+---
+
+## Do Not Commit Until
+
+- [ ] All tests passing (20/20 minimum)
+- [ ] Lens validation working (6/6 lenses)
+- [ ] Quality score >0.90
+- [ ] Clean git commit message
+
+**Never commit with failing tests. Never skip lens integration.**

.kilocode/workflows/# Soulfield Agent Creation Workflow.md

@@ -0,0 +1,125 @@
+# Soulfield Agent Creation Workflow
+
+Standardized workflow for creating new Soulfield agents with 6-lens framework.
+
+**Invoke with:** `/workflow create-agent` or just say "Create @agentId agent"
+
+---
+
+## Steps
+
+### 1. Create Handler File
+
+**Location:** `backend/agents/handlers/{agentId}.cjs`
+
+**Template:**
+```javascript
+const LensOrchestrator = require('../../lenses/LensOrchestrator.js');
+const lensOrchestrator = new LensOrchestrator();
+
+async function handleRequest(prompt, context = {}) {
+  try {
+    // TODO: Implement agent logic
+    const response = `Response from @{agentId}`;
+
+    // MANDATORY: Apply lens validation
+    const lensResult = await lensOrchestrator.applyAll(response, {
+      agent: '{agentId}',
+      query: prompt,
+      domain: '{domain}'
+    });
+
+    return {
+      response: response,
+      lensResult: lensResult,
+      quality_score: lensResult.overall.quality_score
+    };
+  } catch (error) {
+    throw new Error(`Agent error: ${error.message}`);
+  }
+}
+
+module.exports = { handleRequest };
+```
+
+---
+
+### 2. Add to Agent Config
+
+**File:** `backend/data/agents.json`
+
+Add new entry with:
+- `id`: "{agentId}"
+- `name`: "{Agent Name}"
+- `alias`: "@{agentId}"
+- `systemPrompt`: Include all 6 lens instructions
+
+---
+
+### 3. Create Test Suite
+
+**Location:** `backend/tests/{agentId}.test.cjs`
+
+Minimum 20 test cases:
+- 3 basic queries
+- 7 lens validation tests
+- 5 edge cases
+- 3 error handling tests
+- 2 quality metric tests
+
+---
+
+### 4. Run Tests
+
+**IMPORTANT**: Full test suites take 30-60 seconds because they make real API calls.
+
+**Option A - Quick Validation** (Recommended for initial check):
+```bash
+node backend/tests/{agentId}-quick.test.cjs
+```
+
+**Option B - Full Test Suite**:
+```bash
+timeout 90 node backend/tests/{agentId}.test.cjs
+```
+
+**What to expect:**
+- Tests call actual Anthropic API (takes time)
+- Some tests may timeout after 60-90 seconds
+- Quick test validates structure, exports, and error handling in <10 seconds
+
+**Success criteria:**
+- ✅ Quick test passes (structure valid)
+- ✅ Handler exports run() and handleRequest()
+- ✅ Quality score present in output
+- ✅ No critical errors
+
+You do NOT need to wait for all 20+ tests to complete. Quick validation is sufficient.
+
+---
+
+### 5. Commit
+
+```bash
+git add backend/agents/handlers/{agentId}.cjs
+git add backend/data/agents.json
+git add backend/tests/{agentId}.test.cjs
+git commit -m "feat(agents): add @{agentId} agent for {domain}"
+```
+
+---
+
+## Success Checklist
+
+- [ ] Handler created with LensOrchestrator
+- [ ] Entry in agents.json
+- [ ] 20+ tests created
+- [ ] All tests passing (20/20)
+- [ ] Quality score >0.90
+- [ ] Git commit created
+
+---
+
+## Reference
+
+Copy pattern from: `backend/agents/handlers/seo.cjs`