ai-dev-harness 0.1.0 → 0.1.2

package/dist/runPaths.js

@@ -12,10 +12,41 @@ export function makeRunPaths(cwd, config, task) {
         agentPrompt: path.join(runDir, "agent_prompt.md"),
         plan: path.join(runDir, "plan.md"),
         executionLog: path.join(runDir, "execution.log"),
+        agentContract: path.join(runDir, "agent_contract.json"),
         gitDiff: path.join(runDir, "git_diff.patch"),
         verify: path.join(runDir, "verify.json"),
+        verifyDiagnostics: path.join(runDir, "verify_diagnostics.json"),
+        contextScore: path.join(runDir, "context_score.json"),
+        approvalRequired: path.join(runDir, "approval_required.json"),
+        feedback: path.join(runDir, "feedback.jsonl"),
+        checkpoint: path.join(runDir, "checkpoint.json"),
+        preIterationDiff: path.join(runDir, "pre_iteration_diff.patch"),
+        postIterationDiff: path.join(runDir, "post_iteration_diff.patch"),
         summary: path.join(runDir, "summary.md"),
         persistSuggestions: path.join(runDir, "persist_suggestions.md"),
+        loopReview: path.join(runDir, "loop_review.json"),
+        loopReport: path.join(runDir, "loop_report.md"),
         audit: path.join(runDir, "audit.jsonl")
     };
 }
+export function makeIterationPaths(paths, iteration) {
+    const iterationDir = path.join(paths.runDir, `iteration-${iteration}`);
+    return {
+        iteration,
+        iterationDir,
+        contextPack: path.join(iterationDir, "context_pack.md"),
+        agentPrompt: path.join(iterationDir, "agent_prompt.md"),
+        plan: path.join(iterationDir, "plan.md"),
+        executionLog: path.join(iterationDir, "execution.log"),
+        agentContract: path.join(iterationDir, "agent_contract.json"),
+        gitDiff: path.join(iterationDir, "git_diff.patch"),
+        verify: path.join(iterationDir, "verify.json"),
+        verifyDiagnostics: path.join(iterationDir, "verify_diagnostics.json"),
+        contextScore: path.join(iterationDir, "context_score.json"),
+        approvalRequired: path.join(iterationDir, "approval_required.json"),
+        feedback: path.join(iterationDir, "feedback.jsonl"),
+        checkpoint: path.join(iterationDir, "checkpoint.json"),
+        preIterationDiff: path.join(iterationDir, "pre_iteration_diff.patch"),
+        postIterationDiff: path.join(iterationDir, "post_iteration_diff.patch")
+    };
+}

package/dist/summarize.js

@@ -2,14 +2,14 @@ import { readFile, writeFile } from "node:fs/promises";
 import { truncate } from "./utils.js";
 export async function writeSummary(options) {
     const diff = await readFile(options.gitDiffPath, "utf8").catch(() => "");
-    const summary = `# Run Summary
+    const summary = `# 运行总结
 
-## Executive Status
-- Task status: ${options.agentResult?.status === "success" && options.verifyResult?.status === "passed" ? "ready for review" : "requires attention"}
-- Agent status: ${options.agentResult?.status ?? "not-run"}
-- Verification status: ${options.verifyResult?.status ?? "not-run"}
+## 执行状态
+- 任务状态: ${options.agentResult?.status === "success" && options.verifyResult?.status === "passed" ? "可进入评审" : "需要关注"}
+- Agent 状态: ${options.agentResult?.status ?? "未运行"}
+- 验证状态: ${options.verifyResult?.status ?? "未运行"}
 
-## Task
+## 任务
 ${options.task}
 
 ## Skill
@@ -18,54 +18,185 @@ ${options.skillName}
 ## Agent
 ${options.agentName}
 
-## Execution
-- Status: ${options.agentResult?.status ?? "not-run"}
-- Exit code: ${options.agentResult?.exitCode ?? "n/a"}
-- Changed files: ${options.agentResult?.changedFiles.join(", ") || "(none)"}
+## 执行结果
+- 状态: ${options.agentResult?.status ?? "未运行"}
+- 退出码: ${options.agentResult?.exitCode ?? "n/a"}
+- 修改文件: ${options.agentResult?.changedFiles.join(", ") || "无"}
 
-## Verification
-- Status: ${options.verifyResult?.status ?? "not-run"}
+## 验证结果
+- 状态: ${options.verifyResult?.status ?? "未运行"}
 
-## Review Checklist
-- Confirm the change is limited to the requested task.
-- Confirm public interfaces and backward compatibility were preserved.
-- Confirm verification failures or skipped checks are understood.
-- Confirm Knowledge Graph suggestions are reviewed before persistence.
+## 评审检查清单
+- 确认变更限定在任务范围内。
+- 确认公共接口和向后兼容性没有被意外破坏。
+- 确认失败或跳过的验证项已被理解。
+- 确认知识沉淀建议符合 OKF v0.1 + 团队扩展规范，并经过人工评审后再写入 Knowledge Graph。
 
-## PR Description Draft
-### What changed
-${options.agentResult?.changedFiles.length ? `Updated ${options.agentResult.changedFiles.length} file(s).` : "No file changes detected."}
+## PR 描述草稿
+### 变更内容
+${options.agentResult?.changedFiles.length ? `更新 ${options.agentResult.changedFiles.length} 个文件。` : "未检测到文件变更。"}
 
-### Why
-- See execution.log for the agent's impact analysis, plan, and final report.
+### 变更原因
+- 见 execution.log 中的 Agent 影响分析、计划和最终报告。
 
-### Verification
-${options.verifyResult?.commands.map((cmd) => `- ${cmd.name}: ${cmd.exitCode === 0 ? "passed" : "failed"} (${cmd.command})`).join("\n") || "- Not run"}
+### 验证
+${options.verifyResult?.commands.map((cmd) => `- ${cmd.name}: ${cmd.exitCode === 0 ? "通过" : "失败"} (${cmd.command})`).join("\n") || "- 未运行"}
 
-### Risk
-- Review required for correctness, safety, compatibility, and knowledge persistence before merging.
+### 风险
+- 合并前需要评审正确性、安全性、兼容性和知识沉淀建议。
 
-### Knowledge Follow-up
-- Review persist_suggestions.md before updating Knowledge Graph.
+### 知识沉淀跟进
+- 写入 Knowledge Graph 前先评审 persist_suggestions.md，确认目标项目目录、frontmatter、相关链接、index.md 和 log.md 更新项。
 
-## Diff Snapshot
+## Diff 快照
 \`\`\`diff
 ${truncate(diff, 12000)}
 \`\`\`
 `;
-    const persist = `# Knowledge Persist Suggestions
+    const persist = `# 知识沉淀建议
 
-Review these suggestions before updating the Knowledge Graph.
+写入 Knowledge Graph 前，请先人工评审这些建议。本文只生成 OKF 候选内容，不自动写入知识库。
 
-- Task: ${options.task}
+- 任务: ${options.task}
 - Skill: ${options.skillName}
-- Changed files: ${options.agentResult?.changedFiles.join(", ") || "(none)"}
-- Persistence policy: human review required before writing to Knowledge Graph.
-- Suggested knowledge updates:
-  - Add or update module notes if the change clarifies ownership or behavior.
-  - Add ADR/decision note if the implementation chose between meaningful alternatives.
-  - Add runbook/testing note if verification uncovered a recurring operational step.
-  - Record known MCP degradation or missing context if it affected confidence.
+- 修改文件: ${options.agentResult?.changedFiles.join(", ") || "无"}
+- 沉淀策略: 写入 Knowledge Graph 前必须人工评审。
+- 知识库规范: OKF v0.1 + PC 浏览器团队扩展。
+
+## OKF 写作规则
+
+- 每个知识文档是一个 concept，concept_id 等于文件路径去掉 \`.md\` 后缀。
+- 新文档放入具体项目目录，例如 \`/zero/\`、\`/se/\`、\`/yuntun/\`。
+- 子域优先选择 \`overview\`、\`features\`、\`metrics\`、\`api\`、\`playbooks\`、\`references\`。
+- 普通知识文档必须包含 YAML frontmatter: \`type\`、\`title\`、\`description\`、\`tags\`、\`timestamp\`；API/数据类建议补充 \`resource\`。
+- \`## 相关\` 必须使用有效 Markdown 链接，推荐 bundle 根相对路径，例如 \`/zero/features/fast-launch.md\`。
+- API Reference 必须补充 \`## 关键实现锚点\` 和 \`### Agent 使用建议\`。
+- 不写入密钥、Token、明文密码、未脱敏用户数据、未公开内网 IP；内网链接使用占位符域名。
+- 合入知识库时同步更新对应目录的 \`index.md\` 和 \`log.md\`。
+
+## 建议候选文档
+
+### Candidate 1: Feature / Module Note
+
+- 适用条件: 本次变更澄清了功能行为、模块职责、边界条件或实现约束。
+- 建议路径: \`/<project>/features/<feature-or-module>.md\`
+- 建议 type: \`Feature\`
+
+\`\`\`\`markdown
+---
+type: Feature
+title: <功能或模块名称>
+description: <一句话说明这个功能/模块解决什么问题，以及本次变更沉淀了什么>
+tags: [<project>, <feature-or-module>]
+timestamp: ${new Date().toISOString()}
+---
+
+## 背景 / 设计目标
+
+- <为什么需要这个功能或这次变更>
+
+## 方案 / 实现
+
+- <关键实现路径、主要流程、重要约束>
+- 相关代码: \`${options.agentResult?.changedFiles[0] ?? "<path/to/code>"}\`
+
+## 注意事项 / 已知限制
+
+- <边界条件、兼容性、风险点>
+
+## 相关
+
+- [相关文档](/<project>/<domain>/<doc>.md)
+\`\`\`\`
+
+### Candidate 2: API Reference
+
+- 适用条件: 本次变更涉及接口语义、入参、返回值、兼容性或调用链。
+- 建议路径: \`/<project>/api/<api-name>.md\`
+- 建议 type: \`API Reference\`
+
+\`\`\`\`markdown
+---
+type: API Reference
+title: <接口名称>
+description: <一句话说明接口职责和主要调用场景>
+resource: <endpoint-or-openapi-placeholder>
+tags: [<project>, api]
+timestamp: ${new Date().toISOString()}
+---
+
+## 关键实现锚点
+- 模块: \`<代码仓库中的模块路径>\`
+- 类/组件: \`<核心类、Handler 或入口函数>\`
+- 补充入口: \`<配置、部署脚本或 Playbook 路径>\`
+
+### Agent 使用建议
+
+需要实现细节时，继续用 CodeGraph 查询真实调用链和影响面。
+
+# Schema
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| <field> | <type> | <yes/no> | <description> |
+
+# Examples
+
+\`\`\`json
+{
+  "example": true
+}
+\`\`\`
+
+## 相关
+
+- [相关功能](/<project>/features/<feature>.md)
+\`\`\`\`
+
+### Candidate 3: Playbook / Test Knowledge
+
+- 适用条件: 本次修复、验证、回滚或排障步骤可复用。
+- 建议路径: \`/<project>/playbooks/<scenario>.md\`
+- 建议 type: \`Playbook\`
+
+\`\`\`\`markdown
+---
+type: Playbook
+title: <场景处理手册>
+description: <一句话说明该手册解决什么操作/排障场景>
+tags: [<project>, playbook]
+timestamp: ${new Date().toISOString()}
+---
+
+## 适用场景
+
+- <什么情况下使用>
+
+## 操作步骤
+
+1. <步骤一>
+2. <步骤二>
+3. <验证结果>
+
+## 风险与回滚
+
+- <风险>
+- <回滚方式>
+
+## 相关
+
+- [相关功能](/<project>/features/<feature>.md)
+\`\`\`\`
+
+## index.md / log.md 更新建议
+
+- \`index.md\`: 添加新文档链接和一句话 description。
+- \`log.md\`: 最新日期在前，使用 \`**Creation**\`、\`**Update**\`、\`**Deprecation**\` 或 \`**Deletion**\`。
+
+## 缺失上下文记录
+
+- Missing Context Candidate: 如果缺少 CodeGraph 或 Knowledge Graph 证据影响判断，请记录缺失的工具、query、concept_id 或代码路径。
+- Skill Improvement Candidate: 如果本次任务暴露 Skill 输入、验证命令或 MCP 使用规则缺口，请记录到 Skill 改进建议。
 `;
     await writeFile(options.summaryPath, summary, "utf8");
     await writeFile(options.persistPath, persist, "utf8");

package/dist/templates.js

@@ -1,217 +1,41 @@
+import path from "node:path";
+import { readdir, readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
 import { defaultConfigYaml } from "./config.js";
-export const rootTemplates = {
-    "harness.yaml": defaultConfigYaml(),
-    "AGENTS.md": `# Project Agent Rules
-
-- Work inside this Git repository only.
-- Prefer small, reviewable changes.
-- Do not modify generated or dependency directories.
-- Always explain impact, risk, verification, and follow-up knowledge updates.
-- Before changing code, state assumptions, affected areas, and a minimal plan.
-- If required context is missing or confidence is low, stop and report what is missing instead of guessing.
-- Do not perform broad refactors, formatting-only sweeps, dependency upgrades, or unrelated cleanup unless the task explicitly asks for them.
-`,
-    "TOOLS.md": `# Tool Rules
-
-- Codex and Claude Code are execution agents.
-- CodeGraph MCP provides code impact context.
-- Knowledge Graph MCP provides ADR, module, API, runbook, and decision context.
-- Verification commands are defined in harness.yaml and skill verify.yaml files.
-- Harness run evidence is stored in runs/<run_id>/ and must be treated as the audit record.
-- Knowledge Graph is read-only in v1. Write suggestions to persist_suggestions.md only.
-`,
-    "SKILLS.md": `# Skill Index
-
-- fix_bug: diagnose and fix a defect with tests when possible.
-- add_feature: implement a scoped feature with verification.
-- write_tests: add or improve tests for existing behavior.
-- update_docs: update project documentation and knowledge suggestions.
-
-Every skill follows the same execution contract:
-
-1. Analysis Contract: identify assumptions, affected files/modules, likely risks, and the smallest viable plan.
-2. Execution Contract: make only task-relevant changes and avoid opportunistic refactors.
-3. Verification Contract: run or defer verification with explicit reasons.
-4. Report Contract: explain root cause or intent, changed files, verification, residual risk, and knowledge suggestions.
-`
-};
-const baseContext = `queries:
-  - related files
-  - symbols
-  - call graph
-  - dependencies
-  - impact analysis
-fallbackInclude:
-  - README.md
-  - src
-`;
-const defaultVerify = `- name: git status
-  command: git status --short
-`;
-export const skillTemplates = {
-    fix_bug: {
-        "SKILL.md": `# fix_bug
-
-## Goal
-Diagnose and fix a defect with the smallest safe code change.
-
-## Inputs
-- Task text or issue description.
-- CodeGraph impact context.
-- Knowledge Graph related decisions, module notes, APIs, and runbooks.
-
-## Outputs
-- Code change.
-- Test or verification result.
-- Summary with root cause, impact, risk, and follow-up suggestions.
-
-## Analysis Contract
-- Restate the observed defect and expected behavior.
-- Identify the likely root cause and the code path involved.
-- List assumptions and confidence level before editing.
-- Use CodeGraph impact context to avoid missing callers or dependent modules.
-- Use Knowledge Graph decisions and runbooks to avoid violating historical constraints.
-
-## Execution Contract
-- Make the smallest task-relevant change.
-- Prefer adding or updating a regression test when feasible.
-- Do not rewrite unrelated code, rename public APIs, change formatting broadly, or upgrade dependencies.
-- If root cause is unclear after inspection, stop and report missing evidence instead of guessing.
-
-## Verification Contract
-- Run the configured verification commands through Harness.
-- If manual or targeted verification is needed, describe the exact command or scenario.
-- Record any verification that could not be run and why.
-
-## Report Contract
-- Root cause.
-- Files changed.
-- Why the fix is safe.
-- Verification result.
-- Residual risk.
-- Knowledge or runbook update suggestions.
-
-## Acceptance
-- The defect is explained.
-- The change is limited to the affected area.
-- Relevant verification commands pass or failures are recorded.
-`,
-        "verify.yaml": defaultVerify,
-        "context.yaml": baseContext
-    },
-    add_feature: {
-        "SKILL.md": `# add_feature
-
-## Goal
-Implement a scoped feature using existing project patterns.
-
-## Analysis Contract
-- Restate the feature intent and non-goals.
-- Identify affected modules, public interfaces, data flows, and compatibility risks.
-- Check CodeGraph context for callers, dependencies, and likely integration points.
-- Check Knowledge Graph context for ADRs, API contracts, and previous decisions.
-
-## Execution Contract
-- Implement the smallest coherent slice that satisfies the task.
-- Follow existing patterns before introducing new abstractions.
-- Do not change unrelated behavior or broaden scope.
-- Preserve backward compatibility unless the task explicitly allows breaking changes.
-
-## Verification Contract
-- Add or update tests when behavior changes.
-- Run configured verification commands through Harness.
-- Record unverified scenarios and reasons.
-
-## Report Contract
-- Feature behavior implemented.
-- Files changed.
-- Compatibility notes.
-- Verification result.
-- Residual risk.
-- Documentation or knowledge suggestions.
-
-## Outputs
-- Code change.
-- Tests or verification.
-- Documentation and knowledge suggestions when behavior changes.
-`,
-        "verify.yaml": defaultVerify,
-        "context.yaml": baseContext
-    },
-    write_tests: {
-        "SKILL.md": `# write_tests
-
-## Goal
-Add or improve tests for existing behavior without changing production behavior unless required.
-
-## Analysis Contract
-- Identify the behavior under test and the risk it protects.
-- Locate existing test patterns, fixtures, and helper APIs.
-- Check CodeGraph context for affected code paths.
-- Avoid inventing behavior not supported by source code or knowledge context.
-
-## Execution Contract
-- Prefer focused tests over broad snapshot or brittle integration tests.
-- Do not change production code unless the existing code is untestable and the change is minimal.
-- Keep fixtures deterministic and local to the test where possible.
-
-## Verification Contract
-- Run the relevant test command or configured Harness verification.
-- If the full suite is too expensive, document the targeted command and why.
-
-## Report Contract
-- Scenarios covered.
-- Files changed.
-- Verification result.
-- Remaining uncovered risks.
-
-## Outputs
-- Test files or fixture updates.
-- Verification result.
-- Summary of covered scenarios.
-`,
-        "verify.yaml": defaultVerify,
-        "context.yaml": baseContext
-    },
-    update_docs: {
-        "SKILL.md": `# update_docs
-
-## Goal
-Update project documentation and propose knowledge graph additions.
-
-## Analysis Contract
-- Identify the audience and purpose of the documentation update.
-- Cross-check docs against code, CodeGraph context, and Knowledge Graph records.
-- Distinguish confirmed facts from inferred guidance.
-
-## Execution Contract
-- Update only documentation or knowledge suggestion artifacts unless explicitly asked to change code.
-- Keep docs concise, operational, and linked to actual project behavior.
-- Do not write directly to Knowledge Graph in v1.
-
-## Verification Contract
-- Check links, commands, paths, and filenames mentioned in the docs.
-- Run configured verification when docs affect generated artifacts or examples.
-
-## Report Contract
-- Docs changed.
-- Source of truth used.
-- Verification result.
-- Knowledge Graph suggestions.
-
-## Outputs
-- Documentation changes.
-- Persist suggestions for ADR, module notes, runbooks, or decisions.
-`,
-        "verify.yaml": defaultVerify,
-        "context.yaml": `queries:
-  - related docs
-  - ADR
-  - module notes
-  - API docs
-fallbackInclude:
-  - README.md
-  - docs
-`
+import { pathExists } from "./utils.js";
+export function packageRootFromHere() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+}
+export function templateRoot(packageRoot = packageRootFromHere()) {
+    return path.join(packageRoot, "templates");
+}
+export async function readTemplateFile(relPath, packageRoot = packageRootFromHere()) {
+    return readFile(path.join(templateRoot(packageRoot), relPath), "utf8");
+}
+export function renderTemplate(content, vars) {
+    return Object.entries(vars).reduce((next, [key, value]) => next.replaceAll(`{{${key}}}`, value), content);
+}
+export async function readTemplateTree(relDir, packageRoot = packageRootFromHere()) {
+    const root = path.join(templateRoot(packageRoot), relDir);
+    const files = [];
+    async function walk(absDir, relBase) {
+        const entries = await readdir(absDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const abs = path.join(absDir, entry.name);
+            const rel = path.join(relBase, entry.name);
+            if (entry.isDirectory()) {
+                await walk(abs, rel);
+            }
+            else {
+                files.push({ relPath: rel, content: await readFile(abs, "utf8") });
+            }
+        }
     }
-};
+    if (await pathExists(root))
+        await walk(root, "");
+    return files;
+}
+export async function defaultProjectTemplates(packageRoot = packageRootFromHere()) {
+    const files = await readTemplateTree("default-project", packageRoot);
+    return [{ relPath: "harness.yaml", content: defaultConfigYaml() }, ...files];
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-dev-harness",
-  "version": "0.1.0",
-  "description": "Auditable AI development harness for Codex and Claude Code.",
+  "version": "0.1.2",
+  "description": "Auditable AI development harness for Codex, Claude Code, Cursor Agent, and Gemini CLI.",
   "license": "MIT",
   "keywords": [
     "ai",
@@ -21,7 +21,10 @@
     "!dist/**/*.test.js",
     "!dist/testSupport.js",
     "scripts/",
+    "templates/",
     "README.md",
+    "ONLINE_INSTALL_GUIDE.md",
+    "COLLEAGUE_TRIAL_GUIDE.md",
     "package.json"
   ],
   "scripts": {

package/scripts/read-evidence.ps1

@@ -14,10 +14,17 @@ $runPath = if (Test-Path -LiteralPath $Run) {
   Resolve-Path -LiteralPath (Join-Path $repoPath "runs\$Run")
 }
 
-Write-Host "[harness-skill] evidence: $runPath"
+Write-Host "[harness-skill] 证据目录: $runPath"
 
 $summary = Join-Path $runPath "summary.md"
 $verify = Join-Path $runPath "verify.json"
+$verifyDiagnostics = Join-Path $runPath "verify_diagnostics.json"
+$contract = Join-Path $runPath "agent_contract.json"
+$contextScore = Join-Path $runPath "context_score.json"
+$approval = Join-Path $runPath "approval_required.json"
+$checkpoint = Join-Path $runPath "checkpoint.json"
+$loopReview = Join-Path $runPath "loop_review.json"
+$loopReport = Join-Path $runPath "loop_report.md"
 $audit = Join-Path $runPath "audit.jsonl"
 
 if (Test-Path -LiteralPath $summary) {
@@ -30,7 +37,42 @@ if (Test-Path -LiteralPath $verify) {
   Get-Content -LiteralPath $verify
 }
 
+if (Test-Path -LiteralPath $verifyDiagnostics) {
+  Write-Host "`n--- verify_diagnostics.json ---"
+  Get-Content -LiteralPath $verifyDiagnostics
+}
+
+if (Test-Path -LiteralPath $contract) {
+  Write-Host "`n--- agent_contract.json ---"
+  Get-Content -LiteralPath $contract
+}
+
+if (Test-Path -LiteralPath $contextScore) {
+  Write-Host "`n--- context_score.json ---"
+  Get-Content -LiteralPath $contextScore
+}
+
+if (Test-Path -LiteralPath $approval) {
+  Write-Host "`n--- approval_required.json ---"
+  Get-Content -LiteralPath $approval
+}
+
+if (Test-Path -LiteralPath $checkpoint) {
+  Write-Host "`n--- checkpoint.json ---"
+  Get-Content -LiteralPath $checkpoint
+}
+
+if (Test-Path -LiteralPath $loopReview) {
+  Write-Host "`n--- loop_review.json ---"
+  Get-Content -LiteralPath $loopReview
+}
+
+if (Test-Path -LiteralPath $loopReport) {
+  Write-Host "`n--- loop_report.md ---"
+  Get-Content -LiteralPath $loopReport
+}
+
 if (Test-Path -LiteralPath $audit) {
-  Write-Host "`n--- audit degraded/errors ---"
-  Select-String -LiteralPath $audit -Pattern "degraded|failed|error|run_finished" | ForEach-Object { $_.Line }
+  Write-Host "`n--- 审计失败/错误 ---"
+  Select-String -LiteralPath $audit -Pattern "failed|error|evaluate|rework|approval|restore|run_finished" | ForEach-Object { $_.Line }
 }

package/scripts/run-harness.ps1

@@ -7,7 +7,7 @@ param(
   [string]$Skill,
 
   [Parameter(Mandatory = $true)]
-  [ValidateSet("claude", "codex")]
+  [ValidateSet("claude", "codex", "cursor", "gemini")]
   [string]$Agent,
 
   [string]$Repo = (Get-Location).Path,
@@ -19,7 +19,11 @@ $ErrorActionPreference = "Stop"
 
 $repoPath = Resolve-Path -LiteralPath $Repo
 $harnessYaml = Join-Path $repoPath "harness.yaml"
-$cliPath = Resolve-Path -LiteralPath (Join-Path $PSScriptRoot "..\dist\cli.js")
+$cliPath = '{{HARNESS_CLI_PATH}}'
+
+if ($cliPath -like '{{*}}') {
+  $cliPath = Resolve-Path -LiteralPath (Join-Path $PSScriptRoot "..\dist\cli.js")
+}
 
 Write-Host "[harness-skill] repo: $repoPath"
 Write-Host "[harness-skill] checking config: $harnessYaml"
@@ -33,8 +37,7 @@ if ($LASTEXITCODE -ne 0) {
   Write-Error "$repoPath is not a Git repository. AI Dev Harness run requires a business Git repository."
 }
 
-$argsList = @(
-  $cliPath,
+$argList = @(
   "run",
   "--task",
   $Task,
@@ -45,9 +48,9 @@ $argsList = @(
 )
 
 if ($Live) {
-  $argsList += "--live"
+  $argList += "--live"
 }
 
 Write-Host "[harness-skill] starting harness: $Skill via $Agent"
-node @argsList
+node $cliPath @argList
 exit $LASTEXITCODE

package/templates/default-project/AGENTS.md

@@ -0,0 +1,9 @@
+# Project Agent Rules
+
+- Work inside this Git repository only.
+- Prefer small, reviewable changes.
+- Do not modify generated or dependency directories.
+- Always explain impact, risk, verification, and follow-up knowledge updates.
+- Before changing code, state assumptions, affected areas, and a minimal plan.
+- If required context is missing or confidence is low, stop and report what is missing instead of guessing.
+- Do not perform broad refactors, formatting-only sweeps, dependency upgrades, or unrelated cleanup unless the task explicitly asks for them.