init

Signum Init: Project Context Bootstrapping

You are the Signum Init orchestrator. Bootstrap project context for a new or existing project.

The user's arguments: $ARGUMENTS

Pipeline

SCAN → SYNTHESIZE → PRESENT → VERIFY

---

Step 0: Parse Arguments

Parse $ARGUMENTS:

• If --force is present, set FORCE_MODE=true (overwrite existing files without prompting)
• If --harness is present, set HARNESS_MODE=true (scaffold repo-level harness docs)
• If --project-root <path> is present, use that path. Otherwise use current directory.
• Any other argument: print usage and stop.

Usage:

/signum:init [--force] [--harness] [--project-root <path>]

For Claude Code plugin usage, /signum:init is the canonical form. --harness requires Signum >= v4.18.0.

---

Step 1: SCAN (deterministic)

1a. Resolve Signum helper paths

Run:

resolve_signum_helper() {
  local helper="$1"
  if [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -f "${CLAUDE_PLUGIN_ROOT}/lib/${helper}" ]; then
    printf '%s\n' "${CLAUDE_PLUGIN_ROOT}/lib/${helper}"
    return 0
  fi
  if [ -f "lib/${helper}" ]; then
    printf '%s\n' "lib/${helper}"
    return 0
  fi
  echo "ERROR: Signum helper not found: ${helper}" >&2
  return 1
}

INIT_SCANNER_PATH=$(resolve_signum_helper "init-scanner.sh") || exit 1
INIT_HARNESS_SCAFFOLD_PATH=$(resolve_signum_helper "init-harness-scaffold.sh") || exit 1
printf 'INIT_SCANNER_PATH=%s\n' "$INIT_SCANNER_PATH"
printf 'INIT_HARNESS_SCAFFOLD_PATH=%s\n' "$INIT_HARNESS_SCAFFOLD_PATH"

Save the resolved helper paths as INIT_SCANNER_PATH and INIT_HARNESS_SCAFFOLD_PATH.

1b. Check for existing files

Run:

ls project.intent.md 2>/dev/null && echo "INTENT_EXISTS=true" || echo "INTENT_EXISTS=false"
ls project.glossary.json 2>/dev/null && echo "GLOSSARY_EXISTS=true" || echo "GLOSSARY_EXISTS=false"

If HARNESS_MODE=true, also run:

bash "$INIT_HARNESS_SCAFFOLD_PATH" --project-root "${PROJECT_ROOT:-.}" 2>/dev/null

Save this JSON as HARNESS_SCAFFOLD. It contains the additional harness-doc drafts plus .missingCount / .existingCount.