agentic-sdlc 1.5.1 → 1.8.1

package/README.md

@@ -7,8 +7,9 @@
 **Agentic SDLC** is an AI-powered development framework that simulates a complete software development team within your IDE. It provides:
 
 - **14 Specialized AI Roles** - PM, BA, SA, UI/UX, QA, Security, Dev, DevOps, Tester, Reporter, and more
-- **12 Automated Workflows** - From planning to deployment with `/slash` commands
+- **18 Automated Workflows** - From planning to deployment with `/slash` commands
 - **Intelligent Brain System** - 3-Layer architecture with state management and self-learning
+- **Multi-Agent Teams** - AutoGen-powered autonomous agent collaboration
 - **Cross-IDE Compatibility** - Works with Cursor, Windsurf, Cline, Aider, Gemini, and any AI-powered IDE
 - **Monorepo Architecture** - Shared brain system across multiple projects
 
@@ -78,7 +79,7 @@ Delivery    → @REPORTER, @STAKEHOLDER
 Meta        → @BRAIN, @ORCHESTRATOR
 ```
 
-### 2. Slash Commands (12 Workflows)
+### 2. Slash Commands (18 Workflows)
 
 Execute complete workflows with simple commands:
 
@@ -92,9 +93,15 @@ Execute complete workflows with simple commands:
 /metrics         # View metrics dashboard
 /release         # Release management
 /emergency       # Critical incident response
-/route           # Intelligent workflow routing
-/compound        # Knowledge capture
 /housekeeping    # Cleanup & maintenance
+/review          # Code review workflow (NEW)
+/debug           # Systematic debugging (NEW)
+/refactor        # Safe refactoring (NEW)
+/onboarding      # Agent ramp-up (NEW)
+/docs            # Documentation creation (NEW)
+/commit          # Smart git commit (NEW)
+/worktree        # Parallel AI agent workflows (NEW)
+/autogen         # Multi-agent task execution (NEW)
 ```
 
 ### 3. Monorepo Architecture
@@ -203,6 +210,7 @@ python tools/neo4j/brain_parallel.py --sync      # Sync brain
 | Inconsistent code quality | Enforced by @QA, @SECA |
 | Lost knowledge | Compound learning brain |
 | Repetitive tasks | Automated with @AUTO |
+| Single-agent limits | Multi-agent teams with AutoGen |
 | Solo problem-solving | 13+ AI experts available |
 
 ## 🔗 Links

package/bin/cli.js

@@ -7,28 +7,121 @@ import fs from 'fs';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const rootDir = resolve(__dirname, '..');
 
+// Command mappings: command -> python script path
 const commands = {
+    // Brain & Core
+    'brain': 'tools/brain/brain_cli.py',
+    'learn': 'tools/neo4j/learning_engine.py',
+    'research': 'tools/research/research_agent.py',
+
+    // Layer 2: Intelligence
+    'score': 'tools/layer2/scorer/input_scorer.py',
+    'score-input': 'tools/layer2/scorer/input_scorer.py',
+    'score-output': 'tools/layer2/scorer/output_scorer.py',
+    'route': 'tools/layer2/router/workflow_router.py',
+    'route-workflow': 'tools/layer2/router/workflow_router.py',
+    'route-agent': 'tools/layer2/router/agent_router.py',
+    'rules': 'tools/layer2/router/rules_engine.py',
+    'monitor': 'tools/layer2/monitor/observer.py',
+    'observe': 'tools/layer2/monitor/observer.py',
+    'check-rules': 'tools/layer2/monitor/rule_checker.py',
+    'audit': 'tools/layer2/monitor/audit_logger.py',
+
+    // Layer 3: Infrastructure
     'release': 'tools/release/release.py',
-    'kb': 'bin/kb_cli.py',
+
     'agent': 'tools/run.py',
     'validate': 'tools/validation/validate.py',
     'health': 'tools/validation/health-check.py',
-    'setup': 'tools/setup/init.py'
+    'setup': 'tools/setup/init.py',
+
+
+    // MCP
+    'mcp': 'mcp/protocol.py',
+
+    // AutoGen Multi-Agent
+    'autogen': 'tools/autogen/runner.py',
+
+    // Run arbitrary scripts
+    'run': null // Special: run <path>
+};
+
+// Command aliases
+const aliases = {
+    'l2': 'layer2',
+    'wf': 'workflow',
+    's': 'score',
+    'r': 'route',
+    'm': 'monitor',
+    'b': 'brain'
 };
 
 const args = process.argv.slice(2);
-const command = args[0];
+let command = args[0];
+
+// Resolve alias
+if (aliases[command]) {
+    command = aliases[command];
+}
 
 function printUsage() {
-    console.log("Usage: agentic-sdlc <command> [args]");
-    console.log("Commands:");
-    console.log("  release   Manage releases (args: release, preview, changelog, version)");
-    console.log("  workflow  Run workflows (args: cycle, housekeeping, etc.)");
-    console.log("  kb        Knowledge Base tools");
-    console.log("  agent     Run default agent");
-    console.log("  validate  Validate system");
-    console.log("  health    Check health");
-    console.log("  setup     Initialize project");
+    console.log(`
+╔═══════════════════════════════════════════════════════════════╗
+║                    AGENTIC SDLC CLI                           ║
+║            3-Layer Brain Architecture Control                 ║
+╚═══════════════════════════════════════════════════════════════╝
+
+Usage: agentic-sdlc <command> [args]
+
+╭─────────────────────────────────────────────────────────────────╮
+│ LAYER 1: CORE                                                   │
+├─────────────────────────────────────────────────────────────────┤
+│  brain       Brain system management & state control            │
+│  learn       Self-learning engine (Neo4j integration)           │
+│  research    Research agent for deep investigation              │
+╰─────────────────────────────────────────────────────────────────╯
+
+╭─────────────────────────────────────────────────────────────────╮
+│ LAYER 2: INTELLIGENCE                                           │
+├─────────────────────────────────────────────────────────────────┤
+│  score         Score input/output quality                       │
+│  score-input   Score input request quality                      │
+│  score-output  Score output/response quality                    │
+│  route         Route to appropriate workflow                    │
+│  route-agent   Route to appropriate AI agent/role               │
+│  rules         Evaluate routing rules                           │
+│  monitor       Monitor system & detect violations               │
+│  observe       Alias for monitor                                │
+│  check-rules   Validate rule compliance                         │
+│  audit         View audit logs                                  │
+╰─────────────────────────────────────────────────────────────────╯
+
+╭─────────────────────────────────────────────────────────────────╮
+│ LAYER 3: INFRASTRUCTURE                                         │
+├─────────────────────────────────────────────────────────────────┤
+│  release     Manage releases & version bumping                  │
+│  workflow    Run workflows (cycle, orchestrator, debug, etc.)   │
+
+│  validate    Validate system configuration                      │
+│  health      Check system health                                │
+│  setup       Initialize project                                 │
+
+│  mcp         MCP (Model Context Protocol) management            │
+│  autogen     Multi-agent task execution (AutoGen)               │
+│  run         Run arbitrary Python script                        │
+╰─────────────────────────────────────────────────────────────────╯
+
+Examples:
+  agentic-sdlc brain status              # Check brain status
+  agentic-sdlc score --score "Add login" # Score input quality
+  agentic-sdlc route --route "fix bug"   # Get workflow recommendation
+  agentic-sdlc monitor --status          # Check monitor status
+  agentic-sdlc release --preview         # Preview release changes
+  agentic-sdlc workflow cycle            # Run cycle workflow
+  agentic-sdlc run tools/brain/judge.py  # Run any Python script
+
+Aliases: l2=layer2, wf=workflow, s=score, r=route, m=monitor, b=brain
+`);
 }
 
 if (!command || command === '--help' || command === '-h') {
@@ -39,6 +132,31 @@ if (!command || command === '--help' || command === '-h') {
 let scriptPath = commands[command];
 let scriptArgs = args.slice(1);
 
+// Special handling for layer2 namespace
+if (command === 'layer2') {
+    const sub = args[1];
+    if (!sub) {
+        console.log(`
+Layer 2 (Intelligence) Commands:
+  scorer         Input/output quality scoring
+  ab_test        A/B testing engine
+  self_learning  Pattern recognition & improvement
+  artifact_gen   Artifact generation
+  router         Workflow & agent routing
+  proxy          Model cost optimization
+  task_manager   Kanban-style task management
+  monitor        Compliance monitoring
+  performance    Flow optimization
+
+Usage: agentic-sdlc layer2 <component> [args]
+Example: agentic-sdlc layer2 scorer --score "your text"
+`);
+        process.exit(0);
+    }
+    scriptPath = `tools/layer2/${sub}/__init__.py`;
+    scriptArgs = args.slice(2);
+}
+
 // Special handling for workflows
 if (command === 'workflow') {
     const sub = args[1];
@@ -47,13 +165,24 @@ if (command === 'workflow') {
         scriptArgs = args.slice(2);
     } else {
         console.error("Please specify a workflow (e.g., cycle, housekeeping)");
+        console.log("Available: cycle, orchestrator, debug, refactor, review, release, emergency, housekeeping");
         process.exit(1);
     }
 }
 
+// Special handling for 'run' command
+if (command === 'run') {
+    if (args.length < 2) {
+        console.error("Usage: agentic-sdlc run <script_path> [args]");
+        process.exit(1);
+    }
+    scriptPath = args[1];
+    scriptArgs = args.slice(2);
+}
+
 if (!scriptPath) {
     console.error(`Unknown command: ${command}`);
-    printUsage();
+    console.log("Run 'agentic-sdlc --help' for usage information.");
     process.exit(1);
 }
 
@@ -61,6 +190,7 @@ const fullPath = join(rootDir, scriptPath);
 
 if (!fs.existsSync(fullPath)) {
     console.error(`Script not found: ${scriptPath}`);
+    console.log(`Full path: ${fullPath}`);
     process.exit(1);
 }
 

package/docs/.brain-health-history.json

@@ -0,0 +1,42 @@
+[
+  {
+    "status": "healthy",
+    "score": 100.0,
+    "issues": [],
+    "metrics": {
+      "walkthrough_count": 10,
+      "plan_count": 7
+    },
+    "timestamp": "2026-01-08T06:55:27.350396"
+  },
+  {
+    "status": "healthy",
+    "score": 100.0,
+    "issues": [],
+    "metrics": {
+      "walkthrough_count": 10,
+      "plan_count": 7
+    },
+    "timestamp": "2026-01-08T07:15:47.509650"
+  },
+  {
+    "status": "healthy",
+    "score": 100.0,
+    "issues": [],
+    "metrics": {
+      "walkthrough_count": 10,
+      "plan_count": 7
+    },
+    "timestamp": "2026-01-08T20:35:08.123731"
+  },
+  {
+    "status": "healthy",
+    "score": 100.0,
+    "issues": [],
+    "metrics": {
+      "walkthrough_count": 10,
+      "plan_count": 7
+    },
+    "timestamp": "2026-01-08T20:58:54.707900"
+  }
+]

package/docs/.brain-improvements.json

@@ -0,0 +1,53 @@
+{
+  "plans": [
+    {
+      "id": "PLAN-20260105-0931",
+      "createdAt": "2026-01-05T09:31:37.457263",
+      "status": "CREATED",
+      "insights": [
+        {
+          "source": "Judge",
+          "finding": "Average score is low (3.4/10)",
+          "suggestion": "Improve report quality - add more detail, follow templates"
+        },
+        {
+          "source": "Judge",
+          "finding": "Reports consistently fail in 'completeness'",
+          "suggestion": "Focus on improving completeness in reports"
+        }
+      ],
+      "actions": [
+        {
+          "id": "ACTION-1",
+          "source": "Judge",
+          "action": "Improve report quality - add more detail, follow templates",
+          "priority": "medium",
+          "status": "PENDING"
+        },
+        {
+          "id": "ACTION-2",
+          "source": "Judge",
+          "action": "Focus on improving completeness in reports",
+          "priority": "high",
+          "status": "PENDING"
+        }
+      ],
+      "summary": "2 improvement actions identified"
+    }
+  ],
+  "insights": [
+    {
+      "source": "Judge",
+      "finding": "Average score is low (3.4/10)",
+      "suggestion": "Improve report quality - add more detail, follow templates"
+    },
+    {
+      "source": "Judge",
+      "finding": "Reports consistently fail in 'completeness'",
+      "suggestion": "Focus on improving completeness in reports"
+    }
+  ],
+  "appliedImprovements": 0,
+  "createdAt": "2026-01-05T09:31:37.457374",
+  "lastUpdated": "2026-01-05T09:31:37.457582"
+}

package/docs/.brain-learner-log.json

@@ -0,0 +1,27 @@
+{
+  "learnings": [
+    {
+      "description": "Updated landing page with 15 workflows, brain protocol, solutions feature",
+      "timestamp": "2026-01-05T09:01:02.577360",
+      "success": true,
+      "steps": [
+        {
+          "step": "KB Index Update",
+          "status": "success"
+        },
+        {
+          "step": "Neo4j Sync",
+          "status": "success"
+        },
+        {
+          "step": "Learning Engine",
+          "status": "success"
+        }
+      ]
+    }
+  ],
+  "totalLearnings": 1,
+  "autoLearnEnabled": true,
+  "createdAt": "2026-01-05T09:00:11.930196",
+  "lastUpdated": "2026-01-05T09:01:02.581164"
+}

package/docs/.brain-scores.json

@@ -0,0 +1,310 @@
+{
+  "scores": [
+    {
+      "file": "projects\\landing-page\\src\\components\\Features.astro",
+      "scores": {
+        "completeness": 0,
+        "quality": 8.5,
+        "compliance": 2
+      },
+      "finalScore": 3.4,
+      "passed": false,
+      "threshold": 6,
+      "timestamp": "2026-01-05T09:28:25.776905"
+    },
+    {
+      "file": "docs\\walkthroughs\\2026-01-05-landing-page-orchestrator.md",
+      "scores": {
+        "completeness": 0,
+        "quality": 8.5,
+        "compliance": 0
+      },
+      "finalScore": 2.5,
+      "passed": false,
+      "threshold": 6,
+      "timestamp": "2026-01-05T09:32:11.806806"
+    },
+    {
+      "file": "docs\\walkthroughs\\2026-01-05-landing-page-orchestrator.md",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 8.5,
+        "compliance": 4
+      },
+      "finalScore": 7.1,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T09:33:57.519120"
+    },
+    {
+      "file": "projects\\landing-page\\src\\components\\Features.astro",
+      "type": "code",
+      "scores": {
+        "structure": 10.0,
+        "quality": 9,
+        "completeness": 9
+      },
+      "finalScore": 9.3,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T09:45:00.343382"
+    },
+    {
+      "file": "docs\\walkthroughs\\2026-01-05-landing-page-orchestrator.md",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 8.5,
+        "compliance": 4
+      },
+      "finalScore": 7.1,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T09:45:04.197872"
+    },
+    {
+      "file": "docs\\walkthroughs\\2026-01-05-judge-enhancement.md",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 8.5,
+        "compliance": 4
+      },
+      "finalScore": 7.1,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T09:46:24.661632"
+    },
+    {
+      "file": "docs\\walkthroughs\\2026-01-05-landing-page-orchestrator.md",
+      "type": "report",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 8.5,
+        "compliance": 7
+      },
+      "improvements": [
+        "Add code blocks with ``` → +1.5 quality",
+        "Add links to related .md files → +3 compliance"
+      ],
+      "finalScore": 8.3,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T09:53:27.263595"
+    },
+    {
+      "file": "docs\\walkthroughs\\2026-01-05-landing-page-orchestrator.md",
+      "type": "report",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 10.0,
+        "compliance": 10
+      },
+      "improvements": [],
+      "finalScore": 10.0,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T10:22:55.679975"
+    },
+    {
+      "file": "docs\\reports\\Validation-Report-2026-01-05.md",
+      "type": "report",
+      "scores": {
+        "completeness": 0,
+        "quality": 6.5,
+        "compliance": 5
+      },
+      "improvements": [
+        "Add '## Problem' or '## Challenge' section → +2.5 completeness",
+        "Add '## Solution' or '## Implementation' section → +2.5 completeness",
+        "Add '## Artifacts' or '## Output' section → +2.5 completeness",
+        "Add '## Next Steps' or '## Actions' section → +2.5 completeness",
+        "Add more content (>500 chars) → +2 quality",
+        "Add code blocks with ``` → +1.5 quality",
+        "Add YAML frontmatter (---) at top → +2 compliance",
+        "Add links to related .md files → +3 compliance"
+      ],
+      "finalScore": 4.0,
+      "passed": false,
+      "threshold": 6,
+      "timestamp": "2026-01-05T10:36:59.243527"
+    },
+    {
+      "file": "docs\\reports\\Validation-Report-2026-01-05.md",
+      "type": "report",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 10.0,
+        "compliance": 7
+      },
+      "improvements": [
+        "Add links to related .md files → +3 compliance"
+      ],
+      "finalScore": 8.8,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T10:38:47.659767"
+    },
+    {
+      "file": "docs\\reports\\Validation-Report-2026-01-05.md",
+      "type": "report",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 10.0,
+        "compliance": 10
+      },
+      "improvements": [],
+      "finalScore": 10.0,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T10:39:15.430011"
+    },
+    {
+      "file": "docs\\walkthroughs\\2026-01-05-validation.md",
+      "type": "report",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 8.5,
+        "compliance": 10
+      },
+      "improvements": [
+        "Add code blocks with ``` → +1.5 quality"
+      ],
+      "finalScore": 9.5,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T10:39:42.013040"
+    },
+    {
+      "file": "docs\\walkthroughs\\2026-01-05-validation.md",
+      "type": "report",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 8.5,
+        "compliance": 10
+      },
+      "improvements": [
+        "Add code blocks with ``` → +1.5 quality"
+      ],
+      "finalScore": 9.5,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T10:41:11.057977"
+    },
+    {
+      "file": "docs\\walkthroughs\\2026-01-05-workflow-audit.md",
+      "type": "report",
+      "scores": {
+        "completeness": 10.0,
+        "quality": 10.0,
+        "compliance": 5
+      },
+      "improvements": [
+        "Add hashtag tags like #walkthrough → +2 compliance",
+        "Add links to related .md files → +3 compliance"
+      ],
+      "finalScore": 8.0,
+      "passed": true,
+      "threshold": 6,
+      "timestamp": "2026-01-05T11:37:48.912264"
+    },
+    {
+      "file": "C:\\Users\\HOANG LAM\\.gemini\\antigravity\\brain\\f0371fce-9649-421a-97e7-9aea427efcbb\\walkthrough.md",
+      "type": "report",
+      "scores": {
+        "completeness": 0,
+        "quality": 8.5,
+        "compliance": 0
+      },
+      "finalScore": 2.5,
+      "passed": false,
+      "threshold": 6,
+      "improvements": [
+        "Add Problem section → +2.5",
+        "Add Solution section → +2.5",
+        "Add Artifacts section → +2.5",
+        "Add Next Steps section → +2.5",
+        "Add code blocks → +1.5",
+        "Add YAML frontmatter → +2",
+        "Add hashtags → +2",
+        "Move to docs/ subfolder → +3",
+        "Add links → +3"
+      ],
+      "timestamp": "2026-01-06T07:24:05.203744"
+    },
+    {
+      "file": "C:\\Users\\HOANG LAM\\.gemini\\antigravity\\brain\\f0371fce-9649-421a-97e7-9aea427efcbb\\test_execution_report.md",
+      "type": "report",
+      "scores": {
+        "completeness": 0,
+        "quality": 10.0,
+        "compliance": 2
+      },
+      "finalScore": 3.8,
+      "passed": false,
+      "threshold": 6,
+      "improvements": [
+        "Add Problem section → +2.5",
+        "Add Solution section → +2.5",
+        "Add Artifacts section → +2.5",
+        "Add Next Steps section → +2.5",
+        "Add YAML frontmatter → +2",
+        "Move to docs/ subfolder → +3",
+        "Add links → +3"
+      ],
+      "timestamp": "2026-01-06T07:43:32.050567"
+    },
+    {
+      "file": "GEMINI.md",
+      "type": "report",
+      "scores": {
+        "completeness": 5.0,
+        "quality": 10.0,
+        "compliance": 10
+      },
+      "finalScore": 8.5,
+      "passed": true,
+      "threshold": 6,
+      "improvements": [
+        "Add Problem/Goal section → +2.5",
+        "Add Solution/Approach section → +2.5"
+      ],
+      "timestamp": "2026-01-08T10:43:43.198673"
+    },
+    {
+      "file": "tools\\intelligence\\monitor\\resources.py",
+      "type": "code",
+      "scores": {
+        "structure": 10.0,
+        "quality": 10,
+        "completeness": 8
+      },
+      "finalScore": 9.4,
+      "passed": true,
+      "threshold": 6,
+      "improvements": [
+        "Add logic implementation → +2 completeness"
+      ],
+      "timestamp": "2026-01-08T21:00:12.480515"
+    },
+    {
+      "file": "tools\\intelligence\\monitor\\resources.py",
+      "type": "code",
+      "scores": {
+        "structure": 10.0,
+        "quality": 10,
+        "completeness": 8
+      },
+      "finalScore": 9.4,
+      "passed": true,
+      "threshold": 6,
+      "improvements": [
+        "Add logic implementation → +2 completeness"
+      ],
+      "timestamp": "2026-01-08T21:00:42.834044"
+    }
+  ],
+  "averageScore": 7.27,
+  "totalReviews": 19,
+  "passThreshold": 6,
+  "createdAt": "2026-01-05T09:28:25.776862",
+  "lastUpdated": "2026-01-08T21:00:42.834535"
+}