@dotdotgod/claude-code 0.2.20 → 0.2.22

package/commands/dd/init.md

@@ -14,11 +14,27 @@ Arguments: `$ARGUMENTS`
 
 ## Goal
 
-Create a non-destructive dotdotgod baseline with canonical agent instructions, thin agent entrypoints, documentation indexes, project config, and local-memory ignore rules.
+Create a non-destructive dotdotgod baseline with canonical agent instructions, thin agent entrypoints, documentation indexes, a project config selected from an appropriate initialization template, and local-memory ignore rules.
+
+## Template Selection
+
+1. Inspect existing agent instructions, the root README, docs indexes, major top-level directories, config, and ignore rules.
+2. Discover custom templates as individual JSON files under `~/.dotdotgod/templates/`. Built-in templates are `software`, `research`, `case-and-evidence`, `publication`, `portfolio`, and `policy`.
+3. Choose from project evidence:
+   - `software`: application, library, or infrastructure projects organized around specs, architecture, source, and tests.
+   - `research`: research diaries, dated records, reports, artifacts, and evaluation evidence.
+   - `case-and-evidence`: canonical case records, evidence or legal grounds, and case outputs.
+   - `publication`: briefs, outlines, chapters, claims, manuscripts, and research sources.
+   - `portfolio`: strategy, positions, ledgers, journals, and market research.
+   - `policy`: policy sections, integrated proposals, evidence, and submission outputs.
+4. Consider custom templates by filename and config contents. A same-name custom template replaces the built-in template completely.
+5. Ask the user when multiple choices are plausible and materially change memory areas or traceability. With insufficient evidence, use `~/.dotdotgod/config.json` `defaultTemplate`, then `software`.
+6. Report the selected template and a concise reason.
 
 ## Workflow
 
-1. Inspect existing agent instructions, documentation, config, and ignore rules; preserve existing files and unrelated user work.
-2. Run `dotdotgod init <project-root>` when available; otherwise run `sh "${CLAUDE_PLUGIN_ROOT}/skills/project-initializer/scripts/init_project.sh" <project-root>`. Existing files must be skipped, not replaced.
-3. Validate the initialized project with `dotdotgod validate <project-root>` when available.
-4. Report created and skipped files, validation failures, and unresolved instruction conflicts.
+1. Preserve existing files and unrelated user work.
+2. Run `dotdotgod init <project-root> --template <name>` when available; otherwise run `sh "${CLAUDE_PLUGIN_ROOT}/skills/project-initializer/scripts/init_project.sh" <project-root> --template <name>`. Existing files must be skipped, not replaced.
+3. The POSIX fallback supports bundled templates only. If a custom template was selected and the CLI is unavailable, stop and explain that custom templates require the CLI; do not silently substitute another template.
+4. Validate the initialized project with `dotdotgod validate <project-root>` when available.
+5. Report created and skipped files, the selected template, validation failures, and unresolved instruction conflicts.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdotgod/claude-code",
-  "version": "0.2.20",
+  "version": "0.2.22",
   "description": "Claude Code adapter for dotdotgod project memory workflows.",
   "type": "module",
   "license": "Elastic-2.0",

package/skills/project-initializer/SKILL.md

@@ -10,11 +10,27 @@ version: 1.0.0
 
 ## Goal
 
-Create a non-destructive dotdotgod baseline with canonical agent instructions, thin agent entrypoints, documentation indexes, project config, and local-memory ignore rules.
+Create a non-destructive dotdotgod baseline with canonical agent instructions, thin agent entrypoints, documentation indexes, a project config selected from an appropriate initialization template, and local-memory ignore rules.
+
+## Template Selection
+
+1. Inspect existing agent instructions, the root README, docs indexes, major top-level directories, config, and ignore rules.
+2. Discover custom templates as individual JSON files under `~/.dotdotgod/templates/`. Built-in templates are `software`, `research`, `case-and-evidence`, `publication`, `portfolio`, and `policy`.
+3. Choose from project evidence:
+   - `software`: application, library, or infrastructure projects organized around specs, architecture, source, and tests.
+   - `research`: research diaries, dated records, reports, artifacts, and evaluation evidence.
+   - `case-and-evidence`: canonical case records, evidence or legal grounds, and case outputs.
+   - `publication`: briefs, outlines, chapters, claims, manuscripts, and research sources.
+   - `portfolio`: strategy, positions, ledgers, journals, and market research.
+   - `policy`: policy sections, integrated proposals, evidence, and submission outputs.
+4. Consider custom templates by filename and config contents. A same-name custom template replaces the built-in template completely.
+5. Ask the user when multiple choices are plausible and materially change memory areas or traceability. With insufficient evidence, use `~/.dotdotgod/config.json` `defaultTemplate`, then `software`.
+6. Report the selected template and a concise reason.
 
 ## Workflow
 
-1. Inspect existing agent instructions, documentation, config, and ignore rules; preserve existing files and unrelated user work.
-2. Run `dotdotgod init <project-root>` when available; otherwise run `sh "${CLAUDE_PLUGIN_ROOT}/skills/project-initializer/scripts/init_project.sh" <project-root>`. Existing files must be skipped, not replaced.
-3. Validate the initialized project with `dotdotgod validate <project-root>` when available.
-4. Report created and skipped files, validation failures, and unresolved instruction conflicts.
+1. Preserve existing files and unrelated user work.
+2. Run `dotdotgod init <project-root> --template <name>` when available; otherwise run `sh "${CLAUDE_PLUGIN_ROOT}/skills/project-initializer/scripts/init_project.sh" <project-root> --template <name>`. Existing files must be skipped, not replaced.
+3. The POSIX fallback supports bundled templates only. If a custom template was selected and the CLI is unavailable, stop and explain that custom templates require the CLI; do not silently substitute another template.
+4. Validate the initialized project with `dotdotgod validate <project-root>` when available.
+5. Report created and skipped files, the selected template, validation failures, and unresolved instruction conflicts.

package/skills/project-initializer/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "Project Initializer"
   short_description: "Initialize project memory and config."
-  default_prompt: "Initialize shared project memory and the complete default config with dotdotgod init or the bundled fallback while preserving existing files."
+  default_prompt: "Inspect the project, select the most appropriate available dotdotgod config template, and initialize shared project memory without replacing existing files."

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

@@ -2,11 +2,11 @@
 set -eu
 
 SCRIPT_DIR=$(CDPATH= cd -P "$(dirname "$0")" && pwd)
-CONFIG_TEMPLATE="$SCRIPT_DIR/../templates/dotdotgod.config.json"
+TEMPLATES_DIR="$SCRIPT_DIR/../templates"
 
 usage() {
   cat <<'EOF'
-Usage: init_project.sh <project-root> [--project-name NAME] [--dotdot-setting] [--dry-run]
+Usage: init_project.sh <project-root> [--project-name NAME] [--template NAME] [--dotdot-setting] [--dry-run]
 
 Initializes:
   AGENTS.md, CLAUDE.md, CODEX.md
@@ -25,6 +25,7 @@ PROJECT_ROOT=""
 PROJECT_NAME=""
 DRY_RUN=0
 DOTDOT_SETTING=0
+TEMPLATE_NAME="software"
 
 while [ "$#" -gt 0 ]; do
   case "$1" in
@@ -36,6 +37,14 @@ while [ "$#" -gt 0 ]; do
       PROJECT_NAME=$2
       shift 2
       ;;
+    --template)
+      [ "$#" -ge 2 ] || {
+        echo "error: --template requires a value" >&2
+        exit 2
+      }
+      TEMPLATE_NAME=$2
+      shift 2
+      ;;
     --dotdot-setting)
       DOTDOT_SETTING=1
       shift
@@ -80,8 +89,15 @@ if [ -z "$PROJECT_NAME" ]; then
 fi
 
 CONFIG_PATH="$PROJECT_ROOT/dotdotgod.config.json"
+case "$TEMPLATE_NAME" in
+  *[!a-z0-9-]*|'')
+    echo "error: template name must be kebab-case: $TEMPLATE_NAME" >&2
+    exit 2
+    ;;
+esac
+CONFIG_TEMPLATE="$TEMPLATES_DIR/$TEMPLATE_NAME.json"
 if [ ! -e "$CONFIG_PATH" ] && [ ! -f "$CONFIG_TEMPLATE" ]; then
-  echo "error: missing initializer config template: $CONFIG_TEMPLATE" >&2
+  echo "error: bundled template not found: $TEMPLATE_NAME; custom templates require the dotdotgod CLI" >&2
   exit 2
 fi
 
@@ -115,6 +131,20 @@ write_file() {
   print_result "created" "$path"
 }
 
+ensure_directory() {
+  path=$1
+  if [ -e "$path" ]; then
+    print_result "skipped" "$path"
+    return
+  fi
+  if [ "$DRY_RUN" -eq 1 ]; then
+    print_result "would_create" "$path"
+    return
+  fi
+  mkdir -p "$path"
+  print_result "created" "$path"
+}
+
 ensure_gitignore_entry() {
   entry=$1
   path="$PROJECT_ROOT/.gitignore"
@@ -396,6 +426,80 @@ 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/docs/research/README.md" "# Research
+
+Use this area for research notes, sources, and findings."
+    write_file "$PROJECT_ROOT/docs/record/README.md" "# Research Records
+
+Use this area for dated measurements, experiments, and execution records."
+    write_file "$PROJECT_ROOT/docs/report/README.md" "# Reports
+
+Use this area for research diagnoses, analyses, results, and performance reports."
+    ensure_directory "$PROJECT_ROOT/outputs"
+    ;;
+  case-and-evidence)
+    write_file "$PROJECT_ROOT/docs/case/README.md" "# Case Records
+
+Use this area for canonical case facts, questions, and decisions."
+    write_file "$PROJECT_ROOT/docs/evidence/README.md" "# Evidence
+
+Use this area for factual, legal, and other supporting evidence."
+    write_file "$PROJECT_ROOT/docs/outputs/README.md" "# Case Outputs
+
+Use this area for maintained case outputs."
+    ;;
+  publication)
+    write_file "$PROJECT_ROOT/docs/outline/README.md" "# Publication Outline
+
+Use this area for publication structure and outlines."
+    write_file "$PROJECT_ROOT/docs/chapters/README.md" "# Chapter Plans
+
+Use this area for chapter plans and direction."
+    write_file "$PROJECT_ROOT/docs/claims/README.md" "# Claims
+
+Use this area for maintained claims and their support."
+    write_file "$PROJECT_ROOT/docs/research/README.md" "# Research Sources
+
+Use this area for research sources and supporting notes."
+    ensure_directory "$PROJECT_ROOT/book"
+    ;;
+  portfolio)
+    write_file "$PROJECT_ROOT/docs/strategy/README.md" "# Portfolio Strategy
+
+Use this area for portfolio strategy and risk rules."
+    write_file "$PROJECT_ROOT/docs/positions/README.md" "# Position Theses
+
+Use this area for position theses and investment conclusions."
+    write_file "$PROJECT_ROOT/docs/journal/README.md" "# Decision Journal
+
+Use this area for dated investment decisions and reviews."
+    write_file "$PROJECT_ROOT/docs/report/README.md" "# Market Research
+
+Use this area for maintained market research and analysis."
+    ensure_directory "$PROJECT_ROOT/data"
+    ;;
+  policy)
+    write_file "$PROJECT_ROOT/docs/policy/README.md" "# Policy Documents
+
+Use this area for integrated policy proposals and outputs."
+    write_file "$PROJECT_ROOT/docs/sections/README.md" "# Policy Sections
+
+Use this area for source policy sections."
+    write_file "$PROJECT_ROOT/docs/evidence/README.md" "# Policy Evidence
+
+Use this area for evidence supporting policy proposals."
+    write_file "$PROJECT_ROOT/docs/outputs/README.md" "# Submission Outputs
+
+Use this area for maintained policy submission outputs."
+    ;;
+esac
+fi
+
 if [ -e "$CONFIG_PATH" ]; then
   print_result "skipped" "$CONFIG_PATH"
 else

package/skills/project-initializer/templates/case-and-evidence.json

@@ -0,0 +1,221 @@
+{
+  "memory": {
+    "areas": [
+      {
+        "id": "rules",
+        "label": "Agent Rules",
+        "paths": [
+          "AGENTS.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-working-rules",
+        "priority": 100,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "agent-entrypoint",
+        "label": "Agent Entrypoints",
+        "paths": [
+          "CLAUDE.md",
+          "CODEX.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-specific-entrypoint",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "project-overview",
+        "label": "Project Overview",
+        "paths": [
+          "README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-map",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "docs-index",
+        "label": "Docs Index",
+        "paths": [
+          "docs/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "documentation-routing-map",
+        "priority": 90,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "case",
+        "label": "Case Record",
+        "paths": [
+          "docs/case/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "case-truth-and-open-questions",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "evidence",
+        "label": "Evidence and Grounds",
+        "paths": [
+          "docs/evidence/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "factual-and-legal-support",
+        "priority": 80,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "outputs",
+        "label": "Case Outputs",
+        "paths": [
+          "docs/outputs/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "case-outputs",
+        "priority": 75,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "active-plan",
+        "label": "Active Plans",
+        "paths": [
+          "docs/plan/**"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "fresh",
+        "role": "active-task-intent",
+        "priority": 95,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-map",
+        "label": "Archive Map",
+        "paths": [
+          "docs/archive/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-map",
+        "priority": 65,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-body",
+        "label": "Archive Body",
+        "paths": [
+          "docs/archive/**"
+        ],
+        "excludePaths": [
+          "docs/archive/README.md"
+        ],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-body",
+        "priority": 20,
+        "includeBodiesByDefault": false
+      },
+      {
+        "id": "docs",
+        "label": "Project Documentation",
+        "paths": [
+          "docs/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-documentation",
+        "priority": 60,
+        "includeBodiesByDefault": true
+      }
+    ]
+  },
+  "traceability": {
+    "required": [
+      "docs/case/**",
+      "docs/outputs/**"
+    ],
+    "exclude": [
+      "**/README.md"
+    ],
+    "keys": [
+      {
+        "key": "basedOn",
+        "label": "Based on",
+        "description": "Canonical case records, evidence, or grounds supporting the document.",
+        "target": "path",
+        "relation": "based_on",
+        "weight": 4
+      },
+      {
+        "key": "relatedDocs",
+        "label": "Related docs",
+        "description": "Documents needed to interpret the record.",
+        "target": "path",
+        "relation": "related_doc",
+        "weight": 2
+      }
+    ]
+  },
+  "validation": {
+    "markdown": {
+      "maxLines": 200,
+      "maxChars": 10000,
+      "exclude": [],
+      "filename": {
+        "warnNumberedSeries": true,
+        "allow": []
+      }
+    }
+  },
+  "impactRanking": {
+    "semantic": {
+      "enabled": true,
+      "threshold": 0.5,
+      "topKPerFile": 5
+    }
+  },
+  "referenceExpansion": {
+    "fuzzy": {
+      "lowSignal": {
+        "add": [],
+        "remove": []
+      }
+    }
+  },
+  "load": {
+    "pinnedPaths": [],
+    "pinnedBodies": [],
+    "documentationSummary": {
+      "exclude": [
+        "docs/plan",
+        "docs/archive"
+      ]
+    }
+  },
+  "planMode": {
+    "writablePaths": [
+      "docs/plan/**",
+      "docs/archive/**"
+    ]
+  }
+}

package/skills/project-initializer/templates/dotdotgod.config.json

@@ -182,11 +182,11 @@
         "weight": 3
       },
       {
-        "key": "verificationCommands",
-        "label": "Verification commands",
-        "description": "Project-local verification commands.",
-        "target": "command",
-        "relation": "verification_command",
+        "key": "designDecisions",
+        "label": "Design decisions",
+        "description": "Maintained architecture or design decision documents that constrain the behavior.",
+        "target": "path",
+        "relation": "design_decision",
         "weight": 3
       }
     ]