agentic-sdlc 1.5.1 → 1.8.1

package/.agent/workflows/route.md

@@ -1,160 +0,0 @@
----
-description: [Support] Route - Workflow Selection Helper
----
-
-# /route - Intelligent Request Routing
-
-## ⚠️ PURPOSE
-Analyzes user requests and routes to the appropriate workflow or role. Use when unsure which workflow to invoke.
-
-## Quick Reference
-
-### By Request Type
-
-| Request Type | Recommended Route |
-|--------------|-------------------|
-| "Build a new feature" | `/orchestrator` or `/pm` → full SDLC |
-| "Fix this bug" | `/dev` or `/emergency` (if P0) |
-| "Review this design" | `/tester` + `/seca` |
-| "Set up infrastructure" | `/devops` |
-| "Create user stories" | `/ba` |
-| "Design the UI" | `/uiux` |
-| "Design the API" | `/sa` |
-| "How do I..." | `/explore` first, then appropriate role |
-
-### By Urgency
-
-| Urgency | Route |
-|---------|-------|
-| 🔴 Production down | `/emergency --severity P0` |
-| 🟠 Major bug | `/emergency --severity P1` |
-| 🟡 Normal task | `/cycle` |
-| 🟢 Investigation | `/explore` |
-
-### By Phase
-
-| SDLC Phase | Route |
-|------------|-------|
-| Planning | `/pm` |
-| Requirements | `/ba` |
-| Design | `/sa` + `/uiux` |
-| Verification | `/tester` + `/seca` |
-| Implementation | `/dev` |
-| Testing | `/tester` |
-| Deployment | `/devops` |
-| Closure | `/pm` |
-
-## Decision Tree
-
-```
-Is this an emergency?
-├── Yes → /emergency
-└── No → Continue
-
-Is this a full project/feature?
-├── Yes → /orchestrator (full automation)
-└── No → Continue
-
-Is this a single task?
-├── Yes → /cycle
-└── No → Continue
-
-What phase are you in?
-├── Planning → /pm
-├── Requirements → /ba
-├── Design → /sa or /uiux
-├── Review → /tester or /seca
-├── Development → /dev
-├── Testing → /tester
-└── Deployment → /devops
-
-Need maintenance?
-├── Brain sync → /brain
-├── Cleanup → /housekeeping
-├── Validation → /validate
-├── Metrics → /metrics
-└── Release → /release
-```
-
-## Role Selection Guide
-
-### @PM - Project Manager
-**Use when:**
-- Starting a new project
-- Creating project plans
-- Tracking sprint progress
-- Generating reports
-
-### @BA - Business Analyst
-**Use when:**
-- Gathering requirements
-- Writing user stories
-- Defining acceptance criteria
-
-### @SA - System Analyst
-**Use when:**
-- Designing architecture
-- Creating API specifications
-- Making technical decisions
-
-### @UIUX - UI/UX Designer
-**Use when:**
-- Designing interfaces
-- Creating wireframes
-- Ensuring accessibility
-
-### @DEV - Developer
-**Use when:**
-- Implementing features
-- Writing code
-- Fixing bugs
-
-### @TESTER - Tester
-**Use when:**
-- Reviewing designs
-- Writing test plans
-- Executing E2E tests
-
-### @SECA - Security Analyst
-**Use when:**
-- Security review
-- Threat modeling
-- Compliance checking
-
-### @DEVOPS - DevOps Engineer
-**Use when:**
-- Setting up CI/CD
-- Managing deployments
-- Merging PRs
-
-## Common Patterns
-
-### New Feature Request
-```
-/pm → /ba → /sa + /uiux → /tester + /seca → /dev → /tester → /devops
-```
-
-### Bug Fix
-```
-Minor: /cycle
-Major: /emergency → /dev → /tester → /devops → /compound
-```
-
-### Documentation Update
-```
-/dev (for code docs) or /pm (for project docs)
-```
-
-### Maintenance
-```
-/housekeeping → /validate → /metrics → /brain
-```
-
-#route #routing #decision-tree #workflow-selection
-
-
----
-
-## ENFORCEMENT REMINDER
-Before executing, complete /preflight checks.
-

package/bin/kb

@@ -1,34 +0,0 @@
-#!/usr/bin/env bash
-# Knowledge Base CLI - Cross-platform entry point
-# Works on Linux, macOS, and Windows (Git Bash/WSL)
-
-# Detect OS
-if [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "win32" ]]; then
-    # Windows (Git Bash)
-    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    PLATFORM="windows"
-elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
-    # Linux
-    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    PLATFORM="linux"
-elif [[ "$OSTYPE" == "darwin"* ]]; then
-    # macOS
-    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    PLATFORM="macos"
-else
-    echo "Unsupported OS: $OSTYPE"
-    exit 1
-fi
-
-# Check if Python is available
-if command -v python3 &> /dev/null; then
-    PYTHON_CMD="python3"
-elif command -v python &> /dev/null; then
-    PYTHON_CMD="python"
-else
-    echo "Error: Python not found. Please install Python 3.7+"
-    exit 1
-fi
-
-# Run the Python CLI
-exec "$PYTHON_CMD" "$SCRIPT_DIR/kb_cli.py" "$@"

package/bin/kb.bat

@@ -1,28 +0,0 @@
-@echo off
-REM Knowledge Base CLI - Windows batch entry point
-REM Usage: kb.bat [command] [args]
-
-setlocal enabledelayedexpansion
-
-REM Get script directory
-set "SCRIPT_DIR=%~dp0"
-
-REM Check for Python
-where python >nul 2>nul
-if %ERRORLEVEL% EQU 0 (
-    set "PYTHON_CMD=python"
-    goto :run
-)
-
-where python3 >nul 2>nul
-if %ERRORLEVEL% EQU 0 (
-    set "PYTHON_CMD=python3"
-    goto :run
-)
-
-echo Error: Python not found. Please install Python 3.7+
-exit /b 1
-
-:run
-REM Run the Python CLI
-"%PYTHON_CMD%" "%SCRIPT_DIR%kb_cli.py" %*

package/bin/kb_cli.py

@@ -1,226 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Knowledge Base CLI - Cross-platform
-Supports Windows, Linux, and macOS
-
-Usage:
-    kb [command] [args]
-    kb.bat [command] [args]  (Windows)
-"""
-
-import sys
-import os
-import platform
-import argparse
-from pathlib import Path
-
-# Set UTF-8 encoding for Windows console
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-        sys.stderr.reconfigure(encoding='utf-8')
-    except:
-        pass
-
-# Add lib directory to path
-SCRIPT_DIR = Path(__file__).parent
-LIB_DIR = SCRIPT_DIR / "lib"
-sys.path.insert(0, str(LIB_DIR))
-
-# Import KB modules
-try:
-    from kb_search import search_kb
-    from kb_add import add_entry
-    from kb_index import update_index
-    from kb_stats import show_stats
-    from kb_list import list_entries
-    from kb_compound import compound_operation
-except ImportError as e:
-    print(f"Error: Could not import KB modules: {e}")
-    print(f"Make sure all required files are in {LIB_DIR}")
-    sys.exit(1)
-
-
-class Colors:
-    """ANSI color codes that work cross-platform"""
-    RESET = '\033[0m'
-    BOLD = '\033[1m'
-    
-    # Foreground colors
-    BLACK = '\033[30m'
-    RED = '\033[31m'
-    GREEN = '\033[32m'
-    YELLOW = '\033[33m'
-    BLUE = '\033[34m'
-    MAGENTA = '\033[35m'
-    CYAN = '\033[36m'
-    WHITE = '\033[37m'
-    
-    # Background colors
-    BG_BLACK = '\033[40m'
-    BG_RED = '\033[41m'
-    BG_GREEN = '\033[42m'
-    BG_YELLOW = '\033[43m'
-    BG_BLUE = '\033[44m'
-    BG_MAGENTA = '\033[45m'
-    BG_CYAN = '\033[46m'
-    BG_WHITE = '\033[47m'
-    
-    @staticmethod
-    def enable_windows_colors():
-        """Enable ANSI colors on Windows"""
-        if platform.system() == 'Windows':
-            try:
-                import ctypes
-                kernel32 = ctypes.windll.kernel32
-                kernel32.SetConsoleMode(kernel32.GetStdHandle(-11), 7)
-            except:
-                pass
-
-
-def print_header():
-    """Print CLI header"""
-    Colors.enable_windows_colors()
-    print(f"{Colors.CYAN}{Colors.BOLD}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━{Colors.RESET}")
-    print(f"{Colors.CYAN}{Colors.BOLD}📚 Knowledge Base - Command Line Interface{Colors.RESET}")
-    print(f"{Colors.MAGENTA}   🧠 Integrated with Neo4j Brain{Colors.RESET}")
-    print(f"{Colors.CYAN}{Colors.BOLD}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━{Colors.RESET}")
-    print()
-
-
-def print_help():
-    """Print help message"""
-    print_header()
-    print(f"{Colors.WHITE}{Colors.BOLD}Usage:{Colors.RESET} kb [command] [args]")
-    print()
-    print(f"{Colors.YELLOW}{Colors.BOLD}Commands:{Colors.RESET}")
-    print()
-    print(f"  {Colors.WHITE}search <term>{Colors.RESET}        🔍 Search knowledge base")
-    print(f"                          Example: kb search 'react hydration'")
-    print()
-    print(f"  {Colors.WHITE}add{Colors.RESET}                  ➕ Add new entry (interactive)")
-    print(f"                          Example: kb add")
-    print()
-    print(f"  {Colors.WHITE}index{Colors.RESET}                📇 Update INDEX.md")
-    print(f"                          Example: kb index")
-    print()
-    print(f"  {Colors.WHITE}stats{Colors.RESET}                📊 Show statistics")
-    print(f"                          Example: kb stats")
-    print()
-    print(f"  {Colors.WHITE}list [category]{Colors.RESET}      📋 List all entries (optional: by category)")
-    print(f"                          Example: kb list bugs")
-    print()
-    print(f"  {Colors.WHITE}recent [n]{Colors.RESET}           📅 Show recent entries (default: 10)")
-    print(f"                          Example: kb recent 5")
-    print()
-    print(f"  {Colors.MAGENTA}{Colors.BOLD}compound <action>{Colors.RESET}    🧠 Compound mode with Neo4j integration")
-    print(f"                          Example: kb compound search 'oauth'")
-    print()
-    print(f"  {Colors.WHITE}help{Colors.RESET}                 ❓ Show this help")
-    print()
-    print(f"{Colors.MAGENTA}{Colors.BOLD}Compound Actions:{Colors.RESET}")
-    print(f"  compound search <term>  - Search both file system and Neo4j brain")
-    print(f"  compound add            - Add entry and sync to Neo4j")
-    print(f"  compound sync           - Full sync to Neo4j brain")
-    print(f"  compound query <term>   - Intelligent Neo4j query")
-    print(f"  compound stats          - Show compound system health")
-    print()
-    print(f"{Colors.YELLOW}{Colors.BOLD}Examples:{Colors.RESET}")
-    print(f"  kb search oauth")
-    print(f"  {Colors.MAGENTA}kb compound search oauth{Colors.RESET}")
-    print(f"  kb add")
-    print(f"  {Colors.MAGENTA}kb compound add{Colors.RESET}")
-    print(f"  kb stats")
-    print()
-    print(f"{Colors.CYAN}{Colors.BOLD}💡 Quick Start:{Colors.RESET}")
-    print(f"   1. Search before solving: {Colors.MAGENTA}kb compound search 'your problem'{Colors.RESET}")
-    print(f"   2. Add after solving: {Colors.MAGENTA}kb compound add{Colors.RESET}")
-    print(f"   3. Sync to brain: {Colors.MAGENTA}kb compound sync{Colors.RESET}")
-    print()
-    print(f"{Colors.MAGENTA}{Colors.BOLD}🧠 Neo4j Brain:{Colors.RESET}")
-    print(f"   The compound mode connects KB to Neo4j for intelligent")
-    print(f"   relationship mapping and contextual queries")
-    print()
-
-
-def main():
-    """Main CLI entry point"""
-    Colors.enable_windows_colors()
-    
-    # Parse arguments
-    parser = argparse.ArgumentParser(
-        description='Knowledge Base CLI',
-        add_help=False
-    )
-    parser.add_argument('command', nargs='?', default='help')
-    parser.add_argument('args', nargs='*')
-    
-    args = parser.parse_args()
-    command = args.command.lower()
-    command_args = args.args
-    
-    try:
-        # Execute command
-        if command == 'help' or command == '-h' or command == '--help':
-            print_help()
-        
-        elif command == 'search':
-            if not command_args:
-                print(f"{Colors.RED}❌ Search term required!{Colors.RESET}")
-                print(f"{Colors.YELLOW}Usage: kb search 'term'{Colors.RESET}")
-                sys.exit(1)
-            search_term = ' '.join(command_args)
-            search_kb(search_term)
-        
-        elif command == 'add':
-            add_entry()
-        
-        elif command == 'index':
-            update_index()
-        
-        elif command == 'stats':
-            show_stats()
-        
-        elif command == 'list':
-            category = command_args[0] if command_args else None
-            list_entries(category)
-        
-        elif command == 'recent':
-            count = int(command_args[0]) if command_args else 10
-            list_entries(recent=count)
-        
-        elif command == 'compound':
-            if not command_args:
-                print(f"{Colors.RED}❌ Compound action required!{Colors.RESET}")
-                print(f"{Colors.YELLOW}Usage: kb compound [search|add|sync|query|stats]{Colors.RESET}")
-                sys.exit(1)
-            
-            action = command_args[0].lower()
-            action_args = command_args[1:] if len(command_args) > 1 else []
-            
-            if action in ['search', 'query'] and not action_args:
-                print(f"{Colors.RED}❌ Search/Query term required!{Colors.RESET}")
-                sys.exit(1)
-            
-            search_term = ' '.join(action_args) if action_args else None
-            compound_operation(action, search_term)
-        
-        else:
-            print(f"{Colors.RED}❌ Unknown command: {command}{Colors.RESET}")
-            print()
-            print_help()
-            sys.exit(1)
-    
-    except KeyboardInterrupt:
-        print(f"\n{Colors.YELLOW}⚠️  Operation cancelled by user{Colors.RESET}")
-        sys.exit(0)
-    except Exception as e:
-        print(f"{Colors.RED}❌ Error: {e}{Colors.RESET}")
-        import traceback
-        traceback.print_exc()
-        sys.exit(1)
-
-
-if __name__ == '__main__':
-    main()