vibe-forge 0.1.0

package/bin/forge.sh

@@ -0,0 +1,367 @@
+#!/usr/bin/env bash
+#
+# Vibe Forge - Main Launcher
+# Starts the Planning Hub or specific worker agents
+#
+# Usage:
+#   forge              - Start Planning Hub (main session)
+#   forge init         - Initialize Vibe Forge
+#   forge start <agent> - Start a specific worker agent
+#   forge spawn <agent> - Spawn agent in new terminal window/tab
+#   forge status       - Show forge status
+#   forge test         - Validate setup
+#   forge daemon       - Start/stop the background daemon
+#   forge help         - Show help
+#
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FORGE_ROOT="$(dirname "$SCRIPT_DIR")"
+CONFIG_FILE="$FORGE_ROOT/.forge/config.json"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# =============================================================================
+# Helper Functions
+# =============================================================================
+
+load_config() {
+    if [[ ! -f "$CONFIG_FILE" ]]; then
+        echo -e "${RED}Error: Vibe Forge not initialized.${NC}"
+        echo "Run 'forge init' first."
+        exit 1
+    fi
+
+    # Parse JSON config (basic extraction)
+    PLATFORM=$(grep -o '"platform": *"[^"]*"' "$CONFIG_FILE" | cut -d'"' -f4)
+    GIT_BASH_PATH=$(grep -o '"git_bash_path": *"[^"]*"' "$CONFIG_FILE" | cut -d'"' -f4)
+
+    # Set environment for Windows
+    # Claude Code on Windows needs backslashes in the path
+    if [[ "$PLATFORM" == "windows" && -n "$GIT_BASH_PATH" ]]; then
+        # Convert forward slashes to backslashes for Windows
+        GIT_BASH_PATH_WIN="${GIT_BASH_PATH//\//\\}"
+        export CLAUDE_CODE_GIT_BASH_PATH="$GIT_BASH_PATH_WIN"
+
+        # Add common Windows paths that Git Bash might miss
+        # npm global path (where claude is typically installed)
+        NPM_PATH="/c/Users/$USER/AppData/Roaming/npm"
+        if [[ -d "$NPM_PATH" ]] && [[ ":$PATH:" != *":$NPM_PATH:"* ]]; then
+            export PATH="$NPM_PATH:$PATH"
+        fi
+
+        # Also try with USERPROFILE
+        if [[ -n "$USERPROFILE" ]]; then
+            NPM_PATH_ALT="$USERPROFILE/AppData/Roaming/npm"
+            NPM_PATH_ALT="${NPM_PATH_ALT//\\//}"  # Convert backslashes
+            if [[ -d "$NPM_PATH_ALT" ]] && [[ ":$PATH:" != *":$NPM_PATH_ALT:"* ]]; then
+                export PATH="$NPM_PATH_ALT:$PATH"
+            fi
+        fi
+    fi
+}
+
+get_personality_path() {
+    local agent="$1"
+    local personality_file=""
+
+    case "$agent" in
+        "hub"|"planning"|"master"|"forge-master"|"")
+            personality_file="$FORGE_ROOT/agents/planning-hub/personality.md"
+            ;;
+        "anvil")
+            personality_file="$FORGE_ROOT/agents/anvil/personality.md"
+            ;;
+        "furnace")
+            personality_file="$FORGE_ROOT/agents/furnace/personality.md"
+            ;;
+        "crucible")
+            personality_file="$FORGE_ROOT/agents/crucible/personality.md"
+            ;;
+        "sentinel")
+            personality_file="$FORGE_ROOT/agents/sentinel/personality.md"
+            ;;
+        "scribe")
+            personality_file="$FORGE_ROOT/agents/scribe/personality.md"
+            ;;
+        "herald")
+            personality_file="$FORGE_ROOT/agents/herald/personality.md"
+            ;;
+        "ember")
+            personality_file="$FORGE_ROOT/agents/ember/personality.md"
+            ;;
+        "aegis")
+            personality_file="$FORGE_ROOT/agents/aegis/personality.md"
+            ;;
+        *)
+            echo -e "${RED}Unknown agent: $agent${NC}"
+            echo "Available agents: anvil, furnace, crucible, sentinel, scribe, herald, ember, aegis"
+            exit 1
+            ;;
+    esac
+
+    if [[ ! -f "$personality_file" ]]; then
+        echo -e "${RED}Error: Personality file not found: $personality_file${NC}"
+        exit 1
+    fi
+
+    echo "$personality_file"
+}
+
+# =============================================================================
+# Commands
+# =============================================================================
+
+cmd_init() {
+    "$SCRIPT_DIR/forge-setup.sh" "$@"
+}
+
+cmd_start() {
+    local agent="${1:-hub}"
+    load_config
+
+    local personality_path
+    personality_path=$(get_personality_path "$agent")
+
+    local agent_name
+    if [[ "$agent" == "hub" || "$agent" == "" ]]; then
+        agent_name="Planning Hub"
+    else
+        agent_name="$agent"
+    fi
+
+    echo -e "${YELLOW}🔥 Starting $agent_name...${NC}"
+    echo ""
+
+    # Build the system prompt from personality file
+    local system_prompt
+    system_prompt=$(cat "$personality_path")
+
+    # Add project context if it exists
+    local project_context="$FORGE_ROOT/context/project-context.md"
+    if [[ -f "$project_context" ]]; then
+        system_prompt="$system_prompt
+
+---
+
+# Project Context
+
+$(cat "$project_context")"
+    fi
+
+    # Add startup instructions based on agent type
+    if [[ "$agent" == "hub" || "$agent" == "planning" || "$agent" == "" ]]; then
+        # Planning Hub startup - Party Mode Team
+        system_prompt="$system_prompt
+
+---
+
+# Startup Instructions
+
+On startup, you MUST immediately display the team assembly welcome as shown in the Startup Behavior section of your personality. Show the forge council members assembling with their icons and roles. Then check for any current work status.
+"
+    else
+        # Worker agent startup
+        system_prompt="$system_prompt
+
+---
+
+# Startup Instructions
+
+On startup: Announce yourself (name, icon, role), check tasks/pending/ and tasks/needs-changes/ for your work, summarize what you find, and ask if you should begin.
+"
+    fi
+
+    # Launch Claude Code with the personality
+    # --dangerously-skip-permissions avoids repeated prompts when starting agents
+    # Use --resume with initial prompt to trigger welcome but stay interactive
+    if [[ "$agent" == "hub" || "$agent" == "planning" || "$agent" == "" ]]; then
+        claude --dangerously-skip-permissions --system-prompt "$system_prompt" "begin"
+    else
+        claude --dangerously-skip-permissions --system-prompt "$system_prompt" "startup"
+    fi
+}
+
+cmd_status() {
+    load_config
+
+    local state_file="$FORGE_ROOT/context/forge-state.yaml"
+
+    echo ""
+    echo -e "${YELLOW}🔥 Forge Status${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    if [[ -f "$state_file" ]]; then
+        cat "$state_file"
+    else
+        echo "No active forge state."
+        echo ""
+        echo "Start the forge with: forge"
+    fi
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+}
+
+cmd_test() {
+    load_config
+
+    echo ""
+    echo -e "${YELLOW}🧪 Testing Vibe Forge setup...${NC}"
+    echo ""
+
+    # Test Claude Code
+    echo "Testing Claude Code..."
+    if claude --version &> /dev/null; then
+        echo -e "${GREEN}✅ Claude Code working${NC}"
+    else
+        echo -e "${RED}❌ Claude Code not working${NC}"
+        exit 1
+    fi
+
+    # Test personality loading
+    echo ""
+    echo "Testing personality loading..."
+    local test_output
+    test_output=$(claude --system-prompt "You are a test. Respond with only: FORGE_TEST_OK" --print "test" 2>&1 | head -1)
+
+    if [[ "$test_output" == *"FORGE_TEST_OK"* || "$test_output" == *"test"* ]]; then
+        echo -e "${GREEN}✅ Personality loading working${NC}"
+    else
+        echo -e "${YELLOW}⚠️  Personality loading may have issues${NC}"
+        echo "   Output: $test_output"
+    fi
+
+    echo ""
+    echo -e "${GREEN}🔥 Setup validated!${NC}"
+}
+
+cmd_spawn() {
+    local agent="${1:-}"
+
+    if [[ -z "$agent" ]]; then
+        echo -e "${RED}Error: No agent specified.${NC}"
+        echo "Usage: forge spawn <agent>"
+        echo ""
+        echo "Available agents: anvil, furnace, crucible, sentinel, scribe, herald, ember, aegis"
+        exit 1
+    fi
+
+    "$SCRIPT_DIR/forge-spawn.sh" "$agent"
+}
+
+cmd_daemon() {
+    local action="${1:-status}"
+
+    case "$action" in
+        "start")
+            echo "Starting forge daemon..."
+            "$SCRIPT_DIR/forge-daemon.sh" start
+            ;;
+        "stop")
+            echo "Stopping forge daemon..."
+            "$SCRIPT_DIR/forge-daemon.sh" stop
+            ;;
+        "status")
+            "$SCRIPT_DIR/forge-daemon.sh" status
+            ;;
+        "notifications"|"notify")
+            shift
+            "$SCRIPT_DIR/forge-daemon.sh" notifications "$@"
+            ;;
+        "clear")
+            "$SCRIPT_DIR/forge-daemon.sh" clear
+            ;;
+        *)
+            echo "Usage: forge daemon [start|stop|status|notifications|clear]"
+            ;;
+    esac
+}
+
+cmd_help() {
+    echo ""
+    echo -e "${YELLOW}🔥 Vibe Forge${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "Usage: forge [command] [options]"
+    echo ""
+    echo "Commands:"
+    echo "  (none)              Start the Planning Hub (main session)"
+    echo "  init                Initialize Vibe Forge for this project"
+    echo "  start <agent>       Start a specific worker agent (in current terminal)"
+    echo "  spawn <agent>       Spawn agent in new terminal window/tab"
+    echo "  status              Show current forge status"
+    echo "  test                Validate setup is working"
+    echo "  daemon <action>     Manage background daemon (start|stop|status|notifications|clear)"
+    echo "  help                Show this help message"
+    echo ""
+    echo "Agents:"
+    echo "  anvil               Frontend Developer"
+    echo "  furnace             Backend Developer"
+    echo "  crucible            Tester / QA"
+    echo "  sentinel            Code Reviewer"
+    echo "  scribe              Documentation"
+    echo "  herald              Release Manager"
+    echo "  ember               DevOps"
+    echo "  aegis               Security"
+    echo ""
+    echo "Examples:"
+    echo "  forge               Start Planning Hub"
+    echo "  forge init          Initialize for new project"
+    echo "  forge start anvil   Start Anvil (frontend) agent"
+    echo "  forge status        Check current status"
+    echo ""
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+
+main() {
+    local command="${1:-}"
+
+    case "$command" in
+        "init")
+            shift
+            cmd_init "$@"
+            ;;
+        "start")
+            shift
+            cmd_start "$@"
+            ;;
+        "spawn")
+            shift
+            cmd_spawn "$@"
+            ;;
+        "status")
+            cmd_status
+            ;;
+        "test")
+            cmd_test
+            ;;
+        "daemon")
+            shift
+            cmd_daemon "$@"
+            ;;
+        "help"|"--help"|"-h")
+            cmd_help
+            ;;
+        "")
+            # Default: start Planning Hub
+            cmd_start "hub"
+            ;;
+        *)
+            echo -e "${RED}Unknown command: $command${NC}"
+            echo "Run 'forge help' for usage."
+            exit 1
+            ;;
+    esac
+}
+
+main "$@"

package/config/agent-manifest.yaml

@@ -0,0 +1,230 @@
+# Vibe Forge Agent Manifest
+# Defines all agents, their roles, and configuration
+
+version: "1.0.0"
+
+# Core Agents - Always available
+core_agents:
+  forge-master:
+    name: "Forge Master"
+    icon: "⚒️"
+    role: "Chief Orchestrator"
+    type: orchestrator
+    persistent: true
+    terminal_tab: 1
+    description: "Task distribution, progress tracking, agent coordination"
+    source: "bmad-master"
+    personality: "/agents/forge-master/personality.md"
+    capabilities: "/agents/forge-master/capabilities.md"
+    context_template: "/agents/forge-master/context-template.md"
+
+  sentinel:
+    name: "Sentinel"
+    icon: "🛡️"
+    role: "Code Reviewer"
+    type: reviewer
+    persistent: true
+    terminal_tab: 5
+    description: "Quality gates, code review, PR approval"
+    source: "new"
+    personality: "/agents/sentinel/personality.md"
+    communication_style: "Adversarial but constructive. Finds problems others miss. Never says 'looks good' without evidence."
+    principles:
+      - "Every PR hides at least one issue - find it"
+      - "Review for correctness first, style second"
+      - "Security and performance are non-negotiable"
+      - "Praise specific good decisions, not general quality"
+
+# Worker Agents - Spun up per task or persistent
+worker_agents:
+  anvil:
+    name: "Anvil"
+    icon: "🔨"
+    role: "Frontend Developer"
+    type: worker
+    persistent: true
+    terminal_tab: 2
+    description: "UI components, React/Vue, CSS, client-side logic"
+    source: "dev (Amelia)"
+    task_types: ["frontend", "component", "ui", "styling"]
+    communication_style: "Ultra-succinct. Speaks in file paths and component names. No fluff, all precision."
+    principles:
+      - "Component isolation - props in, events out"
+      - "Accessibility is not optional"
+      - "Test user interactions, not implementation"
+      - "Performance budget is sacred"
+
+  furnace:
+    name: "Furnace"
+    icon: "🔥"
+    role: "Backend Developer"
+    type: worker
+    persistent: true
+    terminal_tab: 3
+    description: "API endpoints, database, server logic, services"
+    source: "dev (Amelia)"
+    task_types: ["backend", "api", "database", "service"]
+    communication_style: "Terse and technical. Thinks in data flows and error states. Documents edge cases obsessively."
+    principles:
+      - "API contracts are promises - don't break them"
+      - "Handle errors explicitly, never swallow"
+      - "Database migrations are one-way streets"
+      - "Log what matters, not everything"
+
+  crucible:
+    name: "Crucible"
+    icon: "🧪"
+    role: "Tester / QA"
+    type: worker
+    persistent: true
+    terminal_tab: 4
+    description: "Test writing, bug hunting, quality validation"
+    source: "tea (Murat)"
+    task_types: ["test", "qa", "bugfix", "e2e"]
+    communication_style: "Risk-focused. Speaks in test scenarios and edge cases. Celebrates finding bugs."
+    principles:
+      - "If it's not tested, it's broken"
+      - "Test behavior, not implementation"
+      - "Flaky tests are worse than no tests"
+      - "Bug reports need reproduction steps"
+
+  scribe:
+    name: "Scribe"
+    icon: "📜"
+    role: "Documentation Specialist"
+    type: worker
+    persistent: false
+    description: "Docs, README, API documentation, inline comments"
+    source: "tech-writer (Paige)"
+    task_types: ["docs", "readme", "api-docs", "comments"]
+    communication_style: "Patient educator. Makes complex simple. Celebrates clarity."
+    principles:
+      - "Documentation is teaching"
+      - "Examples > explanations"
+      - "Keep docs near code"
+      - "Update docs with code changes"
+
+  herald:
+    name: "Herald"
+    icon: "📯"
+    role: "Release Manager"
+    type: worker
+    persistent: false
+    description: "Versioning, changelog, deployment, release notes"
+    source: "new"
+    task_types: ["release", "deploy", "changelog", "version"]
+    communication_style: "Ceremonial and precise. Treats releases as milestones. Documents everything."
+    principles:
+      - "Semantic versioning is law"
+      - "Changelogs tell stories"
+      - "Release notes are for users"
+      - "Rollback plans are mandatory"
+
+# Planning Hub Agents - Run in main terminal with Adam
+planning_agents:
+  sage:
+    name: "Sage"
+    icon: "🏛️"
+    role: "System Architect"
+    type: advisor
+    description: "System design, tech decisions, architecture"
+    source: "architect (Winston)"
+    communication_style: "Calm and pragmatic. Balances 'what could be' with 'what should be'."
+    principles:
+      - "Simple solutions that scale"
+      - "Boring technology for stability"
+      - "Every decision connects to business value"
+
+  oracle:
+    name: "Oracle"
+    icon: "🔮"
+    role: "Requirements Analyst"
+    type: advisor
+    description: "Requirements gathering, specifications, analysis"
+    source: "analyst (Mary)"
+    communication_style: "Excited treasure hunter. Thrilled by patterns. Structures with precision."
+    principles:
+      - "Requirements have root causes"
+      - "Stakeholder voices matter"
+      - "Evidence over assumptions"
+
+  quartermaster:
+    name: "Quartermaster"
+    icon: "📋"
+    role: "Product Manager"
+    type: advisor
+    description: "Prioritization, roadmap, product decisions"
+    source: "pm (John)"
+    communication_style: "Asks WHY relentlessly. Data-sharp. Cuts through fluff."
+    principles:
+      - "Ship smallest thing that validates"
+      - "User value over technical elegance"
+      - "Iteration over perfection"
+
+# Optional Specialist Agents - On-demand only
+specialist_agents:
+  ember:
+    name: "Ember"
+    icon: "⚙️"
+    role: "DevOps Engineer"
+    type: specialist
+    persistent: false
+    description: "Infrastructure, CI/CD, Docker, server management"
+    source: "new"
+    task_types: ["devops", "infra", "ci-cd", "docker"]
+    communication_style: "Infrastructure-first thinking. Speaks in pipelines and containers."
+    principles:
+      - "Automate everything repeatable"
+      - "Infrastructure as code"
+      - "Monitoring before shipping"
+
+  aegis:
+    name: "Aegis"
+    icon: "🔒"
+    role: "Security Specialist"
+    type: specialist
+    persistent: false
+    description: "Security audit, vulnerability assessment, hardening"
+    source: "new"
+    task_types: ["security", "audit", "vulnerability"]
+    requires_approval: true
+    communication_style: "Paranoid by design. Assumes breach. Questions everything."
+    principles:
+      - "Defense in depth"
+      - "Least privilege always"
+      - "Security is everyone's job"
+
+# Agent Communication Settings
+communication:
+  method: "file-based"  # file-based | websocket | hybrid
+  task_poll_interval_ms: 1000
+  heartbeat_interval_ms: 5000
+  notification_method: "hybrid"  # File watchers + optional WebSocket
+
+# Terminal Layout (Windows Terminal)
+terminal_layout:
+  tab_1:
+    name: "Forge Master"
+    split: true
+    left: "agent"  # Claude Code session
+    right: "output"  # Command output
+  tab_2:
+    name: "Anvil (Frontend)"
+    split: true
+    left: "agent"
+    right: "output"
+  tab_3:
+    name: "Furnace (Backend)"
+    split: true
+    left: "agent"
+    right: "output"
+  tab_4:
+    name: "Crucible (Testing)"
+    split: true
+    left: "agent"
+    right: "output"
+  tab_5:
+    name: "Sentinel (Review)"
+    split: true
+    left: "agent"
+    right: "output"

package/config/task-template.md

@@ -0,0 +1,87 @@
+---
+id: task-{ID}
+title: "{TITLE}"
+type: {TYPE}  # frontend | backend | test | docs | review | release | devops | security
+priority: {PRIORITY}  # critical | high | medium | low
+status: pending
+assigned_to: null
+blocked_by: []
+depends_on: []
+created: {TIMESTAMP}
+updated: {TIMESTAMP}
+estimated_complexity: {COMPLEXITY}  # trivial | low | medium | high | unknown
+epic: {EPIC_ID}
+story: {STORY_ID}  # optional
+---
+
+# Context
+
+## Parent Epic
+See: /specs/epics/{EPIC_ID}.md
+
+## Relevant Files
+<!-- List ONLY files the agent needs to read or modify -->
+- /path/to/relevant/file.ts (reason: what to do here)
+- /path/to/reference/file.ts (reference only)
+
+## Dependencies
+<!-- Other tasks that must complete first -->
+- task-{DEP_ID} (status: pending|completed)
+
+## Background
+<!-- Brief context the agent needs - keep minimal, reference docs instead -->
+{BACKGROUND}
+
+---
+
+# Acceptance Criteria
+
+<!-- Checkboxes for each requirement - agent marks complete as they work -->
+- [ ] {CRITERION_1}
+- [ ] {CRITERION_2}
+- [ ] {CRITERION_3}
+
+---
+
+# Agent Instructions
+
+<!-- Specific instructions for the assigned agent -->
+{AGENT_TYPE}: {SPECIFIC_INSTRUCTIONS}
+
+**Boundaries:**
+- DO modify: {ALLOWED_PATHS}
+- DO NOT modify: {FORBIDDEN_PATHS}
+- If blocked, write blocker to task file and notify Forge Master
+
+**On Completion:**
+1. Ensure all acceptance criteria checked
+2. Run relevant tests
+3. Move this file to `/tasks/completed/`
+4. Include completion summary below
+
+---
+
+# Output Expected
+
+- [ ] Files created/modified (list paths in completion)
+- [ ] Tests passing (include count)
+- [ ] No linting errors
+- [ ] Completion summary written
+
+---
+
+# Completion Summary
+<!-- Filled by agent on completion -->
+
+```yaml
+completed_by: null
+completed_at: null
+duration_minutes: null
+files_modified: []
+files_created: []
+tests_added: 0
+tests_passing: 0
+notes: ""
+blockers_encountered: []
+ready_for_review: false
+```