@sugar-crash-studios/vibe-forge 0.4.0

package/config/agents.json

@@ -0,0 +1,168 @@
+{
+  "_comment": "SINGLE SOURCE OF TRUTH for agent configuration. Used by bash scripts via load_agents_from_json() and Node.js directly. See config/agent-manifest.yaml for rich documentation (non-normative).",
+  "version": "1.1.0",
+  "agents": {
+    "hub": {
+      "name": "Planning Hub",
+      "icon": "⚒️",
+      "role": "Chief Orchestrator",
+      "aliases": ["planning", "master", "forge-master"],
+      "type": "core",
+      "persistent": true,
+      "terminal_tab": 1,
+      "personality_file": "agents/planning-hub/personality.md",
+      "tab_color": "#FF6B35",
+      "description": "Task distribution, progress tracking, agent coordination",
+      "task_types": ["planning", "coordination", "orchestration"]
+    },
+    "temper": {
+      "name": "Temper",
+      "icon": "⚖️",
+      "role": "Code Reviewer",
+      "aliases": ["review", "reviewer", "cr"],
+      "type": "core",
+      "persistent": true,
+      "terminal_tab": 5,
+      "personality_file": "agents/temper/personality.md",
+      "tab_color": "#8B5CF6",
+      "description": "Quality gates, code review, PR approval",
+      "task_types": ["review", "pr", "quality"]
+    },
+    "anvil": {
+      "name": "Anvil",
+      "icon": "🔨",
+      "role": "Frontend Developer",
+      "aliases": ["frontend", "ui", "fe"],
+      "type": "worker",
+      "persistent": true,
+      "terminal_tab": 2,
+      "personality_file": "agents/anvil/personality.md",
+      "tab_color": "#3B82F6",
+      "description": "UI components, React/Vue/Blazor, CSS, client-side logic",
+      "task_types": ["frontend", "component", "ui", "styling", "blazor"]
+    },
+    "furnace": {
+      "name": "Furnace",
+      "icon": "🔥",
+      "role": "Backend Developer",
+      "aliases": ["backend", "api", "be"],
+      "type": "worker",
+      "persistent": true,
+      "terminal_tab": 3,
+      "personality_file": "agents/furnace/personality.md",
+      "tab_color": "#EF4444",
+      "description": "API endpoints, database, server logic, .NET/Node.js services",
+      "task_types": ["backend", "api", "database", "service", "dotnet"]
+    },
+    "crucible": {
+      "name": "Crucible",
+      "icon": "🧪",
+      "role": "Tester / QA",
+      "aliases": ["test", "testing", "qa", "tester"],
+      "type": "worker",
+      "persistent": true,
+      "terminal_tab": 4,
+      "personality_file": "agents/crucible/personality.md",
+      "tab_color": "#10B981",
+      "description": "Test writing, bug hunting, quality validation, xUnit/NUnit/Jest",
+      "task_types": ["test", "qa", "bugfix", "e2e", "xunit"]
+    },
+    "scribe": {
+      "name": "Scribe",
+      "icon": "📜",
+      "role": "Documentation Specialist",
+      "aliases": ["docs", "documentation", "doc"],
+      "type": "worker",
+      "persistent": false,
+      "personality_file": "agents/scribe/personality.md",
+      "tab_color": "#F59E0B",
+      "description": "Docs, README, API documentation, inline comments",
+      "task_types": ["docs", "readme", "api-docs", "comments"]
+    },
+    "herald": {
+      "name": "Herald",
+      "icon": "📯",
+      "role": "Release Manager",
+      "aliases": ["release", "deploy", "deployment"],
+      "type": "worker",
+      "persistent": false,
+      "personality_file": "agents/herald/personality.md",
+      "tab_color": "#EC4899",
+      "description": "Versioning, changelog, deployment, release notes",
+      "task_types": ["release", "deploy", "changelog", "version"]
+    },
+    "ember": {
+      "name": "Ember",
+      "icon": "⚙️",
+      "role": "DevOps Engineer",
+      "aliases": ["devops", "ops", "infra", "infrastructure"],
+      "type": "specialist",
+      "persistent": false,
+      "personality_file": "agents/ember/personality.md",
+      "tab_color": "#F97316",
+      "description": "Infrastructure, CI/CD, Docker, Azure, .NET deployment",
+      "task_types": ["devops", "infra", "ci-cd", "docker", "azure"]
+    },
+    "aegis": {
+      "name": "Aegis",
+      "icon": "🔒",
+      "role": "Security Specialist",
+      "aliases": ["security", "sec", "appsec"],
+      "type": "specialist",
+      "persistent": false,
+      "personality_file": "agents/aegis/personality.md",
+      "tab_color": "#06B6D4",
+      "description": "Security audit, vulnerability assessment, hardening",
+      "task_types": ["security", "audit", "vulnerability"],
+      "requires_approval": true
+    },
+    "architect": {
+      "name": "Architect",
+      "icon": "🏛️",
+      "role": "System Architect",
+      "aliases": ["arch", "sage"],
+      "type": "advisor",
+      "persistent": false,
+      "personality_file": "agents/architect/personality.md",
+      "tab_color": "#6366F1",
+      "description": "System design, technical decisions, architecture review",
+      "task_types": ["architecture", "design", "tech-debt"]
+    },
+    "pixel": {
+      "name": "Pixel",
+      "icon": "🎨",
+      "role": "UX Designer",
+      "aliases": ["ux", "ui-design", "user-experience"],
+      "type": "specialist",
+      "persistent": false,
+      "personality_file": "agents/pixel/personality.md",
+      "tab_color": "#D946EF",
+      "description": "User experience, interaction design, wireframes, accessibility",
+      "task_types": ["ux", "wireframe", "design", "accessibility", "user-research"]
+    },
+    "oracle": {
+      "name": "Oracle",
+      "icon": "🔮",
+      "role": "Product Owner / Requirements Analyst",
+      "aliases": ["product", "po", "requirements", "req", "analyst"],
+      "type": "advisor",
+      "persistent": false,
+      "personality_file": "agents/oracle/personality.md",
+      "tab_color": "#FBBF24",
+      "description": "Product requirements, epics, user stories, acceptance criteria, research",
+      "task_types": ["product", "requirements", "epics", "stories", "research", "planning"]
+    },
+    "loki": {
+      "name": "Loki",
+      "icon": "🎭",
+      "role": "Lateral Thinker, Assumption Challenger",
+      "aliases": ["trickster", "contrarian", "challenge", "brainstorm"],
+      "type": "advisor",
+      "persistent": false,
+      "personality_file": "agents/loki/personality.md",
+      "tab_color": "#7C3AED",
+      "description": "Challenges assumptions, lateral thinking, brainstorm provocations",
+      "task_types": ["brainstorm", "design-review", "planning", "postmortem"]
+    }
+  }
+}

package/config/task-template.md

@@ -0,0 +1,159 @@
+---
+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 - epic_num.story_num format (e.g. 2.3)
+isolation: none  # none | worktree - use worktree for risky or experimental changes
+---
+
+# 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}
+
+## Dev Notes
+<!-- Architecture guardrails, relevant patterns, tech constraints - filled by Hub/Architect before assignment -->
+<!-- Example:
+- Auth uses JWT with refresh tokens - follow the pattern in src/middleware/auth.ts
+- All DB access goes through the repository layer in src/repositories/ - no raw queries in controllers
+- Error responses must use the Result<T,E> pattern from src/utils/result.ts
+- Relevant architecture decisions: context/architecture.md#section-3
+-->
+
+---
+
+# Acceptance Criteria
+
+<!-- Number each criterion - agents link tasks to AC numbers, Sentinel audits each one -->
+1. {CRITERION_1}
+2. {CRITERION_2}
+3. {CRITERION_3}
+
+---
+
+# Tasks / Subtasks
+
+<!-- Each task mapped to one or more AC numbers - enables per-criterion review audit -->
+- [ ] Task 1 (AC: #1, #2)
+  - [ ] Subtask 1.1
+  - [ ] Subtask 1.2
+- [ ] Task 2 (AC: #3)
+  - [ ] Subtask 2.1
+
+---
+
+# Agent Instructions
+
+<!-- Specific instructions for the assigned agent -->
+{AGENT_TYPE}: {SPECIFIC_INSTRUCTIONS}
+
+**Boundaries:**
+- DO modify: {ALLOWED_PATHS}
+- DO NOT modify: {FORBIDDEN_PATHS}
+
+**When to STOP and write to tasks/attention/:**
+- Required package/dependency not in project - get approval before adding
+- 3 consecutive failures on the same test
+- Acceptance criteria are ambiguous or contradictory
+- Schema or migration change would affect live data
+- Security concern requires Aegis review
+
+**On Completion:**
+1. Verify all Definition of Done items below are checked
+2. Run relevant tests - confirm they pass
+3. Move this file to `/tasks/completed/`
+4. Fill in completion summary below
+
+---
+
+# Definition of Done
+
+<!-- All items must be checked before setting ready_for_review: true -->
+<!-- Crucible audits this list before approving any task -->
+
+**Implementation**
+- [ ] All acceptance criteria satisfied (verify each numbered AC individually)
+- [ ] All tasks and subtasks completed
+- [ ] Edge cases handled — not just the happy path
+- [ ] No TODO/FIXME left in new code without a linked tracking task
+- [ ] No dead code or commented-out blocks committed
+
+**Testing**
+- [ ] Unit tests written for new functionality
+- [ ] Existing tests still pass (full suite, not just new tests)
+- [ ] No linting errors
+- [ ] Integration tests updated if this touches a service boundary
+- [ ] Negative cases tested (invalid input, error paths, boundary conditions)
+- [ ] No test is skipped or marked `.only` without a comment explaining why
+
+**Documentation**
+- [ ] File list complete in completion summary (every file touched)
+- [ ] Inline comments where logic is non-obvious
+- [ ] API contract documented if this adds or changes an endpoint
+- [ ] Breaking changes noted in completion summary with migration path
+
+**Security** _(if touching auth, data, external APIs, or file I/O)_
+- [ ] No hardcoded secrets or credentials
+- [ ] Input validated at boundaries
+- [ ] Error paths handled explicitly — not swallowed
+- [ ] Least privilege: no permissions broader than necessary
+
+**Database** _(if touching schema or data)_
+- [ ] Migration is reversible (down migration written and tested)
+- [ ] Migration does not destroy existing data without explicit task approval
+- [ ] Queries use parameterized inputs (no string concatenation)
+
+**Handoff**
+- [ ] Completion summary fully filled in (completed_by, files, test counts)
+- [ ] `ready_for_review: true` only when ALL above items are checked
+- [ ] Known limitations or follow-up tasks noted
+
+---
+
+# Output Expected
+
+- [ ] Files created/modified listed in completion summary
+- [ ] Tests passing (include count)
+- [ ] No linting errors
+- [ ] Definition of Done fully checked
+
+---
+
+# Completion Summary
+<!-- Filled by agent on completion -->
+
+```yaml
+completed_by: null
+completed_at: null
+duration_minutes: null
+agent_model: null
+files_modified: []
+files_created: []
+tests_added: 0
+tests_passing: 0
+notes: ""
+blockers_encountered: []
+ready_for_review: false
+```

package/config/task-types.yaml

@@ -0,0 +1,106 @@
+# Vibe Forge Task Types
+# Used by Forge Master for routing decisions
+
+task_types:
+  frontend:
+    agent: anvil
+    description: "UI components, React/Vue/Svelte, CSS, client-side logic"
+    file_patterns:
+      - "src/components/**"
+      - "src/pages/**"
+      - "src/styles/**"
+      - "*.css"
+      - "*.scss"
+
+  backend:
+    agent: furnace
+    description: "API endpoints, server logic, database operations"
+    file_patterns:
+      - "src/api/**"
+      - "src/services/**"
+      - "src/models/**"
+      - "src/middleware/**"
+      - "prisma/**"
+
+  test:
+    agent: crucible
+    description: "Unit tests, integration tests, E2E tests, bug fixes"
+    file_patterns:
+      - "**/*.test.ts"
+      - "**/*.spec.ts"
+      - "tests/**"
+      - "e2e/**"
+
+  docs:
+    agent: scribe
+    description: "Documentation, README, API docs, inline comments"
+    file_patterns:
+      - "docs/**"
+      - "*.md"
+      - "openapi.yaml"
+
+  review:
+    agent: sentinel
+    description: "Code review, quality checks, PR review"
+    auto_assign: true  # All completed tasks auto-route here
+
+  release:
+    agent: herald
+    description: "Version bumps, changelog, deployment, release notes"
+    file_patterns:
+      - "CHANGELOG.md"
+      - "package.json (version)"
+      - ".github/workflows/**"
+
+  devops:
+    agent: ember
+    description: "Infrastructure, CI/CD, Docker, server management"
+    file_patterns:
+      - "Dockerfile"
+      - "docker-compose.yaml"
+      - ".github/workflows/**"
+      - "terraform/**"
+      - "k8s/**"
+
+  security:
+    agent: aegis
+    description: "Security audit, vulnerability fixes, auth hardening"
+    requires_approval: true  # Needs Planning Hub sign-off
+
+priorities:
+  critical:
+    sla_hours: 0
+    description: "Blocking other work, production issue"
+
+  high:
+    sla_hours: 8
+    description: "Sprint commitment, needed today"
+
+  medium:
+    sla_hours: 40
+    description: "Sprint goal, this sprint"
+
+  low:
+    sla_hours: null
+    description: "Nice to have, when available"
+
+complexity:
+  trivial:
+    estimated_minutes: 15
+    description: "Config change, typo fix"
+
+  low:
+    estimated_minutes: 30
+    description: "Simple function, minor feature"
+
+  medium:
+    estimated_minutes: 60
+    description: "New component, API endpoint"
+
+  high:
+    estimated_minutes: 180
+    description: "Complex feature, refactoring"
+
+  unknown:
+    estimated_minutes: null
+    description: "Needs investigation"

package/context/agent-status/aegis.json

@@ -0,0 +1,7 @@
+{
+  "agent": "aegis",
+  "status": "idle",
+  "task": null,
+  "message": "Efficiency wins shipped: WAL mode + task list cache. 132 tests green.",
+  "updated": "2026-04-01T00:00:04Z"
+}

package/context/agent-status/anvil.json

@@ -0,0 +1,7 @@
+{
+  "agent": "anvil",
+  "status": "idle",
+  "task": null,
+  "message": "Dashboard MVP frontend complete",
+  "updated": "2026-01-16T22:15:00Z"
+}

package/context/agent-status/architect.json

@@ -0,0 +1,7 @@
+{
+  "agent": "architect",
+  "status": "idle",
+  "task": "",
+  "message": "Completed ARCH-001 and ARCH-002 - agent config consolidated, architecture documented",
+  "updated": "2026-01-16T11:10:00Z"
+}

package/context/agent-status/crucible.json

@@ -0,0 +1,7 @@
+{
+  "agent": "crucible",
+  "status": "idle",
+  "task": null,
+  "message": "Completed review-bmad-crucible. 10 quality gaps identified.",
+  "updated": "2026-03-31T00:00:00Z"
+}

package/context/agent-status/ember.json

@@ -0,0 +1,7 @@
+{
+  "agent": "ember",
+  "status": "idle",
+  "task": null,
+  "message": "review-bmad-ember complete. PR #13 open. 13 gaps identified.",
+  "updated": "2026-03-31T00:10:00Z"
+}

package/context/agent-status/furnace.json

@@ -0,0 +1,7 @@
+{
+  "agent": "furnace",
+  "status": "idle",
+  "task": null,
+  "message": "Completed review-bmad-furnace. Findings written to tasks/review/bmad-review-furnace.md",
+  "updated": "2026-03-31T00:00:00Z"
+}

package/context/agent-status/loki.json

@@ -0,0 +1,7 @@
+{
+  "agent": "loki",
+  "status": "idle",
+  "task": null,
+  "message": "Standing by. Invoke me when you want someone to question the plan.",
+  "updated": "2026-04-03T00:00:00Z"
+}

package/context/agent-status/oracle.json

@@ -0,0 +1,7 @@
+{
+  "agent": "oracle",
+  "status": "idle",
+  "task": null,
+  "message": "Online. Ready to define requirements and validate direction.",
+  "updated": "2026-04-03T00:00:00Z"
+}

package/context/agent-status/pixel.json

@@ -0,0 +1,7 @@
+{
+  "agent": "pixel",
+  "status": "idle",
+  "task": null,
+  "message": "Completed BMAD vs Vibe Forge UX review. Findings in tasks/review/bmad-review-pixel.md",
+  "updated": "2026-03-31T00:00:00Z"
+}

package/context/agent-status/planning-hub.json

@@ -0,0 +1,7 @@
+{
+  "agent": "planning-hub",
+  "status": "idle",
+  "task": null,
+  "message": "Completed git workflow implementation",
+  "updated": "2026-01-16T12:00:00Z"
+}

package/context/agent-status/scribe.json

@@ -0,0 +1,7 @@
+{
+  "agent": "scribe",
+  "status": "idle",
+  "task": null,
+  "message": "Task review-bmad-scribe complete. PR #12 open. Ready for work.",
+  "updated": "2026-03-31T06:35:00Z"
+}

package/context/agent-status/temper.json

@@ -0,0 +1,7 @@
+{
+  "agent": "temper",
+  "status": "idle",
+  "task": null,
+  "message": "BMAD review complete - 14 issues found (5 critical). See tasks/review/bmad-review-sentinel.md",
+  "updated": "2026-03-31T00:00:00Z"
+}