@dotdotgod/hermes 0.6.7 → 0.7.0

package/mcp/cli.mjs

@@ -760,6 +760,24 @@ var init_parser = __esm({
   }
 });
 
+// packages/cli/src/graph-view/node-style.cjs
+var require_node_style = __commonJS({
+  "packages/cli/src/graph-view/node-style.cjs"(exports, module) {
+    var palette = ["#b9a3ff", "#70c9a2", "#72b9e6", "#d6b879", "#e393a9", "#78c9cd", "#a6c67a", "#e5a475"];
+    function describeNode(path, root = "docs") {
+      root = root.replace(/^\.\//, "").replace(/\/$/, "");
+      if (!path.startsWith(`${root}/`)) return { label: path, group: null, color: null };
+      const parts = path.slice(root.length + 1).split("/");
+      const group = parts.length === 1 ? root : parts.shift();
+      let hash2 = 0;
+      for (const char of group) hash2 = Math.imul(hash2, 31) + char.charCodeAt(0) >>> 0;
+      const known = { docs: "#b9a3ff", spec: "#72b9e6", arch: "#d6b879", test: "#70c9a2", concept: "#e393a9", report: "#78c9cd" };
+      return { label: parts.join("/"), group, color: known[group] ?? palette[hash2 % palette.length] };
+    }
+    module.exports = { describeNode };
+  }
+});
+
 // packages/cli/src/init.mjs
 import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync5, statSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { basename, dirname as dirname2, join as join5, resolve as resolve3 } from "node:path";
@@ -1503,9 +1521,15 @@ function memoryConfigSummary(config) {
 
 // packages/cli/src/config/templates.mjs
 var DEFAULT_TEMPLATE_NAME = "software";
+var engineeringScaffold = [
+  ["docs/spec/README.md", "Specs", "Use this area for behavior specs, API contracts, and requirements. Follow `dotdotgod validate` traceability guidance for applicable documents."],
+  ["docs/arch/README.md", "Architecture", "Use this area for architecture decisions, design rationale, conventions, and integration boundaries."],
+  ["docs/test/README.md", "Verification", "Use this area for test strategy, evaluation methods, regression cases, and verification records."]
+];
 var BUILT_IN_TEMPLATE_SCAFFOLDS = {
-  software: [],
+  software: engineeringScaffold,
   research: [
+    ...engineeringScaffold,
     ["docs/research/README.md", "Research", "Use this area for research notes, sources, and findings."],
     ["docs/record/README.md", "Research Records", "Use this area for dated measurements, experiments, and execution records."],
     ["docs/report/README.md", "Reports", "Use this area for research diagnoses, analyses, results, and performance reports."],
@@ -1771,11 +1795,10 @@ function formatAction(item) {
   return `${item.status.padEnd(13)} ${item.path}${extra}`;
 }
 function parseInitOptions(argv) {
-  const options = { root: null, projectName: "", dotdotSetting: false, dryRun: false, json: false, template: null, documentationRoot: "docs", documentationRootExplicit: false };
+  const options = { root: null, projectName: "", dryRun: false, json: false, template: null, documentationRoot: "docs", documentationRootExplicit: false };
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
     if (arg === "--json") options.json = true;
-    else if (arg === "--dotdot-setting") options.dotdotSetting = true;
     else if (arg === "--dry-run") options.dryRun = true;
     else if (arg === "--claude-plans") options.claudePlans = true;
     else if (arg === "--project-name" || arg === "--template" || arg === "--documentation-root") {
@@ -1854,8 +1877,7 @@ function ensureGitignoreEntry(options, entry, actions) {
 `);
   actions.push(action(existed ? "updated" : "created", target, { add: entry }));
 }
-function agentContent(projectName, dotdotSetting) {
-  const dotdotAgentRule = dotdotSetting ? "\n- Follow the project documentation structure in `docs/arch/DOCS_STRUCTURE.md` and code conventions in `docs/arch/CODE_CONVENTIONS.md`." : "";
+function agentContent(projectName, domainMap) {
   return `# AGENTS.md
 
 Canonical instructions for AI coding agents working in this repository.
@@ -1873,7 +1895,7 @@ Canonical instructions for AI coding agents working in this repository.
 - Preserve user edits and unrelated dirty worktree changes.
 - Prefer existing local patterns over introducing new abstractions.
 - Update docs when behavior, architecture, or test strategy changes.
-- When using the dotdotgod CLI, run \`dotdotgod validate\` after docs changes and follow its traceability guidance for behavior specs.${dotdotAgentRule}
+- When using the dotdotgod CLI, run \`dotdotgod validate\` after docs changes and follow its traceability guidance.
 
 ## dotdotgod
 
@@ -1898,15 +1920,12 @@ TODO
 
 ## Documentation Map
 
-- \`docs/spec/\`: product behavior, API contracts, user-facing requirements.
-- \`docs/test/\`: test strategy, regression cases, manual verification notes.
-- \`docs/arch/\`: architecture decisions, code conventions, module boundaries, data flow, infrastructure/runtime dependencies, integration boundaries, and migration design.
+${domainMap}
 - \`docs/\`: all directories use kebab-case; all markdown file names use UPPER_SNAKE_CASE, including \`README.md\`.
 - \`docs/\`: prefer keeping individual markdown files under the configured markdown validation budgets (default 200 lines and 10,000 characters); split larger docs into focused UPPER_SNAKE_CASE files and keep \`README.md\` as the index/overview unless a narrow size-check exception is configured.
 - \`docs/\`: when adding, renaming, splitting, moving, or archiving docs, update the nearest relevant \`README.md\` index/table of contents in the same change.
 - \`docs/\`: each docs subdirectory \`README.md\` acts as the local table of contents; list important files, task directories, status, and a one-line purpose for each entry.
 - \`docs/\`: start small with a single focused markdown file; when one domain grows into multiple docs, promote it to \`docs/<area>/<domain>/README.md\` plus related UPPER_SNAKE_CASE files in that directory.
-- \`docs/arch/\`: code conventions may start as \`CODE_CONVENTIONS.md\`; when they grow across multiple topics, use \`docs/arch/conventions/README.md\` as the index with supporting UPPER_SNAKE_CASE files.
 - \`docs/plan/\`: local active implementation plans. Create one kebab-case directory per task (\`docs/plan/<task-slug>/\`), keep the task overview/index in that directory's \`README.md\`, and add supporting UPPER_SNAKE_CASE plan files alongside it. Ignored by git by default.
 - \`docs/archive/\`: local completed plans, temporary reports, historical notes, payload captures. Move completed plan task directories to \`docs/archive/plan/<task-slug>/\`; put temporary reports and investigations under \`docs/archive/report/<report-slug>/\`. Ignored by git by default.
 
@@ -1917,7 +1936,7 @@ TODO
 
 Keep long-lived instructions here so agent-specific files do not drift.`;
 }
-function docsReadmeContent() {
+function docsReadmeContent(domainMap) {
   return `# Docs
 
 This directory keeps project knowledge close to the code.
@@ -1936,114 +1955,20 @@ This directory keeps project knowledge close to the code.
 
 ## Map
 
-- \`spec/\`: product behavior, API contracts, user-facing requirements.
-- \`test/\`: test strategy, regression cases, manual verification notes.
-- \`arch/\`: architecture decisions, code conventions, module boundaries, data flow, infrastructure/runtime dependencies, integration boundaries, and migration design.
+${domainMap.replaceAll("`docs/", "`")}
 - \`plan/\`: local active implementation plans. Create one kebab-case directory per task (\`plan/<task-slug>/\`), keep the task overview/index in that directory's \`README.md\`, and add supporting UPPER_SNAKE_CASE plan files alongside it. Ignored by git by default.
 - \`archive/\`: local completed plans, temporary reports, historical notes, payload captures. Move completed plan task directories to \`archive/plan/<task-slug>/\`; put temporary reports and investigations under \`archive/report/<report-slug>/\`. Ignored by git by default.`;
 }
-function docsStructureContent() {
-  return `# Docs Structure
-
-Long-term documentation structure for this project.
-
-## Top-Level Areas
-
-- \`docs/spec/\`: product behavior, API contracts, user-facing requirements, and feature contracts.
-- \`docs/test/\`: test strategy, coverage notes, regression cases, and manual verification records.
-- \`docs/arch/\`: architecture decisions, code conventions, module boundaries, data flow, infrastructure/runtime dependencies, integration boundaries, and migration design.
-- \`docs/plan/\`: local active implementation plans.
-- \`docs/archive/\`: local completed plans, historical notes, payload captures, and investigation notes.
-
-## Naming
-
-- Directories under \`docs/\` use kebab-case.
-- Markdown files under \`docs/\` use UPPER_SNAKE_CASE.
-- \`README.md\` is the only mixed-case markdown filename exception and is required for index/overview files.
-
-## File Size Guideline
-
-Prefer keeping individual markdown files under 200 lines and 10,000 characters. When either guideline is exceeded, split the document into focused UPPER_SNAKE_CASE files and keep \`README.md\` as the index/overview. Configured validation exceptions should stay narrow and intentional.
-
-## README Indexes
-
-Each docs subdirectory \`README.md\` acts as the local table of contents. It should list important files, task directories, status, and a one-line purpose for each entry.
-
-When adding, renaming, splitting, moving, or archiving docs, update the nearest relevant \`README.md\` in the same change.
-
-## Domain Directory Promotion
-
-Start small with one focused markdown file. When one domain grows into multiple docs, promote it to \`docs/<area>/<domain>/README.md\` and place related UPPER_SNAKE_CASE markdown files in that directory.
-
-## Spec Writing Contract
-
-Behavior specs describe the current product contract: supported commands, API shapes, user-visible behavior, defaults, constraints, and validation outcomes.
-
-Specs should not describe how behavior changed over time. Rewrite historical-change wording into direct current-state rules. Historical context, migration rationale, future extension ideas, and completed-plan notes belong in \`docs/arch/\`, \`docs/test/\`, \`docs/archive/\`, or active \`docs/plan/\` files rather than behavior specs. If compatibility behavior is still user-visible, keep it in the spec but phrase it as a current supported or unsupported rule.
-
-Config/action terms such as \`remove\`, \`exclude\`, \`fallback\`, and \`replacement semantics\` are allowed when they name current behavior precisely.
-
-## Traceability Blocks
-
-Behavior specs may include fenced \`json dotdotgod\` traceability blocks as the final section to connect specs to source, tests, related docs, and verification commands. The dotdotgod CLI owns the schema and validation behavior.
-
-## Plan and Archive Directories
-
-Active task plans use \`docs/plan/<task-slug>/README.md\`. Completed or superseded plan task directories move to \`docs/archive/plan/<task-slug>/\`. Temporary investigations, reports, payload captures, and historical notes move to \`docs/archive/report/<report-slug>/\`.
-
-\`docs/plan\` and \`docs/archive\` are ignored by git by default.`;
-}
-function codeConventionsContent() {
-  return `# Code Conventions
-
-Dotdot code conventions for keeping implementation simple and maintainable.
-
-## Abstraction Boundaries
-
-- Do not introduce unnecessary abstractions.
-- Do not abstract code that is not reused.
-- Do not abstract reused code when the reused behavior is likely to split into separate features or flows later.
-- Prefer local, explicit code until a stable reuse pattern appears.
-
-## Source File Size
-
-- Keep source files small enough to read in one focused pass by humans and coding agents.
-- If code grows beyond 150 lines, consider splitting or extracting focused units even when it is not reused.
-- Review files approaching 250 lines for focused extraction by responsibility.
-- Split by behavior or responsibility, not by arbitrary layers.
-
-## Dotdotgod Impact Hotspots
-
-- Treat repeated \`dotdotgod graph impact\` results that collapse onto one large file as a design signal, not as normal precision.
-- Dotdotgod impact reveals mixed-responsibility hotspots; it does not replace focused module boundaries.
-- When unrelated changes keep pointing to the same source file, split the file by behavior so impact results, tests, and docs can map to narrower responsibilities.
-
-## Extraction and Testability
-
-- Prefer extracting pure helpers when behavior can be tested without runtime dependencies.
-- Keep runtime integration explicit and local until reuse is stable.
-- Put testable logic in focused modules before adding broad framework abstractions.
-- Preserve plain-text readability: avoid dense clever code, hidden control flow, and large mixed-responsibility files.`;
-}
-function initFiles(options) {
-  const archReadmeExtra = options.dotdotSetting ? "\n\n## Index\n\n- `DOCS_STRUCTURE.md`: documentation layout, naming, README index, spec current-state writing contract, and domain directory promotion rules.\n- `CODE_CONVENTIONS.md`: dotdot code conventions, including abstraction boundaries, source file size guidance, impact hotspot handling, and extraction/testability rules. If conventions grow across multiple topics, promote them to `conventions/README.md` with supporting UPPER_SNAKE_CASE files." : "";
+function initFiles(options, scaffold) {
+  const domainMap = scaffold.filter((item) => item.type === "file").map((item) => `- \`${item.path.replace(/README\.md$/, "")}\`: ${item.content.split("\n\n")[1]}`).join("\n");
   const files = [
-    ["AGENTS.md", agentContent(options.projectName, options.dotdotSetting)],
+    ["AGENTS.md", agentContent(options.projectName, domainMap)],
     ["CLAUDE.md", "# CLAUDE.md\n\n@AGENTS.md"],
     ["CODEX.md", "# CODEX.md\n\nSee [AGENTS.md](./AGENTS.md)."],
-    ["docs/README.md", docsReadmeContent()],
-    ["docs/spec/README.md", "# Specs\n\nUse this area for behavior specs, API contracts, and product requirements.\n\nFor projects using the dotdotgod CLI, behavior specs may be required by `dotdotgod validate` to include fenced `json dotdotgod` traceability blocks as the final section. The CLI owns the schema and prints property-level repair guidance when validation fails."],
-    ["docs/test/README.md", "# Tests\n\nUse this area for test strategy, coverage notes, regression cases, and manual verification records."],
-    ["docs/arch/README.md", `# Architecture
-
-Use this area for architecture decisions, code conventions, module boundaries, data flow notes, infrastructure/runtime dependencies, integration boundaries, and migration design.${archReadmeExtra}`],
+    ["docs/README.md", docsReadmeContent(domainMap)],
     ["docs/plan/README.md", "# Plans\n\nUse this area for active implementation plans.\n\n## Naming\n\n- Task directories use kebab-case: `docs/plan/<task-slug>/`.\n- Markdown file names use UPPER_SNAKE_CASE: `README.md`, `RESEARCH_NOTES.md`, `VERIFICATION.md`.\n\n## Structure\n\n- Create one directory per task: `docs/plan/<task-slug>/`.\n- Put the task overview, index, scope, status, and main plan in `docs/plan/<task-slug>/README.md`.\n- Add supporting research, checklists, payload captures, or verification notes as additional UPPER_SNAKE_CASE markdown files in the same task directory.\n- Move completed or superseded task directories to `docs/archive/plan/<task-slug>/`.\n\nThis directory is local-only and ignored by git by default."],
     ["docs/archive/README.md", "# Archive\n\nUse this area for local completed plans, temporary reports, historical notes, payload captures, and investigation notes.\n\n## Naming\n\n- Archived plan task directories preserve their kebab-case task slug.\n- Archived report directories use a focused kebab-case report slug.\n- Markdown file names use UPPER_SNAKE_CASE, including `README.md`.\n\n## Structure\n\n- Move completed plan task directories from `docs/plan/<task-slug>/` to `docs/archive/plan/<task-slug>/`.\n- Put temporary investigations, reports, payload captures, and historical notes under `docs/archive/report/<report-slug>/`.\n- Preserve each archive directory's `README.md` overview/index and supporting UPPER_SNAKE_CASE markdown files.\n- Additional archive categories can be added later as focused kebab-case subdirectories when needed.\n\nThis directory is local-only and ignored by git by default."]
   ];
-  if (options.dotdotSetting) {
-    files.push(["docs/arch/DOCS_STRUCTURE.md", docsStructureContent()]);
-    files.push(["docs/arch/CODE_CONVENTIONS.md", codeConventionsContent()]);
-  }
   return files.map(([path, content]) => [path.replace(/^docs(?=\/|$)/, options.documentationRoot), content.replaceAll("docs/", `${options.documentationRoot}/`).replaceAll("`docs`", `\`${options.documentationRoot}\``)]);
 }
 function runInit(argv, usage2) {
@@ -2087,7 +2012,8 @@ function runInit(argv, usage2) {
 ` };
   }
   const actions = [];
-  for (const [relativePath, content] of initFiles(options)) writeInitFile(options, relativePath, content, actions);
+  const scaffold = template?.source === "bundled" ? builtInTemplateScaffold(template.name) : [];
+  for (const [relativePath, content] of initFiles(options, scaffold)) writeInitFile(options, relativePath, content, actions);
   if (template?.source === "bundled") {
     for (const item of builtInTemplateScaffold(template.name, { documentationRoot: options.documentationRoot }) ?? []) {
       if (item.type === "directory") ensureInitDirectory(options, item.path, actions);
@@ -2103,7 +2029,7 @@ function runInit(argv, usage2) {
       initError(options, "CLAUDE_SETTINGS_CHANGED", error.message);
     }
   }
-  const payload = { ok: true, command: "init", root: options.root, projectName: options.projectName, documentationRoot: options.documentationRoot, dryRun: options.dryRun, dotdotSetting: options.dotdotSetting, template: template ? { name: template.name, source: template.source, selectedBy: template.selectedBy } : null, actions };
+  const payload = { ok: true, command: "init", root: options.root, projectName: options.projectName, documentationRoot: options.documentationRoot, dryRun: options.dryRun, template: template ? { name: template.name, source: template.source, selectedBy: template.selectedBy } : null, actions };
   if (options.json) console.log(JSON.stringify(payload, null, 2));
   else {
     if (template) console.log(`template      ${template.source}:${template.name} (${template.selectedBy})`);
@@ -2123,7 +2049,7 @@ function commandUsage(command = "root") {
   dotdotgod validate <root> [--include-local-memory] [--check-index] [--max-lines n] [--max-chars n] [--no-link-check] [--json]`;
     case "init":
       return `Usage:
-  dotdotgod init <root> [--project-name NAME] [--template NAME] [--documentation-root PATH] [--dotdot-setting] [--claude-plans] [--dry-run] [--json]
+  dotdotgod init <root> [--project-name NAME] [--template NAME] [--documentation-root PATH] [--claude-plans] [--dry-run] [--json]
 
 Create AGENTS.md, agent entrypoints, docs indexes, a project config from an initialization template, and local memory gitignore entries.
 Use --claude-plans only after opting into project-local native plan storage; existing Claude settings are preserved.`;
@@ -2185,7 +2111,8 @@ Checks or writes generated Markdown traceability link sections from canonical fe
     case "graph":
       return `Usage:
   dotdotgod graph impact <root> --changed <path> [--changed <path> ...] [--compact|--json|--yml|--yaml]
-  dotdotgod graph serve <root> --changed <path> [--changed <path> ...] [--host HOST] [--port PORT]
+  dotdotgod graph serve <root> [--host HOST] [--port PORT]
+  dotdotgod graph export <root> [--json]
   dotdotgod graph communities <root> [--json]`;
     case "graph impact":
       return `Usage:
@@ -2194,9 +2121,14 @@ Checks or writes generated Markdown traceability link sections from canonical fe
 Ranks nodes related to one or more changed files. <root> is the project root; repeat --changed with project-relative file paths. Results include a combined ranking and the top five related nodes for each changed file. Use --compact for a short text summary or --yml/--yaml for structured agent-facing output.`;
     case "graph serve":
       return `Usage:
-  dotdotgod graph serve <root> --changed <path> [--changed <path> ...] [--host HOST] [--port PORT]
+  dotdotgod graph serve <root> [--host HOST] [--port PORT]
 
-Starts a local-only impact graph explorer. Changed files are rendered as root nodes and are excluded from related-result lists.`;
+Starts a standalone local traceability graph without Obsidian.`;
+    case "graph export":
+      return `Usage:
+  dotdotgod graph export <root> [--json]
+
+Write .dotdotgod/traceability.json for the Obsidian plugin.`;
     case "graph communities":
       return `Usage:
   dotdotgod graph communities <root> [--json]`;
@@ -2220,7 +2152,8 @@ Commands:
   status                Show local index status.
   traceability links    Check or write generated traceability links.
   graph impact          Find files related to changed files.
-  graph serve           Open a local impact graph explorer.
+  graph serve           Open a standalone local traceability graph.
+  graph export          Export traceability data for Obsidian.
   graph communities     Find groups of related project-memory nodes.
 
 Options:
@@ -2731,19 +2664,19 @@ function addConfiguredLocalMemoryCandidates(root, candidates, config, limit = 5e
   let added = 0;
   const addPath = (path) => {
     if (added >= limit || !existsSync7(path)) return;
-    let stat;
+    let stat2;
     try {
-      stat = statSync2(path);
+      stat2 = statSync2(path);
     } catch {
       return;
     }
     const pathRel = rel(root, path);
-    if (stat.isFile()) {
+    if (stat2.isFile()) {
       candidates.add(pathRel);
       added += 1;
       return;
     }
-    if (!stat.isDirectory() || isExcludedIndexDir(pathRel)) return;
+    if (!stat2.isDirectory() || isExcludedIndexDir(pathRel)) return;
     for (const entry of readdirSync(path, { withFileTypes: true })) {
       if (added >= limit) return;
       addPath(join6(path, entry.name));
@@ -3226,13 +3159,13 @@ var OUTLINE_SCHEMA = 1;
 var outlinePath = (root) => join11(root, ".dotdotgod", "outlines.json");
 function assertCachePath(root) {
   for (const path of [dirname8(outlinePath(root)), outlinePath(root)]) {
-    let stat;
+    let stat2;
     try {
-      stat = lstatSync3(path);
+      stat2 = lstatSync3(path);
     } catch (error) {
       if (error.code !== "ENOENT") throw error;
     }
-    if (stat?.isSymbolicLink()) throw new Error(`Outline cache must not use symlinks: ${path}`);
+    if (stat2?.isSymbolicLink()) throw new Error(`Outline cache must not use symlinks: ${path}`);
   }
 }
 function readOutlines(root) {
@@ -6100,9 +6033,9 @@ function prepareImpactReferences(index, root, changedPaths) {
     let result;
     try {
       const absolute = resolve15(root, path);
-      const stat = statSync8(absolute);
+      const stat2 = statSync8(absolute);
       result = { status: "exists" };
-      if (stat.isFile() && extname7(absolute) === ".md") result.anchors = extractAnchors(readFileSync18(absolute, "utf8"));
+      if (stat2.isFile() && extname7(absolute) === ".md") result.anchors = extractAnchors(readFileSync18(absolute, "utf8"));
     } catch (error) {
       result = { status: ["ENOENT", "ENOTDIR"].includes(error.code) ? "missing" : "unavailable" };
     }
@@ -6746,126 +6679,57 @@ function runTraceability(argv) {
   process.exit(ok ? 0 : 1);
 }
 
-// packages/cli/src/graph-view/server.mjs
-import { createServer } from "node:http";
-import { readFileSync as readFileSync21 } from "node:fs";
-import { dirname as dirname13, extname as extname10, join as join20 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+// packages/cli/src/commands/graph.mjs
+import { mkdir, writeFile, rename, rm } from "node:fs/promises";
+import { join as join21 } from "node:path";
 
-// packages/cli/src/graph-view/payload.mjs
-function edgeKey2(edge) {
-  return `${edge.source}\0${edge.target}\0${edge.relation}`;
-}
-function labelForNode(node2) {
-  if (node2.type === "contract") return node2.title ?? node2.contractId ?? node2.id;
-  return node2.path ?? node2.command ?? node2.name ?? node2.target ?? node2.id;
-}
-function adjacencyFor(nodes, edges) {
-  const adjacency = new Map(nodes.map((node2) => [node2.id, /* @__PURE__ */ new Set()]));
-  for (const edge of edges) {
-    adjacency.get(edge.source)?.add(edge.target);
-    adjacency.get(edge.target)?.add(edge.source);
-  }
-  return adjacency;
-}
-function rootReachability(nodes, edges, seedIds) {
-  const adjacency = adjacencyFor(nodes, edges);
-  const reachable = /* @__PURE__ */ new Set();
-  const depthByNode = /* @__PURE__ */ new Map();
-  const nearestRootByNode = /* @__PURE__ */ new Map();
-  const queue = [];
-  for (const node2 of nodes) {
-    if (!seedIds.has(node2.id)) continue;
-    reachable.add(node2.id);
-    depthByNode.set(node2.id, 0);
-    nearestRootByNode.set(node2.id, node2.id);
-    queue.push(node2.id);
-  }
-  for (let cursor = 0; cursor < queue.length; cursor += 1) {
-    const current = queue[cursor];
-    for (const neighbor of adjacency.get(current) ?? []) {
-      if (reachable.has(neighbor)) continue;
-      reachable.add(neighbor);
-      depthByNode.set(neighbor, (depthByNode.get(current) ?? 0) + 1);
-      nearestRootByNode.set(neighbor, nearestRootByNode.get(current));
-      queue.push(neighbor);
-    }
-  }
-  return { reachable, depthByNode, nearestRootByNode };
-}
-function buildImpactGraphPayload(index, impact) {
-  const graph = impact.structuralGraph ?? index?.graph ?? { nodes: [], edges: [] };
-  const config = index?.memoryConfig;
-  const seedIds = new Set((impact.changedFiles ?? [impact.changed]).map((path) => `file:${path}`));
-  const impactItems = new Map((impact.related ?? []).map((item) => [item.id, item]));
-  const isAllowedNode = (node2) => {
-    if (!node2) return false;
-    if (node2.path && resolveMemoryArea(node2.path, config)?.scope === "local") return false;
-    return true;
-  };
-  const sourceNodes = (graph.nodes ?? []).filter(isAllowedNode);
-  const indexedNodes = new Map(sourceNodes.map((node2) => [node2.id, node2]));
-  const seenEdges = /* @__PURE__ */ new Set();
+// packages/cli/src/graph-view/traceability.mjs
+import { resolve as resolve19 } from "node:path";
+import { stat } from "node:fs/promises";
+async function exportTraceability(root) {
+  const config = readMemoryConfig(root);
+  if (config.errors?.length) throw new Error(JSON.stringify(config.errors));
+  const { index } = readFreshIndex(root);
+  const nodes = new Map(index.graph.nodes.map((n) => [n.id, n]));
+  const colors = ["#b9a3ff", "#70c9a2", "#72b9e6", "#d6b879", "#e393a9", "#78c9cd"];
+  const types = config.traceability.keys.map((k, i) => ({ ...k, color: colors[i % colors.length] }));
+  const typesByRelation = new Map(types.map((t) => [t.relation, t]));
   const edges = [];
-  for (const edge of graph.edges ?? []) {
-    if (!indexedNodes.has(edge.source) || !indexedNodes.has(edge.target)) continue;
-    const key = edgeKey2(edge);
-    if (seenEdges.has(key)) continue;
-    seenEdges.add(key);
-    edges.push({ source: edge.source, target: edge.target, relation: edge.relation, confidence: edge.confidence, weight: edge.weight ?? edge.relationWeight, score: edge.score, traceabilityKey: edge.traceabilityKey });
-  }
-  const { reachable, depthByNode, nearestRootByNode } = rootReachability(sourceNodes, edges, seedIds);
-  const retainedNodes = sourceNodes.filter((node2) => reachable.has(node2.id));
-  const retainedEdges = edges.filter((edge) => reachable.has(edge.source) && reachable.has(edge.target));
-  const nodes = retainedNodes.map((source) => {
-    const item = impactItems.get(source.id);
-    const seed = seedIds.has(source.id);
-    return {
-      id: source.id,
-      type: source.type ?? item?.type ?? "file",
-      path: source.path ?? item?.path,
-      label: labelForNode({ ...source, ...item }),
-      seed,
-      ranked: Boolean(item),
-      depth: depthByNode.get(source.id) ?? 0,
-      nearestRoot: nearestRootByNode.get(source.id),
-      component: 0,
-      seededComponent: true,
-      impactScore: seed ? 100 : item?.impactScore ?? 0,
-      reasons: seed ? ["changed-file"] : item?.reasons ?? [],
-      scoreBreakdown: seed ? { seed: 100 } : item?.scoreBreakdown,
-      retrieval: item?.retrieval ?? source.retrieval,
-      contractId: item?.contractId ?? source.contractId,
-      title: item?.title ?? source.title,
-      sections: item?.sections ?? source.sections,
-      vectorEvidence: item?.vectorEvidence
-    };
-  });
+  for (const edge of index.graph.edges) {
+    const type = typesByRelation.get(edge.relation);
+    const source = nodes.get(edge.source)?.path;
+    const target = nodes.get(edge.target)?.path;
+    if (!type || !source || !target || source === target) continue;
+    if ([source, target].some((p) => resolveMemoryArea(p, config)?.scope === "local")) continue;
+    if (!(await Promise.all([source, target].map(async (p) => {
+      const absolute = resolve19(root, p);
+      if (!absolute.startsWith(resolve19(root) + "/")) return false;
+      try {
+        return (await stat(absolute)).isFile();
+      } catch {
+        return false;
+      }
+    }))).every(Boolean)) continue;
+    edges.push({ source, target, relation: type.relation, weight: type.weight, color: type.color });
+  }
   return {
-    changed: impact.changed,
-    changedFiles: impact.changedFiles ?? [impact.changed],
-    ranking: impact.ranking,
-    semantic: impact.semantic,
-    complete: true,
-    nodes,
-    edges: retainedEdges,
-    components: retainedNodes.length > 0 ? [{ id: 0, size: retainedNodes.length, seeded: true }] : [],
-    diagnostics: {
-      rootNodes: retainedNodes.filter((node2) => seedIds.has(node2.id)).length,
-      connectedNodes: retainedNodes.length,
-      disconnectedNodesOmitted: sourceNodes.length - retainedNodes.length,
-      maximumDepth: Math.max(0, ...depthByNode.values())
-    },
-    omittedRelated: impact.omittedRelated ?? 0
+    version: 1,
+    projectRoot: resolve19(root),
+    config: memoryConfigSummary(config),
+    types,
+    edges: [...new Map(edges.map((e) => [`${e.source}\0${e.target}\0${e.relation}`, e])).values()]
   };
 }
 
 // packages/cli/src/graph-view/server.mjs
+import { createServer } from "node:http";
+import { readFileSync as readFileSync21 } from "node:fs";
+import { dirname as dirname13, extname as extname10, join as join20, resolve as resolve20 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+var import_node_style = __toESM(require_node_style(), 1);
 var ASSET_ROOT = join20(dirname13(fileURLToPath2(import.meta.url)), "assets");
-var CONTENT_TYPES = { ".css": "text/css; charset=utf-8", ".html": "text/html; charset=utf-8", ".js": "text/javascript; charset=utf-8", ".map": "application/json; charset=utf-8" };
+var CONTENT_TYPES = { ".css": "text/css; charset=utf-8", ".html": "text/html; charset=utf-8", ".js": "text/javascript; charset=utf-8", ".cjs": "text/javascript; charset=utf-8", ".map": "application/json; charset=utf-8" };
 var VENDOR_FILES = {
-  "/vendor/sigma.js": new URL("../../node_modules/sigma/dist/sigma.min.js", import.meta.url),
-  "/vendor/graphology.js": new URL("../../node_modules/graphology/dist/graphology.umd.min.js", import.meta.url),
   "/vendor/d3.js": new URL("../../node_modules/d3/dist/d3.min.js", import.meta.url)
 };
 function json(response, status, value) {
@@ -6882,49 +6746,42 @@ function asset(response, file) {
     response.end("Not found");
   }
 }
-async function buildServedImpact(root, changedPaths) {
-  const normalized = [...new Set(changedPaths.map((path) => canonicalizeChangedPath(root, path)).filter(Boolean))];
-  const { status, index, metadata } = readFreshIndex(root);
-  const overlay = await buildVectorImpactOverlay(root, index, normalized);
-  const impact = buildImpactReport(index, normalized, { root, overlay, verboseSemantic: false, related: 40 });
-  const graph = buildImpactGraphPayload(index, impact);
-  const graphIds = new Set(graph.nodes.map((node2) => node2.id));
-  const explorerImpact = {
-    ...impact,
-    related: impact.related.filter((item) => graphIds.has(item.id))
-  };
-  return { ok: status.ok, status, metadata, impact: explorerImpact, graph };
-}
 async function startImpactGraphServer({ root, changed, host = "127.0.0.1", port = 0 }) {
-  let payload = await buildServedImpact(root, changed);
+  root = resolve20(root);
+  if (!["127.0.0.1", "localhost", "::1"].includes(host)) throw new Error("Graph UI is local-only; use a loopback host.");
+  const build = async () => {
+    const data = await exportTraceability(root);
+    const paths = [...new Set(data.edges.flatMap((e) => [e.source, e.target]))];
+    return { ...data, projectRoot: void 0, nodes: paths.map((path) => ({ id: path, ...import_node_style.default.describeNode(path, data.config.documentation.root) })) };
+  };
+  let payload = await build();
   const server = createServer(async (request, response) => {
     const url = new URL(request.url ?? "/", `http://${request.headers.host ?? host}`);
-    if (url.pathname === "/api/impact") return json(response, 200, payload);
-    if (url.pathname === "/api/reroot") {
-      const paths = url.searchParams.getAll("changed");
-      if (paths.length === 0) return json(response, 400, { ok: false, error: { code: "MISSING_CHANGED", message: "At least one changed path is required." } });
+    if (!["GET", "HEAD"].includes(request.method)) return json(response, 405, { error: "Method not allowed" });
+    if (url.pathname === "/api/graph") {
       try {
-        payload = await buildServedImpact(root, paths);
+        payload = await build();
         return json(response, 200, payload);
       } catch (error) {
         return json(response, 500, { ok: false, error: { code: "GRAPH_SERVE_FAILED", message: error instanceof Error ? error.message : String(error) } });
       }
     }
     if (VENDOR_FILES[url.pathname]) return asset(response, fileURLToPath2(VENDOR_FILES[url.pathname]));
+    if (url.pathname === "/policy.js") return asset(response, join20(ASSET_ROOT, "../policy.cjs"));
     const relative8 = url.pathname === "/" ? "index.html" : url.pathname.slice(1);
-    if (!["index.html", "app.css", "app.js"].includes(relative8)) {
+    if (!["index.html", "app.css", "app.js", "file-list.js", "graph-client.js", "layout.js"].includes(relative8)) {
       response.writeHead(404);
       return response.end("Not found");
     }
     return asset(response, join20(ASSET_ROOT, relative8));
   });
-  await new Promise((resolve19, reject) => {
+  await new Promise((resolve21, reject) => {
     server.once("error", reject);
-    server.listen(port, host, resolve19);
+    server.listen(port, host, resolve21);
   });
   const address = server.address();
   const actualPort = typeof address === "object" && address ? address.port : port;
-  return { server, url: `http://${host}:${actualPort}`, payload };
+  return { server, url: `http://${host.includes(":") ? `[${host}]` : host}:${actualPort}`, payload };
 }
 
 // packages/cli/src/impact/format.mjs
@@ -7080,9 +6937,25 @@ async function runGraph(argv) {
   const sub = argv[0];
   const isImpact = sub === "impact";
   const isServe = sub === "serve";
-  if (!["impact", "communities", "serve"].includes(sub)) usage(sub ? `Unknown graph command: ${sub}` : "Missing graph command.", "graph");
+  if (!["impact", "communities", "serve", "export"].includes(sub)) usage(sub ? `Unknown graph command: ${sub}` : "Missing graph command.", "graph");
   const options = parseGraphOptions(argv.slice(1));
-  if (isServe && options.changed.length === 0) usage("Missing required option: --changed <path>.", "graph serve");
+  if (sub === "export") {
+    const graph = await exportTraceability(options.root);
+    delete graph.projectRoot;
+    const directory = join21(options.root, ".dotdotgod");
+    await mkdir(directory, { recursive: true });
+    const path = join21(directory, "traceability.json");
+    const temporary = `${path}.${process.pid}.tmp`;
+    try {
+      await writeFile(temporary, JSON.stringify(graph, null, 2));
+      await rename(temporary, path);
+    } finally {
+      await rm(temporary, { force: true });
+    }
+    console.log(options.json ? JSON.stringify({ ok: true, path, edges: graph.edges.length }) : `graph export: ${path} (${graph.edges.length} relations)`);
+    return;
+  }
+  if (isServe && options.changed.length > 0) usage("graph serve now shows project traceability. Use graph impact for --changed analysis.", "graph serve");
   if (isServe && !Number.isInteger(options.port)) usage("Invalid --port. Use an integer from 0 through 65535.", "graph serve");
   if (isServe) {
     options.changed = [...new Set(options.changed.map((path) => canonicalizeChangedPath(options.root, path)).filter(Boolean))];

package/mcp/server.mjs

@@ -23310,7 +23310,6 @@ async function projectInitialize(input) {
   if (dryRun) args.push("--dry-run");
   if (input.projectName) args.push("--project-name", input.projectName);
   if (input.template) args.push("--template", input.template);
-  if (input.dotdotSetting) args.push("--dotdot-setting");
   return await cliJson(args, root2);
 }
 
@@ -23545,7 +23544,7 @@ function getJobs() {
   jobRunner ??= new IngestionJobRunner(getStore());
   return jobRunner;
 }
-var server = new McpServer({ name: "dotdotgod-context", version: "0.6.7" });
+var server = new McpServer({ name: "dotdotgod-context", version: "0.7.0" });
 var scopeSchema = external_exports.enum(["transient", "session", "project"]).optional();
 var outputModeSchema = external_exports.enum(["auto", "direct", "indexed", "discard"]).optional();
 var commandSchema = {
@@ -23702,8 +23701,7 @@ register("project_initialize", "Initialize project memory; dry-run is default an
   dryRun: external_exports.boolean().optional(),
   confirmWrite: external_exports.boolean().optional(),
   projectName: external_exports.string().optional(),
-  template: external_exports.string().optional(),
-  dotdotSetting: external_exports.boolean().optional()
+  template: external_exports.string().optional()
 }, (input) => projectInitialize(projectInput(input)), { destructiveHint: true });
 async function startServer() {
   await server.connect(new StdioServerTransport());

package/mcp/tools.json

@@ -814,9 +814,6 @@
         "template": {
           "type": "string"
         },
-        "dotdotSetting": {
-          "type": "boolean"
-        },
         "contextSessionId": {
           "type": "string",
           "description": "Host session identity; adapters supply this for shared MCP connections."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdotgod/hermes",
-  "version": "0.6.7",
+  "version": "0.7.0",
   "description": "Hermes CLI and messaging-gateway adapter without Plan Mode.",
   "type": "module",
   "publishConfig": {
@@ -13,7 +13,7 @@
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
     "esbuild": "0.27.3",
-    "@dotdotgod/context": "0.6.7"
+    "@dotdotgod/context": "0.7.0"
   },
   "files": [
     "plugin.yaml",

package/plugin.yaml

@@ -1,5 +1,5 @@
 name: dotdotgod
-version: 0.6.7
+version: 0.7.0
 description: Project memory, isolated context tools and impact checks for Hermes CLI and messaging gateway; no Plan Mode.
 author: dotdotgod
 license: Elastic-2.0

package/skills/project-initializer/scripts/init_project.sh

@@ -6,15 +6,13 @@ TEMPLATES_DIR="$SCRIPT_DIR/../templates"
 
 usage() {
   cat <<'EOF'
-Usage: init_project.sh <project-root> [--project-name NAME] [--template NAME] [--documentation-root PATH] [--dotdot-setting] [--dry-run]
+Usage: init_project.sh <project-root> [--project-name NAME] [--template NAME] [--documentation-root PATH] [--dry-run]
 
 Initializes:
   AGENTS.md, CLAUDE.md, CODEX.md
   dotdotgod.config.json
   docs/README.md
-  docs/spec/README.md
-  docs/test/README.md
-  docs/arch/README.md
+  Template-specific domain indexes (spec/arch/test only for software and research)
   docs/plan/README.md
   docs/archive/README.md
   .gitignore entries for docs/plan, docs/archive, and .dotdotgod
@@ -24,7 +22,6 @@ EOF
 PROJECT_ROOT=""
 PROJECT_NAME=""
 DRY_RUN=0
-DOTDOT_SETTING=0
 TEMPLATE_NAME="software"
 DOCUMENTATION_ROOT="docs"
 
@@ -51,10 +48,6 @@ while [ "$#" -gt 0 ]; do
       DOCUMENTATION_ROOT=$2
       shift 2
       ;;
-    --dotdot-setting)
-      DOTDOT_SETTING=1
-      shift
-      ;;
     --dry-run)
       DRY_RUN=1
       shift
@@ -195,21 +188,11 @@ if [ "$DRY_RUN" -ne 1 ]; then
   mkdir -p "$PROJECT_ROOT"
 fi
 
-DOTDOT_AGENT_RULE=""
-if [ "$DOTDOT_SETTING" -eq 1 ]; then
-  DOTDOT_AGENT_RULE='
-- Follow the project documentation structure in `$DOCUMENTATION_ROOT/arch/DOCS_STRUCTURE.md` and code conventions in `$DOCUMENTATION_ROOT/arch/CODE_CONVENTIONS.md`.'
-fi
-
-ARCH_README_EXTRA=""
-if [ "$DOTDOT_SETTING" -eq 1 ]; then
-  ARCH_README_EXTRA='
-
-## Index
-
-- `DOCS_STRUCTURE.md`: documentation layout, naming, README index, spec current-state writing contract, and domain directory promotion rules.
-- `CODE_CONVENTIONS.md`: dotdot code conventions, including abstraction boundaries, source file size guidance, impact hotspot handling, and extraction/testability rules. If conventions grow across multiple topics, promote them to `conventions/README.md` with supporting UPPER_SNAKE_CASE files.'
+DOMAIN_MAP=""
+if [ ! -e "$CONFIG_PATH" ]; then
+  DOMAIN_MAP=$(cat "$TEMPLATES_DIR/$TEMPLATE_NAME.map.md")
 fi
+DOMAIN_MAP=$(printf '%s' "$DOMAIN_MAP" | sed "s#\`docs/#\`$DOCUMENTATION_ROOT/#g")
 
 write_file "$PROJECT_ROOT/AGENTS.md" "# AGENTS.md
 
@@ -228,7 +211,7 @@ Canonical instructions for AI coding agents working in this repository.
 - Preserve user edits and unrelated dirty worktree changes.
 - Prefer existing local patterns over introducing new abstractions.
 - Update docs when behavior, architecture, or test strategy changes.
-- When using the dotdotgod CLI, run \`dotdotgod validate\` after docs changes and follow its traceability guidance for behavior specs.$DOTDOT_AGENT_RULE
+- When using the dotdotgod CLI, run \`dotdotgod validate\` after docs changes and follow its traceability guidance.
 
 ## dotdotgod
 
@@ -253,15 +236,12 @@ TODO
 
 ## Documentation Map
 
-- \`$DOCUMENTATION_ROOT/spec/\`: product behavior, API contracts, user-facing requirements.
-- \`$DOCUMENTATION_ROOT/test/\`: test strategy, regression cases, manual verification notes.
-- \`$DOCUMENTATION_ROOT/arch/\`: architecture decisions, code conventions, module boundaries, data flow, infrastructure/runtime dependencies, integration boundaries, and migration design.
+$DOMAIN_MAP
 - \`$DOCUMENTATION_ROOT/\`: all directories use kebab-case; all markdown file names use UPPER_SNAKE_CASE, including \`README.md\`.
 - \`$DOCUMENTATION_ROOT/\`: prefer keeping individual markdown files under 200 lines and under 10,000 characters; split larger docs into focused UPPER_SNAKE_CASE files and keep \`README.md\` as the index/overview.
 - \`$DOCUMENTATION_ROOT/\`: when adding, renaming, splitting, moving, or archiving docs, update the nearest relevant \`README.md\` index/table of contents in the same change.
 - \`$DOCUMENTATION_ROOT/\`: each docs subdirectory \`README.md\` acts as the local table of contents; list important files, task directories, status, and a one-line purpose for each entry.
 - \`$DOCUMENTATION_ROOT/\`: start small with a single focused markdown file; when one domain grows into multiple docs, promote it to \`$DOCUMENTATION_ROOT/<area>/<domain>/README.md\` plus related UPPER_SNAKE_CASE files in that directory.
-- \`$DOCUMENTATION_ROOT/arch/\`: code conventions may start as \`CODE_CONVENTIONS.md\`; when they grow across multiple topics, use \`$DOCUMENTATION_ROOT/arch/conventions/README.md\` as the index with supporting UPPER_SNAKE_CASE files.
 - \`$DOCUMENTATION_ROOT/plan/\`: local active implementation plans. Create one kebab-case directory per task (\`$DOCUMENTATION_ROOT/plan/<task-slug>/\`), keep the task overview/index in that directory's \`README.md\`, and add supporting UPPER_SNAKE_CASE plan files alongside it. Ignored by git by default.
 - \`$DOCUMENTATION_ROOT/archive/\`: local completed plans, temporary reports, historical notes, payload captures. Move completed plan task directories to \`$DOCUMENTATION_ROOT/archive/plan/<task-slug>/\`; put temporary reports and investigations under \`$DOCUMENTATION_ROOT/archive/report/<report-slug>/\`. Ignored by git by default.
 
@@ -298,111 +278,10 @@ This directory keeps project knowledge close to the code.
 
 ## Map
 
-- \`spec/\`: product behavior, API contracts, user-facing requirements.
-- \`test/\`: test strategy, regression cases, manual verification notes.
-- \`arch/\`: architecture decisions, code conventions, module boundaries, data flow, infrastructure/runtime dependencies, integration boundaries, and migration design.
+$(printf '%s' "$DOMAIN_MAP" | sed "s#\`$DOCUMENTATION_ROOT/#\`#g")
 - \`plan/\`: local active implementation plans. Create one kebab-case directory per task (\`plan/<task-slug>/\`), keep the task overview/index in that directory's \`README.md\`, and add supporting UPPER_SNAKE_CASE plan files alongside it. Ignored by git by default.
 - \`archive/\`: local completed plans, temporary reports, historical notes, payload captures. Move completed plan task directories to \`archive/plan/<task-slug>/\`; put temporary reports and investigations under \`archive/report/<report-slug>/\`. Ignored by git by default."
 
-write_file "$PROJECT_ROOT/$DOCUMENTATION_ROOT/spec/README.md" "# Specs
-
-Use this area for behavior specs, API contracts, and product requirements.
-
-For projects using the dotdotgod CLI, behavior specs may be required by \`dotdotgod validate\` to include fenced \`json dotdotgod\` traceability blocks as the final section. The CLI owns the schema and prints property-level repair guidance when validation fails."
-
-write_file "$PROJECT_ROOT/$DOCUMENTATION_ROOT/test/README.md" "# Tests
-
-Use this area for test strategy, coverage notes, regression cases, and manual verification records."
-
-write_file "$PROJECT_ROOT/$DOCUMENTATION_ROOT/arch/README.md" "# Architecture
-
-Use this area for architecture decisions, code conventions, module boundaries, data flow notes, infrastructure/runtime dependencies, integration boundaries, and migration design.$ARCH_README_EXTRA"
-
-if [ "$DOTDOT_SETTING" -eq 1 ]; then
-  write_file "$PROJECT_ROOT/$DOCUMENTATION_ROOT/arch/DOCS_STRUCTURE.md" "# Docs Structure
-
-Long-term documentation structure for this project.
-
-## Top-Level Areas
-
-- \`$DOCUMENTATION_ROOT/spec/\`: product behavior, API contracts, user-facing requirements, and feature contracts.
-- \`$DOCUMENTATION_ROOT/test/\`: test strategy, coverage notes, regression cases, and manual verification records.
-- \`$DOCUMENTATION_ROOT/arch/\`: architecture decisions, code conventions, module boundaries, data flow, infrastructure/runtime dependencies, integration boundaries, and migration design.
-- \`$DOCUMENTATION_ROOT/plan/\`: local active implementation plans.
-- \`$DOCUMENTATION_ROOT/archive/\`: local completed plans, historical notes, payload captures, and investigation notes.
-
-## Naming
-
-- Directories under \`$DOCUMENTATION_ROOT/\` use kebab-case.
-- Markdown files under \`$DOCUMENTATION_ROOT/\` use UPPER_SNAKE_CASE.
-- \`README.md\` is the only mixed-case markdown filename exception and is required for index/overview files.
-
-## File Size Guideline
-
-Prefer keeping individual markdown files under 200 lines and 10,000 characters. When either guideline is exceeded, split the document into focused UPPER_SNAKE_CASE files and keep \`README.md\` as the index/overview. Configured validation exceptions should stay narrow and intentional.
-
-## README Indexes
-
-Each docs subdirectory \`README.md\` acts as the local table of contents. It should list important files, task directories, status, and a one-line purpose for each entry.
-
-When adding, renaming, splitting, moving, or archiving docs, update the nearest relevant \`README.md\` in the same change.
-
-## Domain Directory Promotion
-
-Start small with one focused markdown file. When one domain grows into multiple docs, promote it to \`$DOCUMENTATION_ROOT/<area>/<domain>/README.md\` and place related UPPER_SNAKE_CASE markdown files in that directory.
-
-## Spec Writing Contract
-
-Behavior specs describe the current product contract: supported commands, API shapes, user-visible behavior, defaults, constraints, and validation outcomes.
-
-Specs should not describe how behavior changed over time. Rewrite historical-change wording into direct current-state rules. Historical context, migration rationale, future extension ideas, and completed-plan notes belong in \`$DOCUMENTATION_ROOT/arch/\`, \`$DOCUMENTATION_ROOT/test/\`, \`$DOCUMENTATION_ROOT/archive/\`, or active \`$DOCUMENTATION_ROOT/plan/\` files rather than behavior specs. If compatibility behavior is still user-visible, keep it in the spec but phrase it as a current supported or unsupported rule.
-
-Config/action terms such as \`remove\`, \`exclude\`, \`fallback\`, and \`replacement semantics\` are allowed when they name current behavior precisely.
-
-## Traceability Blocks
-
-Behavior specs may include fenced \`json dotdotgod\` traceability blocks as the final section to connect specs to source, tests, related docs, and verification commands. The dotdotgod CLI owns the schema and validation behavior.
-
-## Plan and Archive Directories
-
-Active task plans use \`$DOCUMENTATION_ROOT/plan/<task-slug>/README.md\`. Completed or superseded plan task directories move to \`$DOCUMENTATION_ROOT/archive/plan/<task-slug>/\`. Temporary investigations, reports, payload captures, and historical notes move to \`$DOCUMENTATION_ROOT/archive/report/<report-slug>/\`.
-
-\`$DOCUMENTATION_ROOT/plan\` and \`$DOCUMENTATION_ROOT/archive\` are ignored by git by default.
-"
-
-  write_file "$PROJECT_ROOT/$DOCUMENTATION_ROOT/arch/CODE_CONVENTIONS.md" "# Code Conventions
-
-Dotdot code conventions for keeping implementation simple and maintainable.
-
-## Abstraction Boundaries
-
-- Do not introduce unnecessary abstractions.
-- Do not abstract code that is not reused.
-- Do not abstract reused code when the reused behavior is likely to split into separate features or flows later.
-- Prefer local, explicit code until a stable reuse pattern appears.
-
-## Source File Size
-
-- Keep source files small enough to read in one focused pass by humans and coding agents.
-- If code grows beyond 150 lines, consider splitting or extracting focused units even when it is not reused.
-- Review files approaching 250 lines for focused extraction by responsibility.
-- Split by behavior or responsibility, not by arbitrary layers.
-
-## Dotdotgod Impact Hotspots
-
-- Treat repeated \`dotdotgod graph impact\` results that collapse onto one large file as a design signal, not as normal precision.
-- Dotdotgod impact reveals mixed-responsibility hotspots; it does not replace focused module boundaries.
-- When unrelated changes keep pointing to the same source file, split the file by behavior so impact results, tests, and docs can map to narrower responsibilities.
-
-## Extraction and Testability
-
-- Prefer extracting pure helpers when behavior can be tested without runtime dependencies.
-- Keep runtime integration explicit and local until reuse is stable.
-- Put testable logic in focused modules before adding broad framework abstractions.
-- Preserve plain-text readability: avoid dense clever code, hidden control flow, and large mixed-responsibility files.
-"
-fi
-
 write_file "$PROJECT_ROOT/$DOCUMENTATION_ROOT/plan/README.md" "# Plans
 
 Use this area for active implementation plans.
@@ -441,6 +320,19 @@ Use this area for local completed plans, temporary reports, historical notes, pa
 This directory is local-only and ignored by git by default."
 
 if [ ! -e "$CONFIG_PATH" ]; then
+case "$TEMPLATE_NAME" in
+  software|research)
+    write_file "$PROJECT_ROOT/$DOCUMENTATION_ROOT/spec/README.md" "# Specs
+
+Use this area for behavior specs, API contracts, and requirements. Follow \`dotdotgod validate\` traceability guidance for applicable documents."
+    write_file "$PROJECT_ROOT/$DOCUMENTATION_ROOT/arch/README.md" "# Architecture
+
+Use this area for architecture decisions, design rationale, conventions, and integration boundaries."
+    write_file "$PROJECT_ROOT/$DOCUMENTATION_ROOT/test/README.md" "# Verification
+
+Use this area for test strategy, evaluation methods, regression cases, and verification records."
+    ;;
+esac
 case "$TEMPLATE_NAME" in
   software)
     ;;

package/skills/project-initializer/templates/case-and-evidence.map.md

@@ -0,0 +1,3 @@
+- `docs/case/`: Use this area for canonical case facts, questions, and decisions.
+- `docs/evidence/`: Use this area for factual, legal, and other supporting evidence.
+- `docs/outputs/`: Use this area for maintained case outputs.

package/skills/project-initializer/templates/policy.map.md

@@ -0,0 +1,4 @@
+- `docs/policy/`: Use this area for integrated policy proposals and outputs.
+- `docs/sections/`: Use this area for source policy sections.
+- `docs/evidence/`: Use this area for evidence supporting policy proposals.
+- `docs/outputs/`: Use this area for maintained policy submission outputs.

package/skills/project-initializer/templates/portfolio.map.md

@@ -0,0 +1,4 @@
+- `docs/strategy/`: Use this area for portfolio strategy and risk rules.
+- `docs/positions/`: Use this area for position theses and investment conclusions.
+- `docs/journal/`: Use this area for dated investment decisions and reviews.
+- `docs/report/`: Use this area for maintained market research and analysis.

package/skills/project-initializer/templates/publication.map.md

@@ -0,0 +1,4 @@
+- `docs/outline/`: Use this area for publication structure and outlines.
+- `docs/chapters/`: Use this area for chapter plans and direction.
+- `docs/claims/`: Use this area for maintained claims and their support.
+- `docs/research/`: Use this area for research sources and supporting notes.

package/skills/project-initializer/templates/research.map.md

@@ -0,0 +1,6 @@
+- `docs/spec/`: Use this area for behavior specs, API contracts, and requirements. Follow `dotdotgod validate` traceability guidance for applicable documents.
+- `docs/arch/`: Use this area for architecture decisions, design rationale, conventions, and integration boundaries.
+- `docs/test/`: Use this area for test strategy, evaluation methods, regression cases, and verification records.
+- `docs/research/`: Use this area for research notes, sources, and findings.
+- `docs/record/`: Use this area for dated measurements, experiments, and execution records.
+- `docs/report/`: Use this area for research diagnoses, analyses, results, and performance reports.

package/skills/project-initializer/templates/software.map.md

@@ -0,0 +1,3 @@
+- `docs/spec/`: Use this area for behavior specs, API contracts, and requirements. Follow `dotdotgod validate` traceability guidance for applicable documents.
+- `docs/arch/`: Use this area for architecture decisions, design rationale, conventions, and integration boundaries.
+- `docs/test/`: Use this area for test strategy, evaluation methods, regression cases, and verification records.