dev-harness-cli 1.0.5 → 1.2.0

package/cli/lib/help.mjs

@@ -2,7 +2,7 @@
  * Help text builder — centralized to keep all formatting in one place.
  */
 
-const USAGE = `Usage: harness-dev <command> [options]
+const USAGE = `Usage: dev-harness <command> [options]
 
 Pipeline commands:
   init                  Scaffold full harness in current directory
@@ -53,14 +53,14 @@ Exit codes:
   2  Usage error (bad arguments)
   3  Internal error`;
 
-const VERSION = '1.0.5';
+const VERSION = '1.2.0';
 
 // Help text for JSON output
 function buildJsonHelp() {
   return {
     help: true,
     version: VERSION,
-    usage: 'harness-dev <command> [options]',
+    usage: 'dev-harness <command> [options]',
     commands: {
       init: 'Scaffold full harness in current directory',
       status: 'Show current phase + gate state + detected stack',
@@ -111,12 +111,12 @@ export function versionText(json = false) {
   if (json) {
     return JSON.stringify({ version: VERSION });
   }
-  return `harness-dev v${VERSION}`;
+  return `dev-harness v${VERSION}`;
 }
 
-// Per-command help text (for `harness-dev <command> --help`).
+// Per-command help text (for `dev-harness <command> --help`).
 const COMMAND_HELP = {
-  init: `Usage: harness-dev init [--stack <name>] [--target <dir>] [--force] [--no-git] [--json]
+  init: `Usage: dev-harness init [--stack <name>] [--target <dir>] [--force] [--no-git] [--json]
 
 Scaffold a full harness in the target directory:
   - Detects stack (or use --stack)
@@ -131,7 +131,7 @@ Flags:
   --no-git          Skip git init
   --json            JSON output`,
 
-  status: `Usage: harness-dev status [--target <dir>] [--json]
+  status: `Usage: dev-harness status [--target <dir>] [--json]
 
 Show current phase, gate state, detected stack, recent lessons, and next action.
 
@@ -139,7 +139,7 @@ Flags:
   --target <dir>    Project directory (default: cwd)
   --json            JSON output`,
 
-  phase: `Usage: harness-dev phase <name> [--target <dir>] [--git-ops] [--json]
+  phase: `Usage: dev-harness phase <name> [--target <dir>] [--git-ops] [--json]
 
 Invoke a phase. Valid phases: define, plan, build, verify, simplify, review, ship.
 
@@ -148,7 +148,7 @@ Flags:
   --git-ops         Execute git reset --hard + clean on retry (fresh context)
   --json            JSON output`,
 
-  validate: `Usage: harness-dev validate [--phase <name>] [--feature <id> --task <id>] [--target <dir>] [--json]
+  validate: `Usage: dev-harness validate [--phase <name>] [--feature <id> --task <id>] [--target <dir>] [--json]
 
 Run gate checks for the current (or specified) phase.
 
@@ -159,39 +159,39 @@ Flags:
   --target <dir>    Project directory (default: cwd)
   --json            JSON output`,
 
-  'set-mode': `Usage: harness-dev set-mode <copilot|autopilot> [--target <dir>] [--json]
+  'set-mode': `Usage: dev-harness set-mode <copilot|autopilot> [--target <dir>] [--json]
 
 Switch execution mode. Autopilot requires DEFINE phase or later.`,
 
-  config: `Usage: harness-dev config list [--target <dir>] [--json]
-       harness-dev config get [key] [--target <dir>] [--json]
-       harness-dev config set <key> <value> [--target <dir>] [--json]
+  config: `Usage: dev-harness config list [--target <dir>] [--json]
+       dev-harness config get [key] [--target <dir>] [--json]
+       dev-harness config set <key> <value> [--target <dir>] [--json]
 
 List all parameters with descriptions, or get/set values via dot-notation.
 Use 'config list' to see all configurable parameters, their current values,
 types, allowed options, and descriptions.
 
 Examples:
-  harness-dev config list
-  harness-dev config list --json
-  harness-dev config get gates.enabled
-  harness-dev config set gates.enabled true
-  harness-dev config set mode autopilot
-  harness-dev config set maxRetries 5`,
+  dev-harness config list
+  dev-harness config list --json
+  dev-harness config get gates.enabled
+  dev-harness config set gates.enabled true
+  dev-harness config set mode autopilot
+  dev-harness config set maxRetries 5`,
 
-  pause: `Usage: harness-dev pause [--target <dir>] [--json]
+  pause: `Usage: dev-harness pause [--target <dir>] [--json]
 
 Pause autopilot execution. Autopilot stops after the current phase gate.`,
 
-  resume: `Usage: harness-dev resume [--target <dir>] [--json]
+  resume: `Usage: dev-harness resume [--target <dir>] [--json]
 
 Resume autopilot execution.`,
 
-  learn: `Usage: harness-dev learn "<message>" [--target <dir>] [--json]
+  learn: `Usage: dev-harness learn "<message>" [--target <dir>] [--json]
 
 Append a lesson to the Lessons section of progress.md.`,
 
-  contract: `Usage: harness-dev contract <subcommand> [options] [--target <dir>] [--json]
+  contract: `Usage: dev-harness contract <subcommand> [options] [--target <dir>] [--json]
 
 Subcommands:
   propose --scope "..." [--exclusions "..."] [--criteria "..."]   Generator proposes
@@ -199,7 +199,7 @@ Subcommands:
   status                                                            Show contract state
   escalate [--reason "..."]                                         Human adjudication`,
 
-  worktree: `Usage: harness-dev worktree <subcommand> [options] [--target <dir>] [--json]
+  worktree: `Usage: dev-harness worktree <subcommand> [options] [--target <dir>] [--json]
 
 Subcommands:
   create <name>   Create isolated worktree for a feature
@@ -207,25 +207,25 @@ Subcommands:
   prune           Remove orphaned worktrees
   remove <name>   Clean up worktree (optionally merge branch)`,
 
-  rollback: `Usage: harness-dev rollback <subcommand> [checkpoint] [--target <dir>] [--json]
+  rollback: `Usage: dev-harness rollback <subcommand> [checkpoint] [--target <dir>] [--json]
 
 Subcommands:
   list            Show available checkpoints
   to <tag>        Restore state to a checkpoint
   branch <tag>    Branch off a good iteration`,
 
-  checkpoint: `Usage: harness-dev checkpoint create <label> [--force] [--target <dir>] [--json]
+  checkpoint: `Usage: dev-harness checkpoint create <label> [--force] [--target <dir>] [--json]
 
 Create a manual checkpoint tag (manual/<label>). Requires clean working tree
 unless --force is given.`,
 
-  'detect-tool': `Usage: harness-dev detect-tool [--target <dir>] [--json]
+  'detect-tool': `Usage: dev-harness detect-tool [--target <dir>] [--json]
 
 Scan the project for agent-tool files (CLAUDE.md, .cursorrules, AGENTS.md, etc.)
 and report which coding agents are available. Recommends a tool based on config
 and detected files.`,
 
-  help: `Usage: harness-dev help
+  help: `Usage: dev-harness help
 
 Show the global help message. Alias for --help.`,
 };

package/cli/lib/paths.mjs

@@ -37,39 +37,118 @@ export const FEATURE_LIST_SCHEMA_PATH = resolve(SCHEMA_DIR, 'feature-list.schema
 export const STACKS_SCHEMA_PATH = resolve(LIB_DIR, 'schemas', 'stacks.json');
 
 // ── Project-relative paths (target project, not this CLI) ────────────────────
+// All harness-managed files live under harness/ with subfolder grouping:
+//   harness/              — config, progress, contract, rubric, handoff, checklist
+//   harness/features/     — feature list + schema
+//   harness/docs/         — architecture, constraints, decisions, agent docs, phase docs
+//   harness/ci/           — CI/CD templates
+//   harness/scripts/      — init scripts
+// AGENTS.md stays in root (agent tools expect it there).
 
 /**
- * Path to a project's harness-config.json.
+ * Harness root directory within a target project.
+ * @param {string} targetDir
+ * @returns {string}
+ */
+export function HARNESS_DIR(targetDir) {
+  return resolve(targetDir, 'harness');
+}
+
+/**
+ * Path to a project's config.json (harness/config.json).
  * @param {string} targetDir
  * @returns {string}
  */
 export function CONFIG_PATH(targetDir) {
-  return resolve(targetDir, 'harness-config.json');
+  return resolve(HARNESS_DIR(targetDir), 'config.json');
 }
 
 /**
- * Path to a project's feature_list.json.
+ * Path to a project's feature-list.json (harness/features/feature-list.json).
  * @param {string} targetDir
  * @returns {string}
  */
 export function FEATURE_LIST_PATH(targetDir) {
-  return resolve(targetDir, 'feature_list.json');
+  return resolve(HARNESS_DIR(targetDir), 'features', 'feature-list.json');
 }
 
 /**
- * Path to a project's sprint-contract.md.
+ * Path to a project's sprint-contract.md (harness/sprint-contract.md).
  * @param {string} targetDir
  * @returns {string}
  */
 export function CONTRACT_PATH(targetDir) {
-  return resolve(targetDir, 'sprint-contract.md');
+  return resolve(HARNESS_DIR(targetDir), 'sprint-contract.md');
 }
 
 /**
- * Path to a project's progress.md.
+ * Path to a project's progress.md (harness/progress.md).
  * @param {string} targetDir
  * @returns {string}
  */
 export function PROGRESS_PATH(targetDir) {
-  return resolve(targetDir, 'progress.md');
+  return resolve(HARNESS_DIR(targetDir), 'progress.md');
+}
+
+/**
+ * Path to a project's evaluator-rubric.md (harness/evaluator-rubric.md).
+ * @param {string} targetDir
+ * @returns {string}
+ */
+export function RUBRIC_PATH(targetDir) {
+  return resolve(HARNESS_DIR(targetDir), 'evaluator-rubric.md');
+}
+
+/**
+ * Path to a project's session-handoff.md (harness/session-handoff.md).
+ * @param {string} targetDir
+ * @returns {string}
+ */
+export function HANDOFF_PATH(targetDir) {
+  return resolve(HARNESS_DIR(targetDir), 'session-handoff.md');
+}
+
+/**
+ * Path to a project's clean-state-checklist.md (harness/clean-state-checklist.md).
+ * @param {string} targetDir
+ * @returns {string}
+ */
+export function CHECKLIST_PATH(targetDir) {
+  return resolve(HARNESS_DIR(targetDir), 'clean-state-checklist.md');
+}
+
+/**
+ * Path to a project's ARCHITECTURE.md (harness/docs/ARCHITECTURE.md).
+ * @param {string} targetDir
+ * @returns {string}
+ */
+export function ARCHITECTURE_PATH(targetDir) {
+  return resolve(HARNESS_DIR(targetDir), 'docs', 'ARCHITECTURE.md');
+}
+
+/**
+ * Path to a project's CONSTRAINTS.md (harness/docs/CONSTRAINTS.md).
+ * @param {string} targetDir
+ * @returns {string}
+ */
+export function CONSTRAINTS_PATH(targetDir) {
+  return resolve(HARNESS_DIR(targetDir), 'docs', 'CONSTRAINTS.md');
+}
+
+/**
+ * Path to a project's DECISIONS.md (harness/docs/DECISIONS.md).
+ * @param {string} targetDir
+ * @returns {string}
+ */
+export function DECISIONS_PATH(targetDir) {
+  return resolve(HARNESS_DIR(targetDir), 'docs', 'DECISIONS.md');
+}
+
+/**
+ * Path to a project's AGENTS.md (stays in root — agent tools expect it there).
+ * @param {string} targetDir
+ * @returns {string}
+ */
+export function AGENTS_PATH(targetDir) {
+  return resolve(targetDir, 'AGENTS.md');
 }

package/cli/lib/ralph-inner.mjs

@@ -259,7 +259,7 @@ export function runPhase(targetDir, phase, options = {}) {
     // Human output
     process.stdout.write(output);
     process.stdout.write(`\n═══════════════════════════════════════\n`);
-    process.stdout.write(`Run: harness-dev validate --feature ${feature.id} --task ${task.id}\n`);
+    process.stdout.write(`Run: dev-harness validate --feature ${feature.id} --task ${task.id}\n`);
     process.stdout.write(`═══════════════════════════════════════\n`);
 
     return {
@@ -298,7 +298,7 @@ export function runPhase(targetDir, phase, options = {}) {
   // Human output
   process.stdout.write(output);
   process.stdout.write(`\n═══════════════════════════════════════\n`);
-  process.stdout.write(`Run: harness-dev validate\n`);
+  process.stdout.write(`Run: dev-harness validate\n`);
   process.stdout.write(`═══════════════════════════════════════\n`);
 
   return {

package/cli/lib/ralph-outer.mjs

@@ -98,7 +98,7 @@ export function continuePipeline(targetDir, completedPhase, options = {}) {
 
   if (mode === 'copilot') {
     // Copilot: print instructions for next phase
-    const msg = `${completedPhase.toUpperCase()} complete. Next: harness-dev phase ${nextPhase}`;
+    const msg = `${completedPhase.toUpperCase()} complete. Next: dev-harness phase ${nextPhase}`;
     if (json) {
       return {
         ok: true,
@@ -128,7 +128,7 @@ export function continuePipeline(targetDir, completedPhase, options = {}) {
 
   // Re-check pause before auto-advancing (user may have paused during phase execution)
   if (config.paused) {
-    const msg = `Autopilot paused after "${completedPhase}". Run: harness-dev resume`;
+    const msg = `Autopilot paused after "${completedPhase}". Run: dev-harness resume`;
     if (verbose && !json) {
       process.stdout.write(`\n  ⏸ ${msg}\n`);
     }
@@ -205,7 +205,7 @@ export function continuePipeline(targetDir, completedPhase, options = {}) {
  * Run the full autopilot pipeline from current state through SHIP.
  *
  * This is a convenience wrapper — normally autopilot is triggered
- * by calling `harness-dev phase <name>` while in autopilot mode.
+ * by calling `dev-harness phase <name>` while in autopilot mode.
  *
  * @param {string} targetDir
  * @param {object} [options]

package/cli/lib/ralph-output.mjs

@@ -171,7 +171,7 @@ export function buildDeliverableRetryOutput(phase, mode, maxRetries, resetOnRetr
   }
 
   out += `\n`;
-  out += `When done, run: harness-dev validate\n`;
+  out += `When done, run: dev-harness validate\n`;
   if (resetOnRetry) {out += `Git reset on retry: enabled\n`;}
   if (autoCommit) {out += `Auto-commit: enabled\n`;}
   return out;

package/cli/lib/scaffold.mjs

@@ -212,12 +212,13 @@ work/
 // ── Extra scaffolding files (not covered by templates) ───────────────────────
 
 /**
- * Inline content for files beyond the 5 template-based ones.
- * Key is relative output path, value is file content.
+ * Inline content for files beyond the template-based ones.
+ * Key is relative output path (under harness/), value is file content.
+ * All harness-managed files go under harness/ with subfolder grouping.
  */
 export function getExtraFiles(stack) {
   return {
-    'feature_list.json': JSON.stringify({
+    'harness/features/feature-list.json': JSON.stringify({
       version: '0.1',
       features: [
         {
@@ -232,7 +233,7 @@ export function getExtraFiles(stack) {
       ],
     }, null, 2) + '\n',
 
-    'feature-list.schema.json': JSON.stringify({
+    'harness/features/feature-list.schema.json': JSON.stringify({
       $schema: 'http://json-schema.org/draft-07/schema#',
       title: 'Feature List',
       type: 'object',
@@ -266,7 +267,7 @@ export function getExtraFiles(stack) {
       },
     }, null, 2) + '\n',
 
-    'session-handoff.md': `# Session Handoff
+    'harness/session-handoff.md': `# Session Handoff
 
 ## Context
 
@@ -296,7 +297,7 @@ export function getExtraFiles(stack) {
 | ... | ... |
 `,
 
-    'clean-state-checklist.md': `# Clean State Checklist
+    'harness/clean-state-checklist.md': `# Clean State Checklist
 
 Run this before starting any phase to ensure deterministic state.
 
@@ -308,10 +309,10 @@ Run this before starting any phase to ensure deterministic state.
 
 ## Harness
 
-- [ ] \`harness-config.json\` exists and valid
+- [ ] \`harness/config.json\` exists and valid
 - [ ] Current phase matches what we're about to run
-- [ ] \`progress.md\` has latest Session State
-- [ ] \`feature_list.json\` up-to-date
+- [ ] \`harness/progress.md\` has latest Session State
+- [ ] \`harness/features/feature-list.json\` up-to-date
 
 ## Environment
 
@@ -320,7 +321,7 @@ Run this before starting any phase to ensure deterministic state.
 - [ ] No stale background processes
 `,
 
-    'ARCHITECTURE.md': `# Architecture
+    'harness/docs/ARCHITECTURE.md': `# Architecture
 
 ## Module Structure
 
@@ -330,7 +331,7 @@ src/
 \`\`\`
 `,
 
-    'CONSTRAINTS.md': `# Constraints
+    'harness/docs/CONSTRAINTS.md': `# Constraints
 
 ## Technical
 
@@ -351,7 +352,7 @@ src/
 - Fail fast, fail loud
 `,
 
-    'DECISIONS.md': `# Decisions
+    'harness/docs/DECISIONS.md': `# Decisions
 
 <!-- Record architectural and design decisions here. Use the format below. -->
 
@@ -372,7 +373,7 @@ src/
 | | | |
 `,
 
-    'docs/api-patterns.md': `# API Patterns
+    'harness/docs/api-patterns.md': `# API Patterns
 
 ## Conventions
 
@@ -417,11 +418,10 @@ export function getVersionFileContent(stack) {
  * Return .gitignore content for the given stack.
  */
 export function getGitignoreContent(stack) {
-  return `# Harness scaffold
-harness-config.json
-feature_list.json
-feature-list.schema.json
-progress.md
+  return `# Harness runtime state (regenerated by dev-harness)
+harness/config.json
+harness/features/feature-list.json
+harness/progress.md
 
 ${GITIGNORE_PATTERNS[stack] || GITIGNORE_PATTERNS.generic}
 # OS

package/cli/lib/state.mjs

@@ -124,7 +124,7 @@ export function loadConfig(targetDir) {
       config: defaults,
       path: cfgPath,
       ok: false,
-      error: `Not found: ${cfgPath}. Run: harness-dev init`,
+      error: `Not found: ${cfgPath}. Run: dev-harness init`,
     };
   }
 

package/cli/lib/templates.mjs

@@ -111,6 +111,42 @@ export function discoverTemplates() {
   }
 }
 
+/**
+ * Map a template's relative path to its output path under harness/.
+ * Templates that are harness-managed go into harness/ subfolders.
+ * AGENTS.md stays in project root (agent tools expect it there).
+ *
+ * Mapping:
+ *   AGENTS.md                  → AGENTS.md (root)
+ *   harness-config.json        → harness/config.json
+ *   progress.md                → harness/progress.md
+ *   sprint-contract.md         → harness/sprint-contract.md
+ *   evaluator-rubric.md        → harness/evaluator-rubric.md
+ *   init.sh / init.ps1         → harness/scripts/init.sh
+ *   ci/*                       → harness/ci/*
+ *   docs/*                     → harness/docs/*
+ *
+ * @param {string} relPath — relative path within templates/
+ * @returns {string} — relative output path within target
+ */
+function mapTemplateOutput(relPath) {
+  // AGENTS.md stays in root
+  if (relPath === 'AGENTS.md') return relPath;
+  // harness-config.json → harness/config.json
+  if (relPath === 'harness-config.json') return 'harness/config.json';
+  // Top-level harness files → harness/
+  const harnessRootFiles = ['progress.md', 'sprint-contract.md', 'evaluator-rubric.md'];
+  if (harnessRootFiles.includes(relPath)) return `harness/${relPath}`;
+  // init scripts → harness/scripts/
+  if (relPath === 'init.sh' || relPath === 'init.ps1') return `harness/scripts/${relPath}`;
+  // ci/ → harness/ci/
+  if (relPath.startsWith('ci/')) return `harness/${relPath}`;
+  // docs/ → harness/docs/
+  if (relPath.startsWith('docs/')) return `harness/${relPath}`;
+  // Default: put under harness/
+  return `harness/${relPath}`;
+}
+
 /**
  * Run the template engine.
  *
@@ -147,7 +183,8 @@ export function generateTemplates(opts) {
     const relativePath = tmplPath.startsWith(TEMPLATES_DIR + '/')
       ? tmplPath.slice(TEMPLATES_DIR.length + 1)
       : basename(tmplPath);
-    const outPath = join(target, relativePath);
+    const outputRel = mapTemplateOutput(relativePath);
+    const outPath = join(target, outputRel);
     const outDir = dirname(outPath);
 
     try {

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "dev-harness-cli",
-  "version": "1.0.5",
+  "version": "1.2.0",
   "description": "Agent-agnostic software development harness CLI — scaffold, phase orchestration, gate validation for any coding agent",
   "type": "module",
   "bin": {
-    "harness-dev": "cli/harness-dev.mjs"
+    "dev-harness": "cli/dev-harness.mjs"
   },
   "files": [
     "cli/",
@@ -37,8 +37,12 @@
     "cli"
   ],
   "scripts": {
-    "check": "node --check cli/harness-dev.mjs && echo 'Syntax OK'",
-    "postinstall": "node -e \"try{process.stdout.write('harness-dev installed. Run: npx harness-dev --help\\n')}catch(e){}\""
+    "lint": "eslint cli/",
+    "lint:fix": "eslint cli/ --fix",
+    "check": "node --check cli/dev-harness.mjs && echo 'Syntax OK'",
+    "test": "node test/run-all.mjs",
+    "test:verbose": "node test/run-all.mjs --verbose",
+    "postinstall": "node -e \"try{process.stdout.write('dev-harness installed. Run: npx dev-harness --help\\n')}catch(e){}\""
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/schema/feature-list.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Feature List",
+  "description": "Schema for feature_list.json — tracks features and their tasks through the pipeline",
+  "type": "object",
+  "required": ["version", "features"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Schema version",
+      "default": "0.1"
+    },
+    "features": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "name", "passes", "tasks"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique feature identifier (e.g. feature-001)"
+          },
+          "name": {
+            "type": "string",
+            "description": "Human-readable feature name"
+          },
+          "description": {
+            "type": "string",
+            "description": "Optional feature description"
+          },
+          "passes": {
+            "type": "boolean",
+            "default": false,
+            "description": "All tasks completed and verified"
+          },
+          "tasks": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["id", "description", "status"],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "Unique task identifier"
+                },
+                "description": {
+                  "type": "string",
+                  "description": "Task description"
+                },
+                "status": {
+                  "type": "string",
+                  "enum": ["pending", "in_progress", "complete", "blocked"],
+                  "default": "pending",
+                  "description": "Task status"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/templates/AGENTS.md

@@ -3,9 +3,9 @@
 ## Quick Start
 
 ```bash
-harness-dev status        # Where are we?
-harness-dev phase <name>  # Invoke a phase
-harness-dev validate      # Check gate criteria
+dev-harness status        # Where are we?
+dev-harness phase <name>  # Invoke a phase
+dev-harness validate      # Check gate criteria
 ```
 
 ## Project
@@ -18,7 +18,7 @@ harness-dev validate      # Check gate criteria
 
 INIT → DEFINE → PLAN → BUILD → VERIFY → [SIMPLIFY] → REVIEW → SHIP
 
-See `docs/phases/` for phase-specific instructions.
+See `harness/docs/phases/` for phase-specific instructions.
 
 ## Agent Roles
 
@@ -31,23 +31,27 @@ See `docs/phases/` for phase-specific instructions.
 
 ## Key Files
 
+All harness-managed files live under `harness/` (except `AGENTS.md` which stays in root for agent tool compatibility).
+
 | File | Purpose |
 |------|---------|
-| `harness-config.json` | Config + state |
-| `feature_list.json` | Feature list with passes |
-| `progress.md` | Session state + lessons |
-| `sprint-contract.md` | Pre-build agreement |
-| `init.sh` | Install → verify → start |
-| `evaluator-rubric.md` | Quality scorecard (6 dimensions, 0-2) |
-|
+| `AGENTS.md` | This file — agent instructions (root) |
+| `harness/config.json` | Config + state |
+| `harness/features/feature-list.json` | Feature list with passes |
+| `harness/progress.md` | Session state + lessons |
+| `harness/sprint-contract.md` | Pre-build agreement |
+| `harness/scripts/init.sh` | Install → verify → start |
+| `harness/evaluator-rubric.md` | Quality scorecard (6 dimensions, 0-2) |
+| `harness/docs/` | Architecture, constraints, decisions, agent guides, phase guides |
+
 ## Rules (non-negotiable)
 
 1. No agent evaluates its own work — Evaluator always judges
-2. Read `progress.md` + this file before each operation
+2. Read `harness/progress.md` + this file before each operation
 3. Commit frequently — each iteration is a checkpoint
-4. If unsure → read the role guide in `docs/agents/`
-5. Never skip gates — run `harness-dev validate` after each phase
-6. Fresh context per retry — pass `--git-ops` to `harness-dev phase <name>` to auto-reset the working tree on retry (off by default; agent-agnostic)
+4. If unsure → read the role guide in `harness/docs/agents/`
+5. Never skip gates — run `dev-harness validate` after each phase
+6. Fresh context per retry — pass `--git-ops` to `dev-harness phase <name>` to auto-reset the working tree on retry (off by default; agent-agnostic)
 7. **No files in project root** unless they are harness-managed files (listed in Key Files above) or standard project files (README.md, LICENSE, CHANGELOG.md, CONTRIBUTING.md, .gitignore, and the stack config file like package.json/pyproject.toml/Cargo.toml). All source code, tests, scripts, and docs go in subdirectories.
 8. **Structure from the start** — create folders for your work on day one and stick to them. Suggested layout: `src/` (source), `tests/` (tests), `docs/` (documentation), `scripts/` (automation). Do not dump files at root "temporarily" — there is no temporary.
 9. **No orphaned files** — every file you create must have a clear purpose and be referenced by imports, configs, docs, or the build system. If you create a file, wire it in immediately. Delete files you stop using.