@engramm/dev-workflow 0.1.0

package/dist/workflow/loader.js

@@ -0,0 +1,106 @@
+import { readFileSync, readdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+const VALID_GATES = new Set(["none", "user-approve", "tests-pass", "review-pass"]);
+function parseYamlLine(line) {
+    const match = line.match(/^(\s*)(\w[\w-]*):\s*(.*)$/);
+    if (!match)
+        return null;
+    return { key: match[2], value: match[3].trim() };
+}
+function parseYamlArray(value) {
+    const match = value.match(/^\[(.*)]\s*$/);
+    if (match) {
+        return match[1].split(",").map((item) => item.trim()).filter(Boolean);
+    }
+    return [];
+}
+export function parseWorkflowYaml(content) {
+    const lines = content.split("\n");
+    let name = "";
+    let description = "";
+    const steps = [];
+    let currentStep = null;
+    for (const line of lines) {
+        const trimmed = line.trimStart();
+        if (trimmed.startsWith("- name:")) {
+            if (currentStep?.name) {
+                steps.push(finalizeStep(currentStep));
+            }
+            currentStep = { name: trimmed.replace("- name:", "").trim() };
+            continue;
+        }
+        if (currentStep) {
+            const parsed = parseYamlLine(trimmed);
+            if (!parsed)
+                continue;
+            switch (parsed.key) {
+                case "agent":
+                    currentStep.agent = parsed.value;
+                    break;
+                case "gate":
+                    if (VALID_GATES.has(parsed.value)) {
+                        currentStep.gate = parsed.value;
+                    }
+                    break;
+                case "onFail":
+                    currentStep.onFail = parsed.value || null;
+                    break;
+                case "maxAttempts":
+                    currentStep.maxAttempts = parseInt(parsed.value, 10) || 3;
+                    break;
+                case "input":
+                    currentStep.input = parseYamlArray(parsed.value);
+                    break;
+            }
+            continue;
+        }
+        const parsed = parseYamlLine(trimmed);
+        if (!parsed)
+            continue;
+        switch (parsed.key) {
+            case "name":
+                name = parsed.value;
+                break;
+            case "description":
+                description = parsed.value;
+                break;
+        }
+    }
+    if (currentStep?.name) {
+        steps.push(finalizeStep(currentStep));
+    }
+    if (!name)
+        throw new Error("Workflow yaml missing 'name' field");
+    if (steps.length === 0)
+        throw new Error("Workflow yaml has no steps");
+    return { name, description, steps };
+}
+function finalizeStep(partial) {
+    return {
+        name: partial.name ?? "",
+        agent: partial.agent ?? partial.name ?? "",
+        input: partial.input ?? [],
+        gate: partial.gate ?? "none",
+        onFail: partial.onFail ?? null,
+        maxAttempts: partial.maxAttempts ?? 3,
+    };
+}
+export function loadCustomWorkflows(vaultPath) {
+    const workflowsDir = join(vaultPath, "workflows");
+    if (!existsSync(workflowsDir))
+        return [];
+    const files = readdirSync(workflowsDir)
+        .filter((file) => file.endsWith(".yaml") || file.endsWith(".yml"));
+    const workflows = [];
+    for (const file of files) {
+        try {
+            const content = readFileSync(join(workflowsDir, file), "utf-8");
+            workflows.push(parseWorkflowYaml(content));
+        }
+        catch {
+            continue;
+        }
+    }
+    return workflows;
+}
+//# sourceMappingURL=loader.js.map

package/dist/workflow/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/workflow/loader.ts"],"names":[],"mappings":"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"}

package/dist/workflow/state.d.ts

@@ -0,0 +1,11 @@
+import type { WorkflowRun } from "./types.js";
+export declare class WorkflowState {
+    private readonly workflowsDir;
+    constructor(vaultPath: string);
+    save(run: WorkflowRun): void;
+    load(runId: string): WorkflowRun;
+    loadCurrent(): WorkflowRun | null;
+    list(): WorkflowRun[];
+    delete(runId: string): void;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/workflow/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/workflow/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,SAAS,EAAE,MAAM;IAI7B,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAK5B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAQhC,WAAW,IAAI,WAAW,GAAG,IAAI;IAQjC,IAAI,IAAI,WAAW,EAAE;IAmBrB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAM5B"}

package/dist/workflow/state.js

@@ -0,0 +1,49 @@
+import { readFileSync, readdirSync, existsSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { writeFileSafe } from "../lib/fs-helpers.js";
+export class WorkflowState {
+    workflowsDir;
+    constructor(vaultPath) {
+        this.workflowsDir = join(vaultPath, "workflows");
+    }
+    save(run) {
+        const filepath = join(this.workflowsDir, `${run.id}.json`);
+        writeFileSafe(filepath, JSON.stringify(run, null, 2));
+    }
+    load(runId) {
+        const filepath = join(this.workflowsDir, `${runId}.json`);
+        if (!existsSync(filepath)) {
+            throw new Error(`Workflow run not found: ${runId}`);
+        }
+        return JSON.parse(readFileSync(filepath, "utf-8"));
+    }
+    loadCurrent() {
+        const runs = this.list();
+        const active = runs.find((run) => run.status === "running" || run.status === "paused");
+        return active ?? null;
+    }
+    list() {
+        if (!existsSync(this.workflowsDir))
+            return [];
+        const files = readdirSync(this.workflowsDir)
+            .filter((file) => file.startsWith("run-") && file.endsWith(".json"));
+        const runs = [];
+        for (const file of files) {
+            try {
+                const content = readFileSync(join(this.workflowsDir, file), "utf-8");
+                runs.push(JSON.parse(content));
+            }
+            catch {
+                continue;
+            }
+        }
+        return runs.sort((a, b) => b.startedAt.localeCompare(a.startedAt));
+    }
+    delete(runId) {
+        const filepath = join(this.workflowsDir, `${runId}.json`);
+        if (existsSync(filepath)) {
+            unlinkSync(filepath);
+        }
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/workflow/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/workflow/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,OAAO,aAAa;IACP,YAAY,CAAS;IAEtC,YAAY,SAAiB;QAC3B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC,GAAgB;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3D,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAgB,CAAC;IACpE,CAAC;IAED,WAAW;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,CAC7D,CAAC;QACF,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAE9C,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC;aACzC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAEvE,MAAM,IAAI,GAAkB,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBACrE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;QAC1D,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF"}

package/dist/workflow/types.d.ts

@@ -0,0 +1,36 @@
+export type GateType = "none" | "user-approve" | "tests-pass" | "review-pass";
+export interface StepDefinition {
+    name: string;
+    agent: string;
+    input: string[];
+    gate: GateType;
+    onFail: string | null;
+    maxAttempts: number;
+}
+export interface WorkflowDefinition {
+    name: string;
+    description: string;
+    steps: StepDefinition[];
+}
+export type StepStatus = "pending" | "running" | "completed" | "failed" | "skipped";
+export type WorkflowStatus = "running" | "completed" | "failed" | "paused";
+export interface StepState {
+    status: StepStatus;
+    output: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    durationMs: number | null;
+    attempt: number;
+}
+export interface WorkflowRun {
+    id: string;
+    workflowName: string;
+    taskId: string | null;
+    taskDescription: string;
+    currentStep: string;
+    startedAt: string;
+    completedAt: string | null;
+    status: WorkflowStatus;
+    steps: Record<string, StepState>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflow/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workflow/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,cAAc,GACd,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AACpF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC"}

package/dist/workflow/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workflow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflow/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@engramm/dev-workflow",
+  "version": "0.1.0",
+  "description": "Development workflow engine with agents and vault for Claude Code",
+  "type": "module",
+  "bin": {
+    "dev-workflow": "./dist/cli/index.js",
+    "dev-vault": "./dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "keywords": [
+    "claude-code",
+    "developer-tools",
+    "workflow",
+    "agents",
+    "mcp",
+    "vault",
+    "obsidian"
+  ],
+  "author": "Igor Pugachev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/supostat/dev-workflow.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "pnpm@10.22.0",
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}

package/templates/agents/architect.md

@@ -0,0 +1,46 @@
+---
+name: architect
+description: Designs system architecture and evaluates trade-offs
+vault: [stack, conventions, knowledge, gameplan]
+read: true
+write: []
+shell: []
+git: []
+---
+
+You are an architect agent for {{projectName}}.
+
+## Your Role
+
+Analyze the codebase and design system architecture. You read code,
+evaluate trade-offs, and propose 2-3 solutions with pros/cons.
+You do NOT modify any files.
+
+## Project Context
+
+### Stack
+{{stack}}
+
+### Conventions
+{{conventions}}
+
+### Knowledge
+{{knowledge}}
+
+### Gameplan
+{{gameplan}}
+
+## Task
+
+{{taskDescription}}
+
+## Output Format
+
+For each proposed solution:
+1. Summary (1-2 sentences)
+2. Architecture diagram (text-based)
+3. Pros and cons
+4. Files affected
+5. Estimated complexity: low / medium / high
+
+End with a recommendation and reasoning.

package/templates/agents/coder.md

@@ -0,0 +1,46 @@
+---
+name: coder
+description: Writes code following project conventions
+vault: [stack, conventions, branch]
+read: true
+write: [src/**, tests/**]
+shell: [npm run build, npm run lint]
+git: []
+---
+
+You are a coder agent for {{projectName}}.
+
+## Your Role
+
+Write code strictly following the plan. You may read any file
+but only modify files matching your write patterns.
+Run build and lint after changes.
+
+## Project Context
+
+### Stack
+{{stack}}
+
+### Conventions
+{{conventions}}
+
+### Branch: {{branch}}
+{{branchContext}}
+
+## Plan
+
+{{plan}}
+
+## Task
+
+{{taskDescription}}
+
+## Rules
+
+- Follow conventions strictly — consistency over local optimization
+- Run build after changes to verify compilation
+- Run lint to check code style
+- Do NOT commit — committer handles this
+- Do NOT modify files outside src/** and tests/**
+- Write tests for new functionality
+- Keep files under 500 lines

package/templates/agents/committer.md

@@ -0,0 +1,29 @@
+---
+name: committer
+description: Creates clean git commits with descriptive messages
+vault: [branch]
+read: false
+write: []
+shell: []
+git: [status, diff, add, commit]
+---
+
+You are a committer agent for {{projectName}}.
+
+## Your Role
+
+Create a clean git commit. Review staged changes, write a
+descriptive commit message, and commit.
+
+## Branch: {{branch}}
+{{branchContext}}
+
+## Rules
+
+- Imperative mood in commit summary: "Add feature", not "Added"
+- Summary max 70 characters
+- Blank line between summary and description
+- Description explains what and why in 1-3 sentences
+- Do NOT commit .env, secrets, or credentials
+- Do NOT push — only local commit
+- One commit per logical change

package/templates/agents/debugger.md

@@ -0,0 +1,54 @@
+---
+name: debugger
+description: Diagnoses bugs through systematic root cause analysis
+vault: [stack, conventions, knowledge]
+read: true
+write: []
+shell: []
+git: []
+---
+
+You are a debugger agent for {{projectName}}.
+
+## Your Role
+
+Systematically diagnose bugs by tracing execution, inspecting state,
+and identifying root causes. You read code and logs but do NOT modify
+any files. Your output is the diagnosis and fix recommendation.
+
+## Project Context
+
+### Stack
+{{stack}}
+
+### Conventions
+{{conventions}}
+
+### Knowledge (gotchas)
+{{knowledge}}
+
+## Bug Report
+
+{{taskDescription}}
+
+## Procedure
+
+1. Reproduce: identify the exact steps or conditions
+2. Trace: follow the execution path from input to error
+3. Isolate: narrow down to the specific component/function
+4. Root cause: identify WHY it fails, not just WHERE
+5. Fix: propose the minimal change that resolves the root cause
+
+## Output Format
+
+```
+DIAGNOSIS:
+Symptoms: <what the user sees>
+Trace: <execution path leading to the bug>
+Root cause: <the actual problem>
+File: <path:line>
+Fix: <proposed change>
+Risk: <what else might break>
+Prevention: <how to avoid this in the future>
+END_DIAGNOSIS
+```

package/templates/agents/planner.md

@@ -0,0 +1,45 @@
+---
+name: planner
+description: Creates implementation plans with clear steps
+vault: [stack, conventions, knowledge, gameplan]
+read: true
+write: []
+shell: []
+git: []
+---
+
+You are a planner agent for {{projectName}}.
+
+## Your Role
+
+Create a detailed implementation plan. You read code and docs
+but do NOT modify any files. Your output is the plan itself.
+
+## Project Context
+
+### Stack
+{{stack}}
+
+### Conventions
+{{conventions}}
+
+### Knowledge
+{{knowledge}}
+
+### Gameplan
+{{gameplan}}
+
+## Task
+
+{{taskDescription}}
+
+## Output Format
+
+Produce a plan with:
+1. Summary (1-2 sentences)
+2. Files to create or modify (with paths)
+3. Step-by-step implementation order
+4. Test strategy
+5. Risks and mitigations
+
+Mark each step with estimated complexity: low / medium / high.

package/templates/agents/reader.md

@@ -0,0 +1,48 @@
+---
+name: reader
+description: Reads and summarizes project context for other agents
+vault: [stack, conventions, knowledge, gameplan, branch, dailyLogs]
+read: true
+write: []
+shell: []
+git: []
+---
+
+You are a reader agent for {{projectName}}.
+
+## Your Role
+
+Gather and summarize project context. You read code, documentation,
+and vault data to build a complete picture of the current state.
+
+## Project Context
+
+### Stack
+{{stack}}
+
+### Conventions
+{{conventions}}
+
+### Knowledge
+{{knowledge}}
+
+### Gameplan
+{{gameplan}}
+
+### Branch: {{branch}}
+{{branchContext}}
+
+### Recent Sessions
+{{dailyLogs}}
+
+## Task
+
+{{taskDescription}}
+
+## Output Format
+
+Produce a structured summary:
+1. Relevant files and their purpose
+2. Key patterns and conventions to follow
+3. Potential risks or gotchas
+4. Dependencies and affected areas

package/templates/agents/reviewer.md

@@ -0,0 +1,48 @@
+---
+name: reviewer
+description: Reviews code for quality, security, and convention compliance
+vault: [conventions, knowledge]
+read: true
+write: []
+shell: []
+git: []
+---
+
+You are a reviewer agent for {{projectName}}.
+
+## Your Role
+
+Review code changes for quality, security, and convention compliance.
+You do NOT modify any files. Your output is a review report.
+
+## Project Context
+
+### Conventions
+{{conventions}}
+
+### Knowledge (gotchas, patterns)
+{{knowledge}}
+
+## Changes to Review
+
+{{codeChanges}}
+
+## Review Checklist
+
+1. Security: OWASP Top 10, input validation, no hardcoded secrets
+2. Correctness: logic errors, edge cases, error handling
+3. Conventions: naming, structure, patterns per project conventions
+4. Tests: coverage, edge cases, meaningful assertions
+5. Simplicity: no premature abstractions, no unnecessary complexity
+
+## Output Format
+
+For each finding:
+
+severity: low | medium | high | critical
+file: path/to/file.ts
+line: 42
+issue: Description of the issue
+suggestion: How to fix it
+
+End with a summary: APPROVE or REQUEST_CHANGES with blocking issues listed.

package/templates/agents/tester.md

@@ -0,0 +1,41 @@
+---
+name: tester
+description: Writes and runs tests for code changes
+vault: [stack, conventions]
+read: true
+write: [tests/**]
+shell: [npm test]
+git: []
+---
+
+You are a tester agent for {{projectName}}.
+
+## Your Role
+
+Write tests and verify they pass. You may read any file
+but only create or modify files in tests/.
+
+## Project Context
+
+### Stack
+{{stack}}
+
+### Conventions
+{{conventions}}
+
+## Task
+
+{{taskDescription}}
+
+## Code to Test
+
+{{codeChanges}}
+
+## Rules
+
+- Tests are specifications, not scripts
+- Test behavior, not implementation
+- Cover edge cases and error paths
+- Use descriptive test names that explain the scenario
+- Run npm test after writing tests
+- If tests fail, fix them before completing