@avesta-hq/prevention 0.1.0

package/.avesta/statusLine.js

@@ -0,0 +1,143 @@
+const { existsSync, readFileSync } = require("fs");
+const { join, basename } = require("path");
+
+// ANSI helpers
+const c = {
+  reset: "\x1b[0m",
+  dim: "\x1b[2m",
+  bold: "\x1b[1m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  orange: "\x1b[38;5;208m",
+  red: "\x1b[31m",
+  cyan: "\x1b[36m",
+  magenta: "\x1b[35m",
+  blue: "\x1b[34m",
+  white: "\x1b[37m",
+  blink: "\x1b[5m",
+};
+
+const sep = `${c.dim} │ ${c.reset}`;
+
+function getGitBranch(dir) {
+  try {
+    let d = dir;
+    while (d !== "/") {
+      const headFile = join(d, ".git", "HEAD");
+      if (existsSync(headFile)) {
+        const head = readFileSync(headFile, "utf8").trim();
+        if (head.startsWith("ref: refs/heads/")) return head.slice(16);
+        return head.slice(0, 7);
+      }
+      d = join(d, "..");
+    }
+  } catch (_) {}
+  return "";
+}
+
+function getWorkflowState(dir) {
+  try {
+    const statePath = join(dir, ".avesta", "workflow-state.json");
+    if (existsSync(statePath)) {
+      return JSON.parse(readFileSync(statePath, "utf8"));
+    }
+  } catch (_) {}
+  return null;
+}
+
+let input = "";
+process.stdin.setEncoding("utf8");
+process.stdin.on("data", (chunk) => (input += chunk));
+process.stdin.on("end", () => {
+  try {
+    const data = JSON.parse(input);
+    const model = data.model?.display_name || "Claude";
+    const dir = data.workspace?.current_dir || process.cwd();
+    const remaining = data.context_window?.remaining_percentage;
+
+    const parts = [];
+
+    // 1. Prevention branding
+    parts.push(`${c.cyan}${c.bold}◆ AvestaHQ Prevention${c.reset}`);
+
+    // 2. Git branch
+    const branch = getGitBranch(dir);
+    if (branch) {
+      parts.push(`${c.magenta}${branch}${c.reset}`);
+    }
+
+    // 3. Workflow state
+    const state = getWorkflowState(dir);
+    if (state && state.current_phase) {
+      const phase = state.current_phase.toUpperCase();
+      const gates = state.gates || {};
+      const tdd = state.tdd_state;
+
+      // Phase with color
+      const phaseColors = {
+        IDLE: c.dim,
+        VISION: c.blue,
+        PLAN: c.blue,
+        ATDD: c.yellow,
+        TDD: c.green,
+        DRIVER: c.yellow,
+        REVIEW: c.orange,
+        SHIP: c.cyan,
+      };
+      const phaseColor = phaseColors[phase] || c.white;
+
+      // TDD cycle detail
+      let phaseLabel = phase;
+      if (phase === "TDD" && tdd) {
+        const cycleColors = { red: c.red, green: c.green, refactor: c.yellow };
+        const cycleColor = cycleColors[tdd.cycle] || c.white;
+        phaseLabel = `TDD:${cycleColor}${tdd.cycle.toUpperCase()}${c.reset}`;
+        parts.push(phaseLabel);
+      } else {
+        parts.push(`${phaseColor}${phaseLabel}${c.reset}`);
+      }
+
+      // Gate progress
+      const GATE_ORDER = [
+        "vision_approved", "plan_approved", "atdd_approved",
+        "characterization_complete", "tdd_complete",
+        "driver_complete", "review_approved",
+      ];
+      const changeType = state.change_type || "feature";
+      const CHANGE_TYPE_GATES = {
+        feature: GATE_ORDER,
+        bug_fix: ["plan_approved", "tdd_complete", "review_approved"],
+        enhancement: ["plan_approved", "atdd_approved", "tdd_complete", "driver_complete", "review_approved"],
+        tech_debt: ["plan_approved", "characterization_complete", "tdd_complete", "review_approved"],
+      };
+      const requiredGates = CHANGE_TYPE_GATES[changeType] || GATE_ORDER;
+      const passed = requiredGates.filter((g) => gates[g] === true).length;
+      const total = requiredGates.length;
+
+      const gateColor = passed === total ? c.green : passed > 0 ? c.yellow : c.dim;
+      parts.push(`${gateColor}${passed}/${total} gates${c.reset}`);
+    }
+
+    // 4. Model
+    parts.push(`${c.cyan}${model}${c.reset}`);
+
+    // 5. Context window bar
+    if (remaining != null) {
+      const used = Math.min(100, Math.round(((100 - Math.round(remaining)) / 80) * 100));
+      const totalSegs = 10;
+      const filled = Math.round((used / 100) * totalSegs);
+      const bar = "\u2593".repeat(filled) + "\u2591".repeat(totalSegs - filled);
+
+      let color;
+      if (used < 63) color = c.green;
+      else if (used < 81) color = c.yellow;
+      else if (used < 95) color = c.orange;
+      else color = `${c.blink}${c.red}`;
+
+      const label = used >= 95 ? `\u{1F480} ${used}%` : `${used}%`;
+      parts.push(`${color}${bar} ${label}${c.reset}`);
+    }
+
+    process.stdout.write(parts.join(sep));
+  } catch (_) {}
+});

package/.claude/agents/avesta-acceptance-stage.md

@@ -0,0 +1,17 @@
+---
+name: avesta-acceptance-stage
+description: Set up acceptance stage workflow with version-based test execution
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-acceptance-stage
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("acceptance-stage")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-acceptance-writer.md

@@ -0,0 +1,17 @@
+---
+name: avesta-acceptance-writer
+description: Write Executable Specifications in problem-domain language
+model: inherit
+tools: Read, Write, Edit, Glob, Grep
+maxTurns: 25
+---
+
+# avesta-acceptance-writer
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("acceptance-writer")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-bug-fixer.md

@@ -0,0 +1,17 @@
+---
+name: avesta-bug-fixer
+description: Bug fix workflow - reproduce, failing test, fix, verify
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-bug-fixer
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("bug-fixer")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-commit-stage.md

@@ -0,0 +1,17 @@
+---
+name: avesta-commit-stage
+description: Set up commit stage CI/CD pipeline with test pyramid enforcement
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-commit-stage
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("commit-stage")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-committer.md

@@ -0,0 +1,17 @@
+---
+name: avesta-committer
+description: Create git commits following conventional commit standards
+model: haiku
+tools: Read, Bash, Glob, Grep
+maxTurns: 10
+---
+
+# avesta-committer
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("committer")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-cycle-runner.md

@@ -0,0 +1,17 @@
+---
+name: avesta-cycle-runner
+description: Execute complete TDD red-green-refactor cycles for feature implementation
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep, Task
+maxTurns: 50
+---
+
+# avesta-cycle-runner
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("cycle-runner")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-dependency-reviewer.md

@@ -0,0 +1,17 @@
+---
+name: avesta-dependency-reviewer
+description: Review dependencies and generate gradual update plan
+model: inherit
+tools: Read, Bash, Glob, Grep
+maxTurns: 20
+---
+
+# avesta-dependency-reviewer
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("dependency-reviewer")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-dora-init.md

@@ -0,0 +1,17 @@
+---
+name: avesta-dora-init
+description: Initialize DORA metrics tracking for the project
+model: haiku
+tools: Read, Write, Bash
+maxTurns: 15
+---
+
+# avesta-dora-init
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("dora-init")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-dora-reporter.md

@@ -0,0 +1,17 @@
+---
+name: avesta-dora-reporter
+description: Display DORA metrics report for the project
+model: haiku
+tools: Read, Bash, Glob, Grep
+maxTurns: 15
+---
+
+# avesta-dora-reporter
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("dora-reporter")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-driver-builder.md

@@ -0,0 +1,17 @@
+---
+name: avesta-driver-builder
+description: Implement Protocol Driver for acceptance tests
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-driver-builder
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("driver-builder")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-dsl-builder.md

@@ -0,0 +1,17 @@
+---
+name: avesta-dsl-builder
+description: Implement Domain Specific Language for acceptance tests
+model: inherit
+tools: Read, Write, Edit, Glob, Grep
+maxTurns: 25
+---
+
+# avesta-dsl-builder
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("dsl-builder")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-enhancer.md

@@ -0,0 +1,17 @@
+---
+name: avesta-enhancer
+description: Enhancement workflow - plan, ATDD, TDD, driver, review
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-enhancer
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("enhancer")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-green.md

@@ -0,0 +1,17 @@
+---
+name: avesta-green
+description: TDD Green Phase - Write MINIMAL code to pass the failing test
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 25
+---
+
+# avesta-green
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("green")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-help.md

@@ -0,0 +1,31 @@
+---
+name: avesta-help
+description: Show Prevention status, available commands, and next steps
+model: haiku
+tools: Read, Glob, Grep
+maxTurns: 5
+---
+
+# avesta-help
+
+Show the current Prevention workflow status, available commands, and next steps.
+
+## Steps
+
+1. Call `avesta_get_status()` to get the current workflow state
+2. Display the `display_banner` from the response verbatim in a code block
+3. Display a formatted summary following the format in the `/avesta-help` command file
+
+### If NOT initialized:
+
+Show getting started instructions with `/avesta-init`, `/vision`, `/plan` and change type shortcuts (`/bug-fix`, `/enhance`, `/tech-debt`).
+
+### If initialized:
+
+Show:
+- Current phase, feature, change type, and mode
+- Gate status (only gates required for the current change type)
+- Next action
+- Phase-specific available commands
+
+You are operating as a specialized Prevention. Use only the MCP tools listed above.

package/.claude/agents/avesta-init.md

@@ -0,0 +1,17 @@
+---
+name: avesta-init
+description: Initialize Prevention workflow tracking for a project
+model: haiku
+tools: Read, Write, Bash, Glob
+maxTurns: 15
+---
+
+# avesta-init
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("init")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-layer-worker.md

@@ -0,0 +1,27 @@
+---
+name: avesta-layer-worker
+description: Implement a single Clean Architecture layer with TDD (all tests first, then all code)
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-layer-worker
+
+You implement a SINGLE Clean Architecture layer using the Layer approach (all tests first, then all code, then refactor).
+
+## Setup
+
+1. Extract LAYER and PROJECT_TYPE from your task prompt:
+   - LAYER: one of `domain`, `application`, `infrastructure`, `presentation`
+   - PROJECT_TYPE: one of `backend`, `frontend` (default: `backend`)
+
+2. Call `avesta_get_prompt("layer-worker", { tdd_state: { layer: "<LAYER>", cycle: "red", test_count: 0 }, project_type: "<PROJECT_TYPE>" })` to receive your full instructions
+
+3. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+
+4. Follow the received instructions exactly, applying them to YOUR LAYER ONLY
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt and skills.
+
+**CRITICAL**: You MUST stay within your assigned layer's directory boundaries. Do not create production code in other layers.

package/.claude/agents/avesta-layer.md

@@ -0,0 +1,17 @@
+---
+name: avesta-layer
+description: Implement a full layer - all tests first, then all production code
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 50
+---
+
+# avesta-layer
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("layer")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-mutation-tester.md

@@ -0,0 +1,17 @@
+---
+name: avesta-mutation-tester
+description: Analyze test effectiveness with mutation testing patterns
+model: inherit
+tools: Read, Bash, Glob, Grep
+maxTurns: 25
+---
+
+# avesta-mutation-tester
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("mutation-tester")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-planner.md

@@ -0,0 +1,17 @@
+---
+name: avesta-planner
+description: Create implementation plans using Example Mapping and behavioral analysis
+model: inherit
+tools: Read, Write, Edit, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-planner
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("planner")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-red.md

@@ -0,0 +1,17 @@
+---
+name: avesta-red
+description: TDD Red Phase - Write ONE failing test
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 25
+---
+
+# avesta-red
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("red")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-refactorer.md

@@ -0,0 +1,17 @@
+---
+name: avesta-refactorer
+description: TDD Refactor Phase - Improve code structure while keeping tests green
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 25
+---
+
+# avesta-refactorer
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("refactorer")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-release-stage.md

@@ -0,0 +1,17 @@
+---
+name: avesta-release-stage
+description: Set up release stage CI/CD pipeline with contract verification
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-release-stage
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("release-stage")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-reviewer.md

@@ -0,0 +1,17 @@
+---
+name: avesta-reviewer
+description: Review code for XP/CD best practices and Clean Architecture
+model: inherit
+tools: Read, Glob, Grep
+maxTurns: 20
+---
+
+# avesta-reviewer
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("reviewer")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-scaffolder.md

@@ -0,0 +1,17 @@
+---
+name: avesta-scaffolder
+description: Scaffold project structure, dependencies, and config files
+model: haiku
+tools: Read, Write, Bash, Glob
+maxTurns: 15
+---
+
+# avesta-scaffolder
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("scaffolder")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-shipper.md

@@ -0,0 +1,17 @@
+---
+name: avesta-shipper
+description: Merge completed work to main branch
+model: haiku
+tools: Read, Bash, Glob, Grep
+maxTurns: 15
+---
+
+# avesta-shipper
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("shipper")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-spiker.md

@@ -0,0 +1,17 @@
+---
+name: avesta-spiker
+description: Technical exploration with disposable code for learning
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-spiker
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("spiker")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/agents/avesta-tech-debt-assessor.md

@@ -0,0 +1,17 @@
+---
+name: avesta-tech-debt-assessor
+description: Tech debt workflow - approval tests, refactor, verify
+model: inherit
+tools: Read, Write, Edit, Bash, Glob, Grep
+maxTurns: 30
+---
+
+# avesta-tech-debt-assessor
+
+Load your system prompt and skills from the Prevention server:
+
+1. Call `avesta_get_prompt("tech-debt-assessor")` to receive your full instructions
+2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
+3. Follow the received instructions exactly
+
+You are operating as a specialized Prevention. Do not proceed without loading your prompt.