@itz4blitz/agentful 1.6.0 → 1.8.0

package/README.md

@@ -11,14 +11,14 @@
 
 [![Downloads](https://img.shields.io/npm/dm/@itz4blitz/agentful.svg)](https://www.npmjs.com/package/@itz4blitz/agentful)
 [![GitHub Stars](https://img.shields.io/github/stars/itz4blitz/agentful?style=social)](https://github.com/itz4blitz/agentful)
-[![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289da)](https://discord.gg/SMDvJXUe)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289da)](https://discord.gg/X2tCJh76rG)
 [![Documentation](https://img.shields.io/badge/docs-agentful.app-blue)](https://agentful.app)
 
 **Pre-configured development toolkit for Claude Code**
 
 Orchestrates specialized agents in parallel with inter-agent communication to build features from product specs.
 
-[Quick Start](#quick-start) • [Documentation](https://agentful.app) • [Discord](https://discord.gg/SMDvJXUe)
+[Quick Start](#quick-start) • [Documentation](https://agentful.app) • [Discord](https://discord.gg/X2tCJh76rG)
 
 </div>
 
@@ -49,6 +49,16 @@ claude
 /agentful-start
 ```
 
+## Pattern Learning
+
+Enable agents to learn from every session and reuse successful patterns:
+
+```bash
+claude mcp add agentful -- npx -y @itz4blitz/agentful-mcp-server
+```
+
+The reviewer stores error patterns, the fixer looks up known fixes, and the orchestrator stores successful implementation patterns - compounding knowledge across sessions.
+
 ## Installation Options
 
 ```bash
@@ -104,7 +114,7 @@ Auto-detects and adapts to your stack:
 
 - **Docs**: [agentful.app](https://agentful.app)
 - **GitHub**: [github.com/itz4blitz/agentful](https://github.com/itz4blitz/agentful)
-- **Discord**: [discord.gg/SMDvJXUe](https://discord.gg/SMDvJXUe)
+- **Discord**: [discord.gg/SMDvJXUe](https://discord.gg/X2tCJh76rG)
 - **Issues**: [github.com/itz4blitz/agentful/issues](https://github.com/itz4blitz/agentful/issues)
 - **NPM**: [npmjs.com/package/@itz4blitz/agentful](https://www.npmjs.com/package/@itz4blitz/agentful)
 

package/bin/cli.js

@@ -411,6 +411,13 @@ async function init(args) {
   }
   log(colors.dim, 'Optional: Edit CLAUDE.md and .claude/product/index.md first to customize.');
   console.log('');
+  log(colors.bright, 'Recommended: Enable Pattern Learning');
+  console.log('');
+  log(colors.dim, '  Agents get smarter when they can store and reuse patterns.');
+  log(colors.dim, '  Run this once to enable:');
+  console.log('');
+  log(colors.cyan, '    claude mcp add agentful -- npx -y @itz4blitz/agentful-mcp-server');
+  console.log('');
 }
 
 function showStatus() {

package/bin/hooks/block-file-creation.js

@@ -176,7 +176,10 @@ if (isInAllowedDir) {
       '.agentful/conversation-state.json',
       '.agentful/conversation-history.json',
       '.agentful/agent-metrics.json',
-      '.agentful/metadata.json'
+      '.agentful/metadata.json',
+      '.agentful/learnings.json',
+      '.agentful/last-validation.json',
+      '.agentful/product-analysis.json'
     ];
 
     if (agentfulFiles.includes(normalizedPath)) {
@@ -198,6 +201,9 @@ Allowed .agentful/ files:
   - conversation-history.json (message history)
   - agent-metrics.json (agent lifecycle hooks)
   - metadata.json (version tracking)
+  - learnings.json (compound engineering retrospectives)
+  - last-validation.json (latest validation report)
+  - product-analysis.json (product spec analysis)
 
 Do NOT create random state snapshots or debug files in .agentful/.
 `);

package/lib/parallel-execution.js

@@ -48,7 +48,8 @@ export function detectTeammateTool() {
     }
 
     if (isNativeBinary(claudePath)) {
-      return { available: false, reason: 'Native binary detected - patching not supported', isNative: true };
+      // Native Claude Code binaries have built-in parallel execution via Task tool
+      return { available: true, method: 'native', isNative: true };
     }
 
     const cliContent = fs.readFileSync(claudePath, 'utf8');
@@ -151,7 +152,8 @@ export function enableTeammateTool() {
     }
 
     if (isNativeBinary(claudePath)) {
-      return { success: false, error: 'Native binary detected - patching not supported. TeammateTool patching only works with npm-installed Claude Code.' };
+      // Native binaries have built-in support, no patching needed
+      return { success: true, message: 'Native binary has built-in parallel execution support', alreadyEnabled: true };
     }
 
     // Backup original

package/lib/presets.js

@@ -212,7 +212,7 @@ export function listPresets() {
 export function validateConfiguration(config) {
   const errors = [];
   const availableAgents = ['orchestrator', 'architect', 'backend', 'frontend', 'tester', 'reviewer', 'fixer', 'product-analyzer'];
-  const availableSkills = ['product-tracking', 'validation', 'testing', 'conversation', 'product-planning', 'deployment'];
+  const availableSkills = ['product-tracking', 'validation', 'testing', 'conversation', 'product-planning', 'deployment', 'research'];
   const availableHooks = Object.keys(hookConfigurations);
 
   // Always require orchestrator

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itz4blitz/agentful",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Pre-configured AI toolkit with self-hosted execution - works with any LLM, any tech stack, any platform.",
   "type": "module",
   "bin": {

package/template/.claude/agents/backend.md

@@ -2,7 +2,7 @@
 name: backend
 description: Implements backend services, repositories, controllers, APIs, database schemas, authentication. Never modifies frontend code.
 model: sonnet
-tools: Read, Write, Edit, Glob, Grep, Bash, mcp__agentful-mcp-server__find_patterns, mcp__agentful-mcp-server__store_pattern, mcp__agentful-mcp-server__add_feedback
+tools: Read, Write, Edit, Glob, Grep, Bash, mcp__agentful__find_patterns, mcp__agentful__store_pattern, mcp__agentful__add_feedback
 ---
 
 # Backend Agent

package/template/.claude/agents/fixer.md

@@ -2,7 +2,7 @@
 name: fixer
 description: Automatically fixes validation failures identified by reviewer. Removes dead code, adds tests, resolves issues.
 model: sonnet
-tools: Read, Write, Edit, Glob, Grep, Bash, mcp__agentful-mcp-server__find_patterns, mcp__agentful-mcp-server__store_pattern, mcp__agentful-mcp-server__add_feedback
+tools: Read, Write, Edit, Glob, Grep, Bash, mcp__agentful__find_patterns, mcp__agentful__store_pattern, mcp__agentful__add_feedback
 ---
 
 # Fixer Agent

package/template/.claude/agents/frontend.md

@@ -2,7 +2,7 @@
 name: frontend
 description: Implements frontend UI components, pages, hooks, state management, styling. Never modifies backend code.
 model: sonnet
-tools: Read, Write, Edit, Glob, Grep, Bash, mcp__agentful-mcp-server__find_patterns, mcp__agentful-mcp-server__store_pattern, mcp__agentful-mcp-server__add_feedback
+tools: Read, Write, Edit, Glob, Grep, Bash, mcp__agentful__find_patterns, mcp__agentful__store_pattern, mcp__agentful__add_feedback
 ---
 
 # Frontend Agent

package/template/.claude/agents/orchestrator.md

@@ -330,8 +330,9 @@ TodoWrite([
 6. Run @reviewer for quality gates
 7. If issues → @fixer → re-validate
 8. Update completion.json
-9. Check if architecture needs re-analysis
-10. LOOP until 100% complete
+9. COMPOUND: Store learnings and patterns
+10. Check if architecture needs re-analysis
+11. LOOP until 100% complete
 ```
 
 ### BUGFIX / ENHANCEMENT / REFACTOR
@@ -502,6 +503,48 @@ Task("reviewer agent", "Review all changes in src/auth/")
 - ❌ Fixer needs reviewer results before fixing issues
 - ❌ Quality gates (must validate sequentially)
 
+### COMPOUND Phase
+
+After a feature passes all quality gates in FEATURE_DEVELOPMENT, run the compound phase:
+
+1. **Store successful patterns to MCP** (if available):
+   ```
+   Try MCP tool: store_pattern
+   - code: <key implementation pattern that worked well>
+   - tech_stack: <detected tech stack>
+   ```
+   - Only store if feature passed all quality gates
+   - Focus on reusable patterns (not one-off code)
+   - If tool unavailable: skip silently
+
+2. **Append retrospective to `.agentful/learnings.json`** (create if missing):
+   ```json
+   {
+     "learnings": [
+       {
+         "feature": "<feature name>",
+         "timestamp": "<ISO 8601>",
+         "review_fix_cycles": <number of review→fix→re-validate cycles>,
+         "gates_failed_initially": ["<gate names that failed on first review>"],
+         "key_learning": "<1-sentence summary of what was learned>"
+       }
+     ]
+   }
+   ```
+
+3. **Track iteration metrics** in `state.json`:
+   ```json
+   {
+     "last_feature_metrics": {
+       "feature": "<feature name>",
+       "cycles": <review/fix cycle count>,
+       "gates_passed_first_try": <boolean>
+     }
+   }
+   ```
+
+**Skip COMPOUND for**: BUGFIX, ENHANCEMENT, REFACTOR workflows and blocked/skipped features.
+
 ## Decision Handling
 
 When you need user input:

package/template/.claude/agents/reviewer.md

@@ -2,7 +2,7 @@
 name: reviewer
 description: Reviews code quality, finds dead code, validates production readiness. Runs all checks and reports issues.
 model: sonnet
-tools: Read, Write, Edit, Glob, Grep, Bash
+tools: Read, Write, Edit, Glob, Grep, Bash, mcp__agentful__store_pattern
 ---
 
 # Reviewer Agent
@@ -221,9 +221,21 @@ When validation tools are unavailable:
 
 ## After Implementation
 
-Report:
-- Overall validation status (passed/failed)
-- Which gates passed/failed
-- List of issues requiring fixes
-- List of warnings that can be ignored
-- Recommendation: delegate to @fixer if issues found
+1. **Store error patterns to MCP** (if available):
+   For each failed gate with specific error messages:
+   ```
+   Try MCP tool: store_pattern
+   - code: <error pattern and context>
+   - tech_stack: <detected tech stack>
+   - error: <specific error message from failed gate>
+   ```
+   - Focus on recurring or non-obvious errors
+   - Include enough context for the fixer to match against
+   - If tool unavailable: skip silently
+
+2. **Report**:
+   - Overall validation status (passed/failed)
+   - Which gates passed/failed
+   - List of issues requiring fixes
+   - List of warnings that can be ignored
+   - Recommendation: delegate to @fixer if issues found

package/template/.claude/agents/tester.md

@@ -2,7 +2,7 @@
 name: tester
 description: Writes comprehensive unit, integration, and E2E tests. Ensures coverage meets 80% threshold.
 model: sonnet
-tools: Read, Write, Edit, Glob, Grep, Bash, mcp__agentful-mcp-server__find_patterns, mcp__agentful-mcp-server__store_pattern, mcp__agentful-mcp-server__add_feedback
+tools: Read, Write, Edit, Glob, Grep, Bash, mcp__agentful__find_patterns, mcp__agentful__store_pattern, mcp__agentful__add_feedback
 ---
 
 # Tester Agent

package/template/CLAUDE.md

@@ -61,6 +61,23 @@ When you start a Claude Code session, agentful automatically:
 
 No need to remember commands - just pick a numbered action!
 
+## Pattern Learning (MCP Server)
+
+Enable cross-session pattern learning so agents compound knowledge over time:
+
+```bash
+claude mcp add agentful -- npx -y @itz4blitz/agentful-mcp-server
+```
+
+**What this enables:**
+- **Reviewer** stores error patterns so the fixer can look up known fixes instantly
+- **Fixer** queries known fixes before attempting manual repairs, then stores successful fixes
+- **Orchestrator** stores successful implementation patterns after features pass all quality gates
+
+Without MCP: agents start from scratch every session. With MCP: agents compound across sessions.
+
+See [Hooks System](#hooks-system) below for manual setup or other editors.
+
 ## Commands
 
 | Command | Description | When to Use |
@@ -119,6 +136,8 @@ These appear only when relevant:
 - `.agentful/conversation-history.json` - Message history for context tracking
 - `.agentful/agent-metrics.json` - Agent lifecycle hooks and metrics
 - `.agentful/architecture.json` - Detected tech stack and generated agents
+- `.agentful/learnings.json` - Compound engineering retrospectives
+- `.agentful/last-validation.json` - Latest validation report from reviewer
 
 **Configuration** (auto-generated, customizable):
 - `.claude/agents/` - Specialized agents for your tech stack

package/version.json

@@ -1,3 +1,3 @@
 {
-  "version": "1.5.1"
+  "version": "1.7.0"
 }