clawstrap 1.2.0

package/dist/index.cjs

@@ -0,0 +1,1222 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_commander = require("commander");
+
+// src/init.ts
+var import_node_fs2 = __toESM(require("fs"), 1);
+var import_node_path3 = __toESM(require("path"), 1);
+var import_prompts2 = require("@inquirer/prompts");
+
+// src/schema.ts
+var import_zod = require("zod");
+var AI_SYSTEMS = ["claude-code"];
+var WORKLOAD_TYPES = [
+  "research",
+  "content",
+  "data-processing",
+  "custom"
+];
+var PARALLEL_AGENTS = ["single", "small-team", "production"];
+var QUALITY_LEVELS = ["solo", "team", "production"];
+var LastExportSchema = import_zod.z.object({
+  format: import_zod.z.string(),
+  exportedAt: import_zod.z.string(),
+  outputDir: import_zod.z.string()
+}).optional();
+var ClawstrapConfigSchema = import_zod.z.object({
+  version: import_zod.z.string().default("1.0.0"),
+  createdAt: import_zod.z.string(),
+  workspaceName: import_zod.z.string().min(1),
+  targetDirectory: import_zod.z.string().min(1).default("."),
+  aiSystem: import_zod.z.enum(AI_SYSTEMS).default("claude-code"),
+  workloadType: import_zod.z.enum(WORKLOAD_TYPES),
+  parallelAgents: import_zod.z.enum(PARALLEL_AGENTS),
+  qualityLevel: import_zod.z.enum(QUALITY_LEVELS),
+  sessionHandoff: import_zod.z.boolean(),
+  lastExport: LastExportSchema
+});
+
+// src/derive-vars.ts
+var SYSTEM_DIR = {
+  "claude-code": ".claude"
+};
+var GOVERNANCE_FILE = {
+  "claude-code": "CLAUDE.md"
+};
+var WORKLOAD_LABELS = {
+  research: "Research & Analysis",
+  content: "Content & Writing",
+  "data-processing": "Data Processing",
+  custom: "General Purpose"
+};
+var FLUSH_CADENCES = {
+  research: "every 3 findings",
+  content: "every draft iteration",
+  "data-processing": "every 5 batch items",
+  custom: "every 5 operations"
+};
+function deriveTemplateVars(config) {
+  return {
+    // Metadata
+    workspaceName: config.workspaceName,
+    generatedDate: config.createdAt.split("T")[0],
+    clawstrapVersion: config.version,
+    // AI system (v1: always claude-code, v2: user-selectable)
+    systemDir: SYSTEM_DIR[config.aiSystem],
+    governanceFile: GOVERNANCE_FILE[config.aiSystem],
+    // Direct values
+    workloadType: config.workloadType,
+    workloadLabel: WORKLOAD_LABELS[config.workloadType],
+    flushCadence: FLUSH_CADENCES[config.workloadType],
+    // Workload booleans
+    isResearch: config.workloadType === "research",
+    isContent: config.workloadType === "content",
+    isDataProcessing: config.workloadType === "data-processing",
+    isCustom: config.workloadType === "custom",
+    // Agent booleans
+    hasSubagents: config.parallelAgents !== "single",
+    isProductionAgents: config.parallelAgents === "production",
+    // Quality booleans
+    hasQualityGates: config.qualityLevel !== "solo",
+    isProductionQuality: config.qualityLevel === "production",
+    // Session handoff
+    sessionHandoff: config.sessionHandoff
+  };
+}
+
+// src/writer.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = __toESM(require("path"), 1);
+
+// src/template-engine.ts
+var IF_BLOCK = /\{%#if\s+(\w+)%\}([\s\S]*?)\{%\/if%\}/g;
+var UNLESS_BLOCK = /\{%#unless\s+(\w+)%\}([\s\S]*?)\{%\/unless%\}/g;
+var NESTED_IF = /\{%#if\s+\w+%\}(?:(?!\{%\/if%\})[\s\S])*?\{%#if\s+/;
+var VARIABLE = /\{%(\w+)%\}/g;
+var TRIPLE_BLANK = /\n{3,}/g;
+function render(template, vars) {
+  let result = template;
+  if (NESTED_IF.test(result)) {
+    throw new Error(
+      "Nested {%#if%} blocks are not supported. Use {%#unless%} inside {%#if%} instead."
+    );
+  }
+  result = result.replace(IF_BLOCK, (_, key, content) => {
+    return vars[key] ? content : "";
+  });
+  result = result.replace(UNLESS_BLOCK, (_, key, content) => {
+    return vars[key] ? "" : content;
+  });
+  result = result.replace(VARIABLE, (match, key) => {
+    const value = vars[key];
+    if (value === void 0) {
+      throw new Error(`Template variable not found: ${key}`);
+    }
+    return String(value);
+  });
+  result = result.replace(TRIPLE_BLANK, "\n\n");
+  return result;
+}
+
+// src/manifest.ts
+var OUTPUT_MANIFEST = [
+  // Always generated
+  {
+    templateKey: "governanceFile",
+    outputPath: "{%governanceFile%}"
+  },
+  {
+    templateKey: "gettingStarted",
+    outputPath: "GETTING_STARTED.md"
+  },
+  {
+    templateKey: "gitignore",
+    outputPath: ".gitignore"
+  },
+  {
+    templateKey: "contextDiscipline",
+    outputPath: "{%systemDir%}/rules/context-discipline.md"
+  },
+  {
+    templateKey: "approvalFirst",
+    outputPath: "{%systemDir%}/rules/approval-first.md"
+  },
+  {
+    templateKey: "skillRegistry",
+    outputPath: "{%systemDir%}/skills/SKILL_REGISTRY.md"
+  },
+  {
+    templateKey: "gotchaLog",
+    outputPath: "{%systemDir%}/gotcha-log.md"
+  },
+  {
+    templateKey: "futureConsiderations",
+    outputPath: "{%systemDir%}/future-considerations.md"
+  },
+  {
+    templateKey: "projectProcess",
+    outputPath: "projects/_template/process.md"
+  },
+  {
+    templateKey: "projectReadme",
+    outputPath: "projects/_template/README.md"
+  },
+  // Conditional
+  {
+    templateKey: "qualityGates",
+    outputPath: "{%systemDir%}/rules/quality-gates.md",
+    condition: "hasQualityGates"
+  },
+  {
+    templateKey: "primaryAgent",
+    outputPath: "{%systemDir%}/agents/primary-agent.md",
+    condition: "hasSubagents"
+  },
+  {
+    templateKey: "agentTemplate",
+    outputPath: "{%systemDir%}/agents/_template.md",
+    condition: "hasSubagents"
+  },
+  {
+    templateKey: "subagentBootstrap",
+    outputPath: "{%systemDir%}/subagent-bootstrap.md",
+    condition: "hasSubagents"
+  },
+  {
+    templateKey: "memoryIndex",
+    outputPath: "{%systemDir%}/memory/MEMORY.md",
+    condition: "sessionHandoff"
+  }
+];
+var EMPTY_DIRS = ["tmp", "research", "context", "artifacts"];
+
+// src/templates/governance-file.md.tmpl
+var governance_file_md_default = "# {%governanceFile%} \u2014 Master Governance Rules\n> **Workspace**: {%workspaceName%} | **Generated**: {%generatedDate%} | **Status**: active\n> Loaded every session. Keep lean. Move details to skills or rules files.\n\n---\n\n## Workflow Rules\n\n**Approval-first, always.**\nPlan work and get explicit approval before executing. No speculative actions.\nIf scope changes mid-task, pause and re-confirm.\n\n**If it's not on disk, it didn't happen.**\nSave findings immediately, not at session end. Flush {%flushCadence%}.\nWrite corrections to durable locations before applying them.\n{%#if hasSubagents%}Subagents return file paths, not raw data.{%/if%}\n\n**Quality > context cleanliness > speed > token cost.**\nQuality failures require full rework (100% waste). Never trade quality for tokens.\n{%#if isResearch%}\n**Research-specific:**\n- Cite sources for every claim \u2014 no unsourced assertions\n- Write findings to file immediately, not at session end\n- Separate facts from interpretation in all output\n{%/if%}\n{%#if isContent%}\n**Content-specific:**\n- Every piece of content follows the draft \u2192 review \u2192 approve cycle\n- Never publish or finalize without explicit approval\n- Track all revision feedback in a dedicated file\n{%/if%}\n{%#if isDataProcessing%}\n**Data processing-specific:**\n- Define batch size before starting \u2014 never process unbounded sets\n- Validate schema on every write\n- Log every transformation step for auditability\n{%/if%}\n\n---\n\n## Persistence Hierarchy\n\nFrom most ephemeral to most durable:\n\n| Layer | Location | Loaded When |\n|-------|----------|-------------|\n| Conversation | (in-context) | Always \u2014 volatile |\n| Temp files | `tmp/` | Per-task, gitignored |\n{%#if sessionHandoff%}| Memory | `{%systemDir%}/memory/` | On demand |\n{%/if%}| Skills | `{%systemDir%}/skills/*/SKILL.md` | When triggered |\n| Rules | `{%systemDir%}/rules/*.md` | Every session |\n| **{%governanceFile%}** | `./{%governanceFile%}` | **Every session** |\n\n---\n\n## Context Discipline\n\n- Flush working state to file {%flushCadence%}\n{%#if hasSubagents%}- Subagents write output to `tmp/{task}/{name}.json`; return one-line receipt\n- Main session reads subagent files ONLY if needed for the next step\n- Never hold raw batch results in conversation \u2014 write to disk first\n{%/if%}- Before batch work: write execution plan to file (survives context loss)\n\n---\n{%#if sessionHandoff%}\n## Session Handoff Checklist\n\nRun this at every session end (mandatory, not optional):\n\n1. Save all work to SSOT files\n2. Sync derived files (rebuild from SSOTs)\n3. SSOT integrity check (no duplicates, no stale data)\n4. Update progress tracker\n5. Write next-session plan (with pre-execution hooks listed)\n6. Launch QC on work done this session\n\n---\n{%/if%}\n\n## Security Rules\n\n- Never read `.env` files or echo credentials\n- Never install third-party MCP servers/plugins without explicit approval\n- Never write outside this workspace root \u2014 use project-local `tmp/`, not system `/tmp/`\n- Approved tools only \u2014 ask before using new tools/APIs\n\n---\n\n## Quality Rules\n{%#if isProductionQuality%}\n- QC is a structural gate, not an optional post-step\n- Run spot-checks after every 5 items in batch work (Ralph Loop)\n- Combined agents (extract + classify) beat split agents on quality\n- Disagreements between agents reveal ambiguity \u2014 escalate, don't suppress\n{%/if%}\n{%#if hasQualityGates%}\n{%#unless isProductionQuality%}- QC is a structural gate, not an optional post-step\n- Run QC checkpoints at regular intervals during batch work\n- All results must be reviewed before being marked complete\n{%/unless%}\n{%/if%}\n{%#unless hasQualityGates%}- Run a quick check before finishing any task\n- Review outputs before marking work complete\n{%/unless%}\n\n---\n\n## Pointers to Other Layers\n\n- Rules: `{%systemDir%}/rules/` \u2014 domain-specific rules loaded every session\n- Skills: `{%systemDir%}/skills/SKILL_REGISTRY.md` \u2014 index of all skills\n{%#if hasSubagents%}- Agents: `{%systemDir%}/agents/` \u2014 subagent definitions with governance baked in\n{%/if%}- Gotchas: `{%systemDir%}/gotcha-log.md` \u2014 incident log (why rules exist)\n- Future: `{%systemDir%}/future-considerations.md` \u2014 deferred ideas\n";
+
+// src/templates/getting-started.md.tmpl
+var getting_started_md_default = "# Getting Started \u2014 {%workspaceName%}\n> Generated by Clawstrap v{%clawstrapVersion%} on {%generatedDate%}\n\nWelcome to your AI agent workspace. This workspace is configured for\n**{%workloadLabel%}** workflows.\n\n---\n\n## Quick Start\n\n1. **Read `{%governanceFile%}`** \u2014 this is your master governance file. It loads\n   automatically every session and defines the rules your AI assistant follows.\n\n2. **Check `{%systemDir%}/rules/`** \u2014 these rule files also load every session.\n   They contain detailed procedures for context discipline, approval workflows,\n   and quality gates.\n\n3. **Start working** \u2014 open a Claude Code session in this directory. The\n   governance files will load automatically.\n\n---\n\n## What's in This Workspace\n\n```\n{%governanceFile%}                    \u2190 Master governance (always loaded)\nGETTING_STARTED.md               \u2190 You are here\n.clawstrap.json                  \u2190 Your workspace configuration\n\n{%systemDir%}/\n  rules/                         \u2190 Auto-loaded rules (every session)\n  skills/                        \u2190 Skill definitions (loaded when triggered)\n{%#if hasSubagents%}  agents/                        \u2190 Agent definitions\n{%/if%}  gotcha-log.md                  \u2190 Incident log\n  future-considerations.md       \u2190 Deferred ideas\n{%#if sessionHandoff%}  memory/                        \u2190 Persistent memory across sessions\n{%/if%}\nprojects/\n  _template/                     \u2190 Template for new projects\n\ntmp/                             \u2190 Temporary files (gitignored)\nresearch/                        \u2190 Reference material\ncontext/                         \u2190 Session checkpoints\nartifacts/                       \u2190 Durable output\n```\n\n---\n\n## Key Principles\n\nThis workspace enforces five principles:\n\n1. **If it's not on disk, it didn't happen.** Context windows compress. Sessions\n   end. The only thing that persists is files. Flush work {%flushCadence%}.\n\n2. **Approval-first, always.** Plan work, get approval, then execute. No\n   speculative actions.\n\n3. **Quality is a structural gate.** Quality checks happen during work, not after.\n{%#if hasQualityGates%}   See `{%systemDir%}/rules/quality-gates.md` for the full procedure.{%/if%}\n\n4. **Disagreements reveal ambiguity.** When agents disagree, the rules are\n   ambiguous. Escalate and clarify \u2014 don't suppress.\n\n5. **One decision at a time.** Binary decisions made sequentially compound into\n   reliable outcomes.\n{%#if hasSubagents%}\n\n---\n\n## Working with Multiple Agents\n\nYour workspace is configured for multi-agent workflows. Key rules:\n\n- **Subagents write to `tmp/`** \u2014 they return file paths and one-line summaries,\n  never raw data in conversation.\n- **The main session is an orchestrator** \u2014 it tracks progress, launches agents,\n  and checks output files. It does not hold subagent data in memory.\n- **Agent definitions live in `{%systemDir%}/agents/`** \u2014 each file becomes the\n  system prompt for a subagent. Governance is baked into the definition.\n{%/if%}\n{%#if sessionHandoff%}\n\n---\n\n## Session Handoff\n\nThis workspace uses session handoff checklists. At the end of every session:\n\n1. Save all work to SSOT files\n2. Sync derived files\n3. Check SSOT integrity\n4. Update progress tracker\n5. Write next-session plan\n6. Run QC on session work\n\nThis ensures no context is lost between sessions.\n{%/if%}\n{%#if isResearch%}\n\n---\n\n## Research Tips\n\n- Write findings to disk immediately \u2014 don't accumulate in conversation\n- Cite sources for every claim\n- Separate facts from interpretation\n- Use `research/` for reference material, `artifacts/` for synthesis output\n{%/if%}\n{%#if isContent%}\n\n---\n\n## Content Workflow Tips\n\n- Every piece follows: draft \u2192 review \u2192 approve\n- Track revision feedback in dedicated files\n- Never finalize without explicit approval\n- Use `artifacts/` for final deliverables\n{%/if%}\n{%#if isDataProcessing%}\n\n---\n\n## Data Processing Tips\n\n- Define batch size before starting any processing run\n- Validate schema on every write\n- Checkpoint every 5 batch items\n- Log all transformations for auditability\n{%/if%}\n\n---\n\n*This workspace was generated by [Clawstrap](https://github.com/clawstrap/clawstrap).\nEdit any file to fit your needs \u2014 there's no lock-in.*\n";
+
+// src/templates/gitignore.tmpl
+var gitignore_default = "# Dependencies\nnode_modules/\n\n# Temporary files (subagent output, session data)\ntmp/\n\n# Secrets\n.env\n.env.*\ncredentials.json\n*.pem\n*.key\n\n# OS\n.DS_Store\nThumbs.db\n\n# Editor\n*.swp\n*.swo\n*~\n";
+
+// src/templates/rules/context-discipline.md.tmpl
+var context_discipline_md_default = "# Rule: Context Discipline\n> **Scope**: All sessions | **Generated**: {%generatedDate%}\n\n## Flush Cadence\n\nFlush working state to file {%flushCadence%}:\n- Write current state to a context checkpoint file\n- Include: what's done, what's next, accumulated results\n- Path: `context/checkpoint-{date}-{task}.md`\n{%#if hasSubagents%}\n\n## Subagent Output Rules\n\nSubagents MUST:\n1. Write all output to `tmp/{task}/{name}.json` (or `.md`)\n2. Return a one-line receipt: `\"Done. N items. File: {path}. Summary: {1 line}.\"`\n3. NOT dump raw results into the conversation\n\nMain session MUST:\n- Only read the subagent file if needed for the NEXT step\n- Never hold subagent output in conversation memory\n\n## Thin Orchestrator Principle\n\nDuring batch work, the main session is an orchestrator only:\n\n**DO**:\n- Track queue / done / next\n- Launch agents with correct prompts\n- Check output files for completeness\n- Update SSOT data files\n- Run QC gates\n\n**DO NOT**:\n- Read raw extraction data into main context\n- Classify results (agents do that)\n- Hold full subagent output in conversation\n{%/if%}\n\n## Before Batch Work\n\nAlways write an execution plan to `tmp/{task}/plan.md` before starting.\nThis file must survive context loss and be readable by any future session.\n\n## On User Correction\n\n1. FIRST write the correction to its durable home (memory/rule/skill file)\n2. THEN apply the correction to current work\n\nThis ensures the learning persists even if the session ends unexpectedly.\n";
+
+// src/templates/rules/approval-first.md.tmpl
+var approval_first_md_default = `# Rule: Approval-First Workflow
+> **Scope**: All sessions | **Generated**: {%generatedDate%}
+
+## Core Principle
+
+Plan work and surface it before executing. Always.
+
+## Rules
+
+1. **Plan before executing** \u2014 present your approach and get explicit approval
+   before making changes. No speculative actions.
+
+2. **No shortcuts** \u2014 never skip a step because it seems tedious or obvious.
+   Every step exists for a reason.
+
+3. **Scope changes require re-approval** \u2014 if the task changes mid-execution,
+   pause and re-confirm the new scope before continuing.
+
+4. **State verification** \u2014 before modifying any file, read its current state.
+   Don't assume you know what's in a file from earlier in the conversation.
+
+5. **Destructive actions require explicit confirmation** \u2014 deleting files,
+   overwriting data, or resetting state always needs a direct "yes" from the user.
+`;
+
+// src/templates/rules/quality-gates.md.tmpl
+var quality_gates_md_default = `# Rule: Quality Gates
+> **Scope**: All sessions | **Generated**: {%generatedDate%}
+
+## Core Principle
+
+Quality is a structural gate in the execution loop, not a phase run at the end.
+
+## Gates
+
+### Write-Time Validation
+- Validate schema/structure on every file write
+- Malformed output is caught immediately, not discovered later
+
+### Checkpoint Reviews (Ralph Loop)
+- Every 5 outputs: stop and review the most complex item in the batch
+- If quality grade is below B: fix the issue and rerun before proceeding
+- This is mandatory \u2014 not optional, not skippable
+{%#if isProductionQuality%}
+
+### Multi-Agent Agreement
+- When multiple agents classify the same item, compare results
+- Disagreements are escalated \u2014 they reveal ambiguity in the rules, not agent failure
+- Resolution: clarify the rule, don't add more rules
+
+### Combined Agent Pattern
+- Combined agents (extract + classify in one pass) beat split agents on quality
+- Only split into separate agents when the task genuinely requires different tools
+{%/if%}
+
+### Human Review
+- Human review is the final gate \u2014 all results surface to the user
+- No output is marked "complete" without human confirmation
+- Low-confidence results must be flagged, never silently passed through
+`;
+
+// src/templates/skills/SKILL_REGISTRY.md.tmpl
+var SKILL_REGISTRY_md_default = "# Skill Registry \u2014 {%workspaceName%}\n> Index of all skills in this workspace. Update as skills are added.\n\n## What Are Skills?\n\nSkills are specialized procedures stored in `{%systemDir%}/skills/*/SKILL.md`.\nThey provide domain-specific instructions that load on demand \u2014 only when\nthe relevant task is triggered.\n\n## Registered Skills\n\n| Skill | Path | Trigger |\n|-------|------|---------|\n| *(none yet)* | \u2014 | \u2014 |\n\n## Adding a Skill\n\n1. Create a directory: `{%systemDir%}/skills/{skill-name}/`\n2. Add a `SKILL.md` file with frontmatter and procedures\n3. Register it in this file\n4. Reference the trigger phrase in `{%governanceFile%}` if needed\n";
+
+// src/templates/agents/primary-agent.md.tmpl
+var primary_agent_md_default = "# Agent: Primary Orchestrator\n> **Workspace**: {%workspaceName%} | **Generated**: {%generatedDate%}\n\n## Identity\n\nYou are the primary orchestrator agent for the {%workspaceName%} workspace,\nconfigured for {%workloadLabel%} workflows.\n\n## Role\n\n- Coordinate work across subagents\n- Track progress and maintain execution plans\n- Ensure all output meets quality standards\n- Escalate ambiguity \u2014 never suppress disagreements\n\n## Rules\n\n1. **You are an orchestrator, not a worker.** Launch subagents for extraction,\n   classification, and generation tasks. Do not hold their raw output.\n\n2. **Subagent output goes to files.** Every subagent writes to\n   `tmp/{task}/{name}.json` and returns a one-line receipt.\n\n3. **Check before proceeding.** After every subagent completes, verify the\n   output file exists and has the expected structure.\n\n4. **QC is your responsibility.** Run the Ralph Loop every 5 items:\n   pick the most complex item, review it, fix issues before continuing.\n\n## Output Format\n\nWhen reporting to the user:\n```\nStatus: {done}/{total} items complete\nQC: last check at item #{n}, grade: {A/B/C}\nNext: {what happens next}\nIssues: {any blockers or flags}\n```\n\n## Approved Tools\n\n- Read / Write / Edit files\n- Launch subagents (using agent definitions in `{%systemDir%}/agents/`)\n- Web search and fetch (with domain restrictions)\n\n**Not approved without explicit permission:**\n- Installing packages or plugins\n- Modifying files outside this workspace\n- Running destructive commands\n";
+
+// src/templates/agents/agent-template.md.tmpl
+var agent_template_md_default = '# Agent: [Name]\n> **Purpose**: [one-line description]\n> **Workspace**: {%workspaceName%}\n\n## Identity\n\nYou are a subagent in the {%workspaceName%} workspace. You have a focused task\nand strict output requirements.\n\n## Task\n\n*(Describe the specific task this agent performs)*\n\n## Input\n\n*(What this agent receives \u2014 file paths, structured data, etc.)*\n\n## Output\n\nWrite results to: `tmp/{task}/{name}.json`\n\nReturn to orchestrator:\n```\nDone. {N} items. File: {path}. Summary: {1-line summary}.\n```\n\n## Output Schema\n\n```json\n{\n  "items": [\n    {\n      "id": "",\n      "result": "",\n      "confidence": "high | medium | low",\n      "source": ""\n    }\n  ],\n  "metadata": {\n    "total": 0,\n    "processed": 0,\n    "errors": 0\n  }\n}\n```\n\n## Rules\n\n1. Write ALL output to the specified file \u2014 never return raw data in conversation\n2. Include confidence scores for every item\n3. Flag low-confidence items explicitly\n4. If you encounter ambiguity, stop and report it \u2014 do not guess\n\n## Approved Tools\n\n- Read files (input only)\n- Write to `tmp/` (output only)\n- *(Add task-specific tools here)*\n';
+
+// src/templates/subagent-bootstrap.md.tmpl
+var subagent_bootstrap_md_default = '# Subagent Bootstrap \u2014 Lightweight Governance\n> For ad-hoc subagents that don\'t have a dedicated agent definition file.\n\nWhen spawning a quick subagent without a full definition, include these rules\nin the prompt:\n\n```\nYou are a subagent in the {%workspaceName%} workspace.\n\nRules:\n1. Write ALL output to tmp/{task}/{name}.json\n2. Return a one-line receipt: "Done. N items. File: {path}. Summary: {1 line}."\n3. Do NOT dump raw results into the conversation\n4. Include confidence scores where applicable\n5. Flag ambiguity \u2014 do not guess\n6. Stay within your assigned task scope\n```\n\nThis ensures governance even for agents created on the fly.\n';
+
+// src/templates/gotcha-log.md.tmpl
+var gotcha_log_md_default = "# Gotcha Log \u2014 {%workspaceName%}\n> Incident log tracking why rules exist. Every entry = a real failure that happened.\n\n## Format\n\n```\n### G001 \u2014 [Short title]\n**Date**: YYYY-MM-DD\n**What happened**: [1-2 sentences]\n**Root cause**: [Why it happened]\n**Fix**: [What rule/process was added]\n**Rule ref**: [Link to the rule that prevents recurrence]\n```\n\n## Entries\n\n*(None yet \u2014 add entries as issues arise)*\n";
+
+// src/templates/future-considerations.md.tmpl
+var future_considerations_md_default = "# Future Considerations \u2014 {%workspaceName%}\n> Ideas and improvements deferred from current work. Not a backlog \u2014 a parking lot.\n\n## Format\n\n```\n### F001 \u2014 [Short title]\n**Added**: YYYY-MM-DD\n**Context**: [Why this came up]\n**Idea**: [What could be done]\n**Priority**: low | medium | high\n```\n\n## Entries\n\n*(None yet \u2014 add entries as ideas arise)*\n";
+
+// src/templates/memory/MEMORY.md.tmpl
+var MEMORY_md_default = "# Memory Index \u2014 {%workspaceName%}\n> Persistent memory across sessions. Each entry links to a memory file.\n> Keep this index concise \u2014 one line per entry, under 150 characters.\n\n## Entries\n\n*(None yet \u2014 memories are added as sessions progress)*\n";
+
+// src/templates/projects/project-readme.md.tmpl
+var project_readme_md_default = '# Project: [Name]\n> **Status**: active | paused | complete | archived\n> **Started**: YYYY-MM-DD | **Last session**: YYYY-MM-DD\n\n---\n\n## What This Project Is\n\n*(2-3 sentences. What\'s the goal? What does "done" look like?)*\n\n---\n\n## Key Files\n\n| File | Role |\n|------|------|\n| `process.md` | Workflow, hooks, session checklist |\n\n---\n\n## SSOT Map\n\n*(Every piece of data has exactly one authoritative location. List them here.)*\n\n| Data | SSOT File | Derived Files |\n|------|-----------|---------------|\n| *(none yet)* | \u2014 | \u2014 |\n\n---\n\n## Current Status\n\n**Last done**: \u2014\n**Next**: \u2014\n';
+
+// src/templates/projects/project-process.md.tmpl
+var project_process_md_default = '# Process: [Project Name]\n> Workflow, hooks, and session checklist for this project.\n> Update this file as the workflow evolves.\n\n---\n{%#if sessionHandoff%}\n## Session Start Checklist (Pre-Hooks)\n\nRun these at the start of every session on this project:\n\n1. [ ] Read `README.md` \u2014 confirm current status and next step\n2. [ ] Read `{%governanceFile%}` (auto-loaded, but confirm it\'s current)\n3. [ ] Check `tmp/{task}/plan.md` if a batch is in progress\n4. [ ] Confirm SSOT files are in expected state (no stale data)\n\n---\n\n## Session End Checklist (Post-Hooks)\n\nRun these at the end of every session (mandatory \u2014 not optional):\n\n1. [ ] Save all work to SSOT files\n2. [ ] Sync derived files (regenerate from SSOTs)\n3. [ ] SSOT integrity check (no duplicates, no stale data)\n4. [ ] Update `README.md` \u2192 "Last done" and "Next" fields\n5. [ ] Write next-session plan to `tmp/{task}/plan.md`\n6. [ ] Run QC on work done this session\n\n---\n{%/if%}\n\n## Execution Workflow\n\n*(Describe the main execution loop for this project\'s primary task)*\n{%#if isResearch%}\n```\n1. Define research question \u2192 get approval\n2. Gather sources \u2192 write findings to file immediately\n3. Synthesize \u2192 cite all sources\n4. QC gate: {%flushCadence%}\n5. Output: artifacts/{topic}/synthesis.md\n```\n{%/if%}\n{%#if isContent%}\n```\n1. Brief \u2192 get approval on scope and outline\n2. Draft \u2192 write to artifacts/\n3. Review \u2192 collect feedback in dedicated file\n4. Revise \u2192 approval required before finalizing\n5. QC gate: {%flushCadence%}\n```\n{%/if%}\n{%#if isDataProcessing%}\n```\n1. Plan \u2192 get approval \u2192 define batch size\n2. Process batch \u2192 validate schema on every write\n3. QC gate: {%flushCadence%} (Ralph Loop)\n4. Output: tmp/{task}/{name}.json\n5. Human review \u2192 finalize\n```\n{%/if%}\n{%#if isCustom%}\n```\n1. Plan \u2192 get approval \u2192 execute\n2. Batch size: [N items per batch]\n3. QC gate: {%flushCadence%}\n4. Output: tmp/{task}/{name}.json\n```\n{%/if%}\n\n---\n{%#if hasQualityGates%}\n## Active Batch Tracking\n\n| Batch | Status | QC Grade | Notes |\n|-------|--------|----------|-------|\n| *(none yet)* | \u2014 | \u2014 | \u2014 |\n\n---\n{%/if%}\n\n## Known Gotchas (Project-Specific)\n\n*(1-2 line summaries of project-specific failure modes)*\n\n*(None yet \u2014 add entries as issues arise)*\n';
+
+// src/templates/agents/new-agent.md.tmpl
+var new_agent_md_default = "# Agent: {%agentName%}\n> **Purpose**: {%agentDescription%}\n> **Workspace**: {%workspaceName%}\n\n## Identity\n\nYou are {%agentName%}, a {%agentRole%} agent in the {%workspaceName%} workspace.\n\n## Task\n\n*(Define this agent's specific task)*\n\n## Input\n\n*(What this agent receives \u2014 file paths, structured data, etc.)*\n\n## Output\n\nWrite results to: `tmp/{task}/{%agentName%}.json`\n\nReturn to orchestrator:\n```\nDone. {N} items. File: {path}. Summary: {1-line summary}.\n```\n\n## Rules\n\n1. Write ALL output to the specified file \u2014 never return raw data in conversation\n2. Include confidence scores for every item\n3. Flag low-confidence items explicitly\n4. If you encounter ambiguity, stop and report it \u2014 do not guess\n5. Stay within your assigned task scope\n\n## Approved Tools\n\n- Read files (input only)\n- Write to `tmp/` (output only)\n- *(Add task-specific tools here)*\n";
+
+// src/templates/skills/new-skill.md.tmpl
+var new_skill_md_default = "# Skill: {%skillName%}\n> {%skillDescription%}\n> **Triggers**: {%skillTriggers%}\n\n## When to Use\n\n*(Describe when this skill should be activated)*\n\n## Procedure\n\n*(Step-by-step instructions for executing this skill)*\n\n1. Step one\n2. Step two\n3. Step three\n\n## Quality Checks\n\n*(How to verify this skill's output is correct)*\n\n- [ ] Output matches expected format\n- [ ] No data loss or corruption\n- [ ] Results reviewed before marking complete\n";
+
+// src/templates/projects/add-project-readme.md.tmpl
+var add_project_readme_md_default = "# Project: {%projectName%}\n> **Status**: active\n> **Started**: {%generatedDate%} | **Last session**: {%generatedDate%}\n\n---\n\n## What This Project Is\n\n{%projectDescription%}\n\n---\n\n## Key Files\n\n| File | Role |\n|------|------|\n| `process.md` | Workflow, hooks, session checklist |\n\n---\n\n## SSOT Map\n\n*(Every piece of data has exactly one authoritative location. List them here.)*\n\n| Data | SSOT File | Derived Files |\n|------|-----------|---------------|\n| *(none yet)* | \u2014 | \u2014 |\n\n---\n\n## Current Status\n\n**Last done**: Project created.\n**Next**: \u2014\n";
+
+// src/templates/projects/add-project-process.md.tmpl
+var add_project_process_md_default = '# Process: {%projectName%}\n> Workflow, hooks, and session checklist for this project.\n> Update this file as the workflow evolves.\n\n---\n{%#if sessionHandoff%}\n## Session Start Checklist (Pre-Hooks)\n\nRun these at the start of every session on this project:\n\n1. [ ] Read `README.md` \u2014 confirm current status and next step\n2. [ ] Read `{%governanceFile%}` (auto-loaded, but confirm it\'s current)\n3. [ ] Check `tmp/{task}/plan.md` if a batch is in progress\n4. [ ] Confirm SSOT files are in expected state (no stale data)\n\n---\n\n## Session End Checklist (Post-Hooks)\n\nRun these at the end of every session (mandatory \u2014 not optional):\n\n1. [ ] Save all work to SSOT files\n2. [ ] Sync derived files (regenerate from SSOTs)\n3. [ ] SSOT integrity check (no duplicates, no stale data)\n4. [ ] Update `README.md` \u2192 "Last done" and "Next" fields\n5. [ ] Write next-session plan to `tmp/{task}/plan.md`\n6. [ ] Run QC on work done this session\n\n---\n{%/if%}\n\n## Execution Workflow\n\n*(Describe the main execution loop for this project\'s primary task)*\n{%#if isResearch%}\n```\n1. Define research question \u2192 get approval\n2. Gather sources \u2192 write findings to file immediately\n3. Synthesize \u2192 cite all sources\n4. QC gate: {%flushCadence%}\n5. Output: artifacts/{topic}/synthesis.md\n```\n{%/if%}\n{%#if isContent%}\n```\n1. Brief \u2192 get approval on scope and outline\n2. Draft \u2192 write to artifacts/\n3. Review \u2192 collect feedback in dedicated file\n4. Revise \u2192 approval required before finalizing\n5. QC gate: {%flushCadence%}\n```\n{%/if%}\n{%#if isDataProcessing%}\n```\n1. Plan \u2192 get approval \u2192 define batch size\n2. Process batch \u2192 validate schema on every write\n3. QC gate: {%flushCadence%} (Ralph Loop)\n4. Output: tmp/{task}/{name}.json\n5. Human review \u2192 finalize\n```\n{%/if%}\n{%#if isCustom%}\n```\n1. Plan \u2192 get approval \u2192 execute\n2. Batch size: [N items per batch]\n3. QC gate: {%flushCadence%}\n4. Output: tmp/{task}/{name}.json\n```\n{%/if%}\n\n---\n{%#if hasQualityGates%}\n## Active Batch Tracking\n\n| Batch | Status | QC Grade | Notes |\n|-------|--------|----------|-------|\n| *(none yet)* | \u2014 | \u2014 | \u2014 |\n\n---\n{%/if%}\n\n## Known Gotchas (Project-Specific)\n\n*(1-2 line summaries of project-specific failure modes)*\n\n*(None yet \u2014 add entries as issues arise)*\n';
+
+// src/templates/index.ts
+var templates = {
+  governanceFile: governance_file_md_default,
+  gettingStarted: getting_started_md_default,
+  gitignore: gitignore_default,
+  contextDiscipline: context_discipline_md_default,
+  approvalFirst: approval_first_md_default,
+  qualityGates: quality_gates_md_default,
+  skillRegistry: SKILL_REGISTRY_md_default,
+  primaryAgent: primary_agent_md_default,
+  agentTemplate: agent_template_md_default,
+  subagentBootstrap: subagent_bootstrap_md_default,
+  gotchaLog: gotcha_log_md_default,
+  futureConsiderations: future_considerations_md_default,
+  memoryIndex: MEMORY_md_default,
+  projectReadme: project_readme_md_default,
+  projectProcess: project_process_md_default,
+  newAgent: new_agent_md_default,
+  newSkill: new_skill_md_default,
+  addProjectReadme: add_project_readme_md_default,
+  addProjectProcess: add_project_process_md_default
+};
+
+// src/writer.ts
+function writeWorkspace(targetDir, vars, config) {
+  const filesWritten = [];
+  const dirsCreated = [];
+  try {
+    for (const entry of OUTPUT_MANIFEST) {
+      if (entry.condition && !vars[entry.condition]) {
+        continue;
+      }
+      const template = templates[entry.templateKey];
+      if (!template) {
+        throw new Error(`Template not found: ${entry.templateKey}`);
+      }
+      const resolvedPath = render(entry.outputPath, vars);
+      const fullPath = import_node_path.default.join(targetDir, resolvedPath);
+      import_node_fs.default.mkdirSync(import_node_path.default.dirname(fullPath), { recursive: true });
+      const content = render(template, vars);
+      import_node_fs.default.writeFileSync(fullPath, content, "utf-8");
+      filesWritten.push(resolvedPath);
+    }
+    for (const dir of EMPTY_DIRS) {
+      const fullDir = import_node_path.default.join(targetDir, dir);
+      import_node_fs.default.mkdirSync(fullDir, { recursive: true });
+      dirsCreated.push(dir);
+      if (dir === "tmp") {
+        import_node_fs.default.writeFileSync(
+          import_node_path.default.join(fullDir, ".gitignore"),
+          "*\n!.gitignore\n",
+          "utf-8"
+        );
+      } else {
+        import_node_fs.default.writeFileSync(import_node_path.default.join(fullDir, ".gitkeep"), "", "utf-8");
+      }
+    }
+    const configPath = import_node_path.default.join(targetDir, ".clawstrap.json");
+    import_node_fs.default.writeFileSync(
+      configPath,
+      JSON.stringify(config, null, 2) + "\n",
+      "utf-8"
+    );
+    filesWritten.push(".clawstrap.json");
+  } catch (error) {
+    if (filesWritten.length > 0) {
+      console.error(
+        `
+Error during workspace generation. ${filesWritten.length} file(s) were written before failure:`
+      );
+      for (const f of filesWritten) {
+        console.error(`  - ${f}`);
+      }
+    }
+    throw error;
+  }
+  return { filesWritten, dirsCreated };
+}
+
+// src/prompts.ts
+var import_prompts = require("@inquirer/prompts");
+var import_node_path2 = __toESM(require("path"), 1);
+async function runPrompts() {
+  console.log("\nWelcome to Clawstrap \u{1F528}");
+  console.log("Scaffold a production-ready AI agent workspace.\n");
+  const workspaceName = await (0, import_prompts.input)({
+    message: "Workspace name:",
+    default: import_node_path2.default.basename(process.cwd()),
+    validate: (v) => v.length > 0 || "Name is required"
+  });
+  const workloadType = await (0, import_prompts.select)({
+    message: "What kind of work will this workspace handle?",
+    choices: [
+      {
+        name: "Research & analysis pipeline",
+        value: "research"
+      },
+      {
+        name: "Content & writing system",
+        value: "content"
+      },
+      {
+        name: "Data processing workflow",
+        value: "data-processing"
+      },
+      {
+        name: "Custom / general purpose",
+        value: "custom"
+      }
+    ]
+  });
+  const parallelAgents = await (0, import_prompts.select)({
+    message: "How many AI agents will work in parallel?",
+    choices: [
+      {
+        name: "Just me \u2014 single agent",
+        value: "single"
+      },
+      {
+        name: "Small team \u2014 2 to 5 agents",
+        value: "small-team"
+      },
+      {
+        name: "Production \u2014 5+ agents, orchestrator pattern",
+        value: "production"
+      }
+    ]
+  });
+  const qualityLevel = await (0, import_prompts.select)({
+    message: "What quality controls do you need?",
+    choices: [
+      {
+        name: "Solo \u2014 lightweight checks, fast iteration",
+        value: "solo"
+      },
+      {
+        name: "Team \u2014 structured QC gates, review steps",
+        value: "team"
+      },
+      {
+        name: "Production \u2014 full QC pipeline, batch monitoring",
+        value: "production"
+      }
+    ]
+  });
+  const sessionHandoff = await (0, import_prompts.confirm)({
+    message: "Enable session handoff checklists? (for multi-session work)",
+    default: true
+  });
+  return {
+    workspaceName,
+    workloadType,
+    parallelAgents,
+    qualityLevel,
+    sessionHandoff
+  };
+}
+function getDefaults(targetDir) {
+  const name = targetDir ? import_node_path2.default.basename(import_node_path2.default.resolve(targetDir)) : import_node_path2.default.basename(process.cwd());
+  return {
+    workspaceName: name,
+    workloadType: "custom",
+    parallelAgents: "single",
+    qualityLevel: "solo",
+    sessionHandoff: true
+  };
+}
+
+// src/init.ts
+var WORKLOAD_LABELS2 = {
+  research: "Research & Analysis",
+  content: "Content & Writing",
+  "data-processing": "Data Processing",
+  custom: "General Purpose"
+};
+async function init(directory, options) {
+  const targetDir = import_node_path3.default.resolve(directory);
+  if (import_node_fs2.default.existsSync(targetDir)) {
+    const hasClawstrap = import_node_fs2.default.existsSync(
+      import_node_path3.default.join(targetDir, ".clawstrap.json")
+    );
+    if (hasClawstrap) {
+      if (options.yes) {
+        console.error(
+          "\nError: directory already has .clawstrap.json. Use interactive mode to confirm overwrite.\n"
+        );
+        process.exit(1);
+      }
+      const proceed = await (0, import_prompts2.confirm)({
+        message: "This directory already has a .clawstrap.json. Overwrite generated files?",
+        default: false
+      });
+      if (!proceed) {
+        console.log("Aborted.\n");
+        return;
+      }
+    }
+  } else {
+    import_node_fs2.default.mkdirSync(targetDir, { recursive: true });
+  }
+  const answers = options.yes ? getDefaults(directory) : await runPrompts();
+  const config = ClawstrapConfigSchema.parse({
+    version: "1.0.0",
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    workspaceName: answers.workspaceName,
+    targetDirectory: directory,
+    aiSystem: "claude-code",
+    workloadType: answers.workloadType,
+    parallelAgents: answers.parallelAgents,
+    qualityLevel: answers.qualityLevel,
+    sessionHandoff: answers.sessionHandoff
+  });
+  console.log("\nConfiguration:");
+  console.log(`  Workspace:      ${config.workspaceName}`);
+  console.log(`  Workload:       ${WORKLOAD_LABELS2[config.workloadType]}`);
+  console.log(`  Parallel agents: ${config.parallelAgents}`);
+  console.log(`  Quality level:  ${config.qualityLevel}`);
+  console.log(
+    `  Session handoff: ${config.sessionHandoff ? "yes" : "no"}`
+  );
+  const vars = deriveTemplateVars(config);
+  console.log("\nGenerating your workspace...\n");
+  const result = writeWorkspace(targetDir, vars, config);
+  for (const file of result.filesWritten) {
+    console.log(`  \u2713 ${file}`);
+  }
+  for (const dir of result.dirsCreated) {
+    console.log(`  \u2713 ${dir}/`);
+  }
+  console.log(`
+Done. Open GETTING_STARTED.md to begin.
+`);
+}
+
+// src/add-agent.ts
+var import_node_fs4 = __toESM(require("fs"), 1);
+var import_node_path5 = __toESM(require("path"), 1);
+var import_prompts4 = require("@inquirer/prompts");
+
+// src/load-workspace.ts
+var import_node_fs3 = __toESM(require("fs"), 1);
+var import_node_path4 = __toESM(require("path"), 1);
+var import_zod2 = require("zod");
+function loadWorkspace(fromDir) {
+  const dir = fromDir ? import_node_path4.default.resolve(fromDir) : process.cwd();
+  const configPath = import_node_path4.default.join(dir, ".clawstrap.json");
+  if (!import_node_fs3.default.existsSync(configPath)) {
+    console.error(
+      "\nError: .clawstrap.json not found. Run `clawstrap init` first.\n"
+    );
+    process.exit(1);
+  }
+  let raw;
+  try {
+    raw = JSON.parse(import_node_fs3.default.readFileSync(configPath, "utf-8"));
+  } catch {
+    console.error(
+      "\nError: .clawstrap.json contains invalid JSON. Fix or delete it and run `clawstrap init`.\n"
+    );
+    process.exit(1);
+  }
+  let config;
+  try {
+    config = ClawstrapConfigSchema.parse(raw);
+  } catch (err) {
+    console.error("\nError: .clawstrap.json has an invalid schema.");
+    if (err instanceof import_zod2.ZodError) {
+      for (const issue of err.issues) {
+        console.error(`  - ${issue.path.join(".")}: ${issue.message}`);
+      }
+    }
+    console.error("\nFix the file or delete it and run `clawstrap init`.\n");
+    process.exit(1);
+  }
+  const vars = deriveTemplateVars(config);
+  return { config, vars, rootDir: dir };
+}
+
+// src/add-agent.ts
+async function addAgent(name) {
+  const { vars, rootDir } = loadWorkspace();
+  const systemDir = String(vars.systemDir);
+  const outPath = import_node_path5.default.join(rootDir, systemDir, "agents", `${name}.md`);
+  if (import_node_fs4.default.existsSync(outPath)) {
+    console.error(`
+Error: agent "${name}" already exists at ${systemDir}/agents/${name}.md
+`);
+    process.exit(1);
+  }
+  const description = await (0, import_prompts4.input)({
+    message: "Agent description (one line):",
+    validate: (v) => v.length > 0 || "Description is required"
+  });
+  const role = await (0, import_prompts4.select)({
+    message: "Agent role:",
+    choices: [
+      { name: "Worker \u2014 performs a specific task", value: "worker" },
+      { name: "Orchestrator \u2014 coordinates other agents", value: "orchestrator" },
+      { name: "Reviewer \u2014 validates and QCs output", value: "reviewer" }
+    ]
+  });
+  const agentVars = {
+    ...vars,
+    agentName: name,
+    agentDescription: description,
+    agentRole: role
+  };
+  const content = render(templates.newAgent, agentVars);
+  import_node_fs4.default.mkdirSync(import_node_path5.default.dirname(outPath), { recursive: true });
+  import_node_fs4.default.writeFileSync(outPath, content, "utf-8");
+  console.log(`
+  \u2713 ${systemDir}/agents/${name}.md
+`);
+}
+
+// src/add-skill.ts
+var import_node_fs5 = __toESM(require("fs"), 1);
+var import_node_path6 = __toESM(require("path"), 1);
+var import_prompts5 = require("@inquirer/prompts");
+async function addSkill(name) {
+  const { vars, rootDir } = loadWorkspace();
+  const systemDir = String(vars.systemDir);
+  const skillDir = import_node_path6.default.join(rootDir, systemDir, "skills", name);
+  if (import_node_fs5.default.existsSync(skillDir)) {
+    console.error(`
+Error: skill "${name}" already exists at ${systemDir}/skills/${name}/
+`);
+    process.exit(1);
+  }
+  const description = await (0, import_prompts5.input)({
+    message: "Skill description (one line):",
+    validate: (v) => v.length > 0 || "Description is required"
+  });
+  const triggers = await (0, import_prompts5.input)({
+    message: "Trigger phrases (comma-separated):",
+    validate: (v) => v.length > 0 || "At least one trigger is required"
+  });
+  const skillVars = {
+    ...vars,
+    skillName: name,
+    skillDescription: description,
+    skillTriggers: triggers
+  };
+  import_node_fs5.default.mkdirSync(skillDir, { recursive: true });
+  const content = render(templates.newSkill, skillVars);
+  import_node_fs5.default.writeFileSync(import_node_path6.default.join(skillDir, "SKILL.md"), content, "utf-8");
+  const registryPath = import_node_path6.default.join(rootDir, systemDir, "skills", "SKILL_REGISTRY.md");
+  if (import_node_fs5.default.existsSync(registryPath)) {
+    let registry = import_node_fs5.default.readFileSync(registryPath, "utf-8");
+    const newRow = `| ${name} | \`${systemDir}/skills/${name}/SKILL.md\` | ${triggers} |`;
+    if (registry.includes("*(none yet)*")) {
+      registry = registry.replace(
+        /\| \*\(none yet\)\* \| — \| — \|/,
+        newRow
+      );
+    } else {
+      const headingIdx = registry.indexOf("## Registered Skills");
+      if (headingIdx === -1) return;
+      const tableStart = registry.indexOf("|", headingIdx);
+      const afterTable = registry.substring(tableStart);
+      const blankLine = afterTable.search(/\n\n/);
+      const insertPos = blankLine !== -1 ? tableStart + blankLine + 1 : registry.length;
+      registry = registry.slice(0, insertPos) + newRow + "\n" + registry.slice(insertPos);
+    }
+    import_node_fs5.default.writeFileSync(registryPath, registry, "utf-8");
+  }
+  console.log(`
+  \u2713 ${systemDir}/skills/${name}/SKILL.md`);
+  console.log(`  \u2713 ${systemDir}/skills/SKILL_REGISTRY.md (updated)
+`);
+}
+
+// src/add-project.ts
+var import_node_fs6 = __toESM(require("fs"), 1);
+var import_node_path7 = __toESM(require("path"), 1);
+var import_prompts6 = require("@inquirer/prompts");
+async function addProject(name) {
+  const { vars, rootDir } = loadWorkspace();
+  const projectDir = import_node_path7.default.join(rootDir, "projects", name);
+  if (import_node_fs6.default.existsSync(projectDir)) {
+    console.error(`
+Error: project "${name}" already exists at projects/${name}/
+`);
+    process.exit(1);
+  }
+  const description = await (0, import_prompts6.input)({
+    message: "Project description (1-2 sentences):",
+    validate: (v) => v.length > 0 || "Description is required"
+  });
+  const projectVars = {
+    ...vars,
+    projectName: name,
+    projectDescription: description
+  };
+  import_node_fs6.default.mkdirSync(projectDir, { recursive: true });
+  const readme = render(templates.addProjectReadme, projectVars);
+  import_node_fs6.default.writeFileSync(import_node_path7.default.join(projectDir, "README.md"), readme, "utf-8");
+  const process_ = render(templates.addProjectProcess, projectVars);
+  import_node_fs6.default.writeFileSync(import_node_path7.default.join(projectDir, "process.md"), process_, "utf-8");
+  console.log(`
+  \u2713 projects/${name}/README.md`);
+  console.log(`  \u2713 projects/${name}/process.md
+`);
+}
+
+// src/status.ts
+var import_node_fs7 = __toESM(require("fs"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
+var WORKLOAD_LABELS3 = {
+  research: "Research & Analysis",
+  content: "Content & Writing",
+  "data-processing": "Data Processing",
+  custom: "General Purpose"
+};
+function countEntries(dir, exclude = []) {
+  if (!import_node_fs7.default.existsSync(dir)) return 0;
+  return import_node_fs7.default.readdirSync(dir, { withFileTypes: true }).filter((e) => !exclude.includes(e.name) && !e.name.startsWith(".")).length;
+}
+function countSkills(skillsDir) {
+  if (!import_node_fs7.default.existsSync(skillsDir)) return 0;
+  return import_node_fs7.default.readdirSync(skillsDir, { withFileTypes: true }).filter(
+    (e) => e.isDirectory() && import_node_fs7.default.existsSync(import_node_path8.default.join(skillsDir, e.name, "SKILL.md"))
+  ).length;
+}
+async function showStatus() {
+  const { config, vars, rootDir } = loadWorkspace();
+  const systemDir = String(vars.systemDir);
+  const agentsDir = import_node_path8.default.join(rootDir, systemDir, "agents");
+  const skillsDir = import_node_path8.default.join(rootDir, systemDir, "skills");
+  const rulesDir = import_node_path8.default.join(rootDir, systemDir, "rules");
+  const projectsDir = import_node_path8.default.join(rootDir, "projects");
+  const agentCount = countEntries(agentsDir, ["_template.md"]);
+  const skillCount = countSkills(skillsDir);
+  const projectCount = countEntries(projectsDir, ["_template"]);
+  const ruleCount = countEntries(rulesDir);
+  const date = config.createdAt.split("T")[0];
+  console.log(`
+Clawstrap Workspace: ${config.workspaceName}`);
+  console.log(`Created: ${date} | Version: ${config.version}`);
+  console.log(`
+Configuration:`);
+  console.log(
+    `  Workload:        ${WORKLOAD_LABELS3[config.workloadType] ?? config.workloadType}`
+  );
+  console.log(`  Parallel agents: ${config.parallelAgents}`);
+  console.log(`  Quality level:   ${config.qualityLevel}`);
+  console.log(
+    `  Session handoff: ${config.sessionHandoff ? "yes" : "no"}`
+  );
+  console.log(`
+Structure:`);
+  console.log(`  Agents:   ${agentCount} (${systemDir}/agents/)`);
+  console.log(`  Skills:   ${skillCount} (${systemDir}/skills/)`);
+  console.log(`  Projects: ${projectCount} (projects/)`);
+  console.log(`  Rules:    ${ruleCount} (${systemDir}/rules/)`);
+  if (config.lastExport) {
+    const exportDate = config.lastExport.exportedAt.split("T")[0];
+    console.log(`
+Last Export:`);
+    console.log(`  Format:    ${config.lastExport.format}`);
+    console.log(`  Date:      ${exportDate}`);
+    console.log(`  Output:    ${config.lastExport.outputDir}`);
+  }
+  console.log();
+}
+
+// src/export-paperclip.ts
+var import_node_fs12 = __toESM(require("fs"), 1);
+var import_node_path13 = __toESM(require("path"), 1);
+var import_prompts7 = require("@inquirer/prompts");
+
+// src/export-paperclip/translate-agents.ts
+var import_node_fs8 = __toESM(require("fs"), 1);
+var import_node_path9 = __toESM(require("path"), 1);
+function slugToName(slug) {
+  return slug.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+function translateAgents(rootDir, systemDir, workspaceName, skillSlugs) {
+  const agentsDir = import_node_path9.default.join(rootDir, systemDir, "agents");
+  const agents = [];
+  const workerNames = [];
+  const workerAgents = [];
+  if (import_node_fs8.default.existsSync(agentsDir)) {
+    for (const entry of import_node_fs8.default.readdirSync(agentsDir)) {
+      if (entry === "primary-agent.md" || entry === "_template.md" || entry.startsWith(".") || !entry.endsWith(".md")) {
+        continue;
+      }
+      const slug = entry.replace(/\.md$/, "");
+      const rawBody = import_node_fs8.default.readFileSync(import_node_path9.default.join(agentsDir, entry), "utf-8");
+      const roleMatch = rawBody.match(/^>\s*\*\*Purpose\*\*:\s*(.+)/m);
+      const description = roleMatch ? roleMatch[1].trim() : "";
+      const name = slugToName(slug);
+      const title = description || `${name} Agent`;
+      const combined = (rawBody + " " + slug).toLowerCase();
+      const isReviewer = combined.includes("review") || combined.includes("qa") || combined.includes("qc") || combined.includes("quality");
+      const roleType = isReviewer ? "reviewer" : "worker";
+      workerAgents.push({
+        slug,
+        name,
+        title,
+        reportsTo: "ceo",
+        skills: skillSlugs,
+        body: buildWorkerBody(name, title, workspaceName, roleType)
+      });
+      workerNames.push(`**${name}**`);
+    }
+  }
+  agents.push({
+    slug: "ceo",
+    name: "CEO",
+    title: "Chief Executive Officer",
+    reportsTo: null,
+    skills: [],
+    body: buildCeoBody(workspaceName, workerNames)
+  });
+  agents.push(...workerAgents);
+  return agents;
+}
+function buildCeoBody(workspaceName, workerNames) {
+  const handoff = workerNames.length > 0 ? `Route work to the appropriate team member: ${workerNames.join(", ")}.` : "The appropriate specialist for the task.";
+  return `You are the CEO of ${workspaceName}. You set direction, scope work, and ensure every task starts with clear requirements before engineering begins.
+
+## What triggers you
+
+You are activated when new work arrives \u2014 a feature request, a bug report, a project that needs scoping, or a decision that needs product-level thinking.
+
+## What you do
+
+Your job is to turn incoming requests into clear, actionable plans. You decide what to build, why it matters, and who should build it.
+
+You operate in three modes:
+- **Scope and plan** \u2014 break down work into clear tasks with owners and acceptance criteria
+- **Review and approve** \u2014 check completed work meets quality standards before sign-off
+- **Prioritize** \u2014 when multiple tasks compete, decide what ships first and what waits
+
+You enforce the approval-first principle: no work starts without a plan, no plan ships without review.
+
+## What you produce
+
+A scoped plan with task assignments, priorities, and acceptance criteria. Not implementation details \u2014 that's the team's job.
+
+## Who you hand off to
+
+${handoff}`;
+}
+function buildWorkerBody(name, title, workspaceName, roleType) {
+  if (roleType === "reviewer") {
+    return `You are the ${name} at ${workspaceName}. You operate in quality gate mode.
+
+## What triggers you
+
+You are activated when work is ready for review \u2014 a PR needs checking, output needs validation, or quality needs to be verified before shipping.
+
+## What you do
+
+You review work for correctness, security, and adherence to standards. You are not a rubber stamp \u2014 you catch the issues that would hurt in production.
+
+You look for:
+- Logic errors and edge cases
+- Security vulnerabilities
+- Style and convention violations
+- Missing tests or insufficient coverage
+- Assumptions that should be explicit
+
+## What you produce
+
+A review verdict: approved, or a specific list of issues that must be fixed. Every issue includes what's wrong and how to fix it.
+
+## Who you hand off to
+
+If approved, hand back to the **CEO** for final sign-off. If issues found, send back to the original author with specific fixes needed.`;
+  }
+  return `You are the ${name} at ${workspaceName}. Your specialty: ${title.toLowerCase()}.
+
+## What triggers you
+
+You are activated when the CEO assigns you a task that matches your expertise, or when a project needs your specific skills.
+
+## What you do
+
+You take scoped, assigned tasks and execute them. You write code, build features, and solve problems within your domain. You follow the plan \u2014 if the plan is unclear, you escalate to the CEO rather than guessing.
+
+You work with discipline:
+- Read the task requirements fully before starting
+- Break complex tasks into smaller steps
+- Test your work before marking it complete
+- Document decisions that aren't obvious from the code
+
+## What you produce
+
+Working code, tested and ready for review. You hand off a clean branch or deliverable, not a work in progress.
+
+## Who you hand off to
+
+When your work is complete, hand off to the **CEO** for review routing. If a reviewer is available, the CEO will route it there.`;
+}
+
+// src/export-paperclip/translate-governance.ts
+var import_node_fs9 = __toESM(require("fs"), 1);
+var import_node_path10 = __toESM(require("path"), 1);
+var GOVERNANCE_TIERS = {
+  solo: {
+    tier: "light",
+    requiresApproval: false,
+    approvalGates: [],
+    qualityCheckInterval: 10,
+    minQualityGrade: "C"
+  },
+  team: {
+    tier: "standard",
+    requiresApproval: true,
+    approvalGates: ["strategy", "budget-change"],
+    qualityCheckInterval: 5,
+    minQualityGrade: "B"
+  },
+  production: {
+    tier: "strict",
+    requiresApproval: true,
+    approvalGates: [
+      "strategy",
+      "agent-hire",
+      "budget-change",
+      "task-transition"
+    ],
+    qualityCheckInterval: 5,
+    minQualityGrade: "A"
+  }
+};
+function getGovernanceConfig(qualityLevel) {
+  return GOVERNANCE_TIERS[qualityLevel];
+}
+
+// src/export-paperclip/translate-skills.ts
+var import_node_fs10 = __toESM(require("fs"), 1);
+var import_node_path11 = __toESM(require("path"), 1);
+function translateSkills(rootDir, systemDir) {
+  const skillsDir = import_node_path11.default.join(rootDir, systemDir, "skills");
+  const skills = [];
+  if (!import_node_fs10.default.existsSync(skillsDir)) return skills;
+  for (const entry of import_node_fs10.default.readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const skillMdPath = import_node_path11.default.join(skillsDir, entry.name, "SKILL.md");
+    if (!import_node_fs10.default.existsSync(skillMdPath)) continue;
+    skills.push({
+      name: entry.name,
+      sourcePath: `${systemDir}/skills/${entry.name}/SKILL.md`,
+      content: import_node_fs10.default.readFileSync(skillMdPath, "utf-8")
+    });
+  }
+  return skills;
+}
+
+// src/export-paperclip/translate-goals.ts
+var import_node_fs11 = __toESM(require("fs"), 1);
+var import_node_path12 = __toESM(require("path"), 1);
+function translateGoals(rootDir) {
+  const projectsDir = import_node_path12.default.join(rootDir, "projects");
+  const goals = [];
+  if (!import_node_fs11.default.existsSync(projectsDir)) return goals;
+  for (const entry of import_node_fs11.default.readdirSync(projectsDir, { withFileTypes: true })) {
+    if (!entry.isDirectory() || entry.name === "_template" || entry.name.startsWith(".")) {
+      continue;
+    }
+    const readmePath = import_node_path12.default.join(projectsDir, entry.name, "README.md");
+    if (!import_node_fs11.default.existsSync(readmePath)) continue;
+    const content = import_node_fs11.default.readFileSync(readmePath, "utf-8");
+    const descMatch = content.match(
+      /## What This Project Is\s*\n+([\s\S]*?)(?=\n---|\n##|$)/
+    );
+    const description = descMatch ? descMatch[1].trim() : `Project: ${entry.name}`;
+    goals.push({ name: entry.name, description });
+  }
+  return goals;
+}
+
+// src/export-paperclip.ts
+var CLI_VERSION = "1.2.0";
+function toSlug(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+async function exportPaperclip(options) {
+  const { config, vars, rootDir } = loadWorkspace();
+  const systemDir = String(vars.systemDir);
+  const validateOnly = options.validate ?? false;
+  const companyName = options.name ?? await (0, import_prompts7.input)({
+    message: "Company name:",
+    default: config.workspaceName
+  });
+  const mission = options.mission ?? await (0, import_prompts7.input)({
+    message: "Company mission (one line):",
+    default: `Governed AI workspace for ${String(vars.workloadLabel).toLowerCase()}`
+  });
+  const companySlug = toSlug(companyName);
+  const outDir = import_node_path13.default.resolve(
+    options.out ?? `${config.workspaceName}-paperclip`
+  );
+  const skills = translateSkills(rootDir, systemDir);
+  const skillSlugs = skills.map((s) => s.name);
+  const agents = translateAgents(rootDir, systemDir, companyName, skillSlugs);
+  const govConfig = getGovernanceConfig(config.qualityLevel);
+  const goals = translateGoals(rootDir);
+  const nonCeoAgents = agents.filter((a) => a.slug !== "ceo");
+  if (validateOnly) {
+    console.log("\nValidating Paperclip export...\n");
+    console.log("  \u2713 COMPANY.md            valid");
+    console.log("  \u2713 .paperclip.yaml       valid");
+    for (const agent of agents) {
+      console.log(`  \u2713 agents/${agent.slug}/AGENTS.md  valid`);
+    }
+    if (nonCeoAgents.length > 0) {
+      console.log("  \u2713 teams/engineering/TEAM.md  valid");
+    }
+    for (const skill of skills) {
+      console.log(`  \u2713 skills/${skill.name}/SKILL.md  valid`);
+    }
+    console.log(
+      `
+${agents.length} agent(s), ${skills.length} skill(s), ${goals.length} goal(s)`
+    );
+    console.log(`Governance tier: ${govConfig.tier}`);
+    console.log("\nValidation passed. Run without --validate to export.\n");
+    return;
+  }
+  if (import_node_fs12.default.existsSync(outDir)) {
+    const proceed = await (0, import_prompts7.confirm)({
+      message: `Output directory already exists at ${outDir}. Overwrite?`,
+      default: false
+    });
+    if (!proceed) {
+      console.log("Aborted.\n");
+      return;
+    }
+    import_node_fs12.default.rmSync(outDir, { recursive: true, force: true });
+  }
+  console.log("\nExporting to Paperclip format (agentcompanies/v1)...\n");
+  import_node_fs12.default.mkdirSync(outDir, { recursive: true });
+  const goalsYaml = goals.length > 0 ? goals.map((g) => `  - ${g.description.split("\n")[0]}`).join("\n") : `  - ${mission}`;
+  const pipelineLines = agents.map((a, i) => {
+    return `${i + 1}. **${a.name}** ${a.title.toLowerCase()}`;
+  });
+  const companyMd = [
+    "---",
+    `name: ${companyName}`,
+    `description: ${mission}`,
+    `slug: ${companySlug}`,
+    `schema: agentcompanies/v1`,
+    `version: 1.0.0`,
+    `license: MIT`,
+    `authors:`,
+    `  - name: Clawstrap Export`,
+    `goals:`,
+    goalsYaml,
+    "---",
+    "",
+    `${companyName} is a governed AI company with built-in quality gates, approval workflows, and file-first persistence. Every agent operates under structural governance \u2014 no unsupervised work, no lost context between sessions.`,
+    "",
+    ...pipelineLines,
+    "",
+    `The philosophy: plan before building, review before shipping, persist everything to disk. Governance tier: **${govConfig.tier}** \u2014 quality checks every ${govConfig.qualityCheckInterval} tasks, minimum grade ${govConfig.minQualityGrade}.`,
+    "",
+    "---",
+    "",
+    `Generated with [Clawstrap](https://github.com/peppinho89/clawstrap) v${CLI_VERSION}`,
+    ""
+  ].join("\n");
+  import_node_fs12.default.writeFileSync(import_node_path13.default.join(outDir, "COMPANY.md"), companyMd, "utf-8");
+  console.log("  \u2713 COMPANY.md");
+  import_node_fs12.default.writeFileSync(
+    import_node_path13.default.join(outDir, ".paperclip.yaml"),
+    "schema: paperclip/v1\n",
+    "utf-8"
+  );
+  console.log("  \u2713 .paperclip.yaml");
+  for (const agent of agents) {
+    const agentDir = import_node_path13.default.join(outDir, "agents", agent.slug);
+    import_node_fs12.default.mkdirSync(agentDir, { recursive: true });
+    const frontmatterLines = [
+      "---",
+      `name: ${agent.name}`,
+      `title: ${agent.title}`,
+      `reportsTo: ${agent.reportsTo ?? "null"}`
+    ];
+    if (agent.skills.length > 0) {
+      frontmatterLines.push("skills:");
+      for (const s of agent.skills) {
+        frontmatterLines.push(`  - ${s}`);
+      }
+    }
+    frontmatterLines.push("---");
+    const agentMd = frontmatterLines.join("\n") + "\n\n" + agent.body + "\n";
+    import_node_fs12.default.writeFileSync(import_node_path13.default.join(agentDir, "AGENTS.md"), agentMd, "utf-8");
+    console.log(`  \u2713 agents/${agent.slug}/AGENTS.md`);
+  }
+  if (nonCeoAgents.length > 0) {
+    const teamDir = import_node_path13.default.join(outDir, "teams", "engineering");
+    import_node_fs12.default.mkdirSync(teamDir, { recursive: true });
+    const includesList = nonCeoAgents.map((a) => `  - ../../agents/${a.slug}/AGENTS.md`).join("\n");
+    const teamMd = [
+      "---",
+      `name: Engineering`,
+      `description: ${companyName} engineering team`,
+      `slug: engineering`,
+      `manager: ../../agents/ceo/AGENTS.md`,
+      `includes:`,
+      includesList,
+      `tags:`,
+      `  - engineering`,
+      "---",
+      "",
+      `The engineering team at ${companyName}. Led by the CEO, who scopes and delegates work to specialists.`,
+      ""
+    ].join("\n");
+    import_node_fs12.default.writeFileSync(import_node_path13.default.join(teamDir, "TEAM.md"), teamMd, "utf-8");
+    console.log("  \u2713 teams/engineering/TEAM.md");
+  }
+  for (const skill of skills) {
+    const skillDir = import_node_path13.default.join(outDir, "skills", skill.name);
+    import_node_fs12.default.mkdirSync(skillDir, { recursive: true });
+    import_node_fs12.default.writeFileSync(import_node_path13.default.join(skillDir, "SKILL.md"), skill.content, "utf-8");
+    console.log(`  \u2713 skills/${skill.name}/SKILL.md`);
+  }
+  const importScript = [
+    "#!/bin/bash",
+    "# Import this Clawstrap company into Paperclip",
+    "# Requires: Paperclip running at localhost:3100 (default) or PAPERCLIP_URL env var",
+    "",
+    "PAPERCLIP_URL=${PAPERCLIP_URL:-http://localhost:3100}",
+    "",
+    'echo "Importing into Paperclip..."',
+    'npx paperclipai company import . --paperclip-url "$PAPERCLIP_URL" --yes',
+    "",
+    'echo "Done. Open your Paperclip dashboard to review."',
+    ""
+  ].join("\n");
+  const importPath = import_node_path13.default.join(outDir, "import.sh");
+  import_node_fs12.default.writeFileSync(importPath, importScript, "utf-8");
+  import_node_fs12.default.chmodSync(importPath, 493);
+  console.log("  \u2713 import.sh");
+  const updatedConfig = {
+    ...config,
+    lastExport: {
+      format: "paperclip",
+      exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      outputDir: import_node_path13.default.relative(rootDir, outDir) || outDir
+    }
+  };
+  import_node_fs12.default.writeFileSync(
+    import_node_path13.default.join(rootDir, ".clawstrap.json"),
+    JSON.stringify(updatedConfig, null, 2) + "\n",
+    "utf-8"
+  );
+  console.log(
+    `
+Exported to ${import_node_path13.default.relative(process.cwd(), outDir) || outDir}`
+  );
+  console.log(
+    `${agents.length} agent(s), ${skills.length} skill(s), ${goals.length} goal(s)`
+  );
+  console.log(`Governance tier: ${govConfig.tier}
+`);
+}
+
+// src/index.ts
+var program = new import_commander.Command();
+program.name("clawstrap").description("Scaffold a production-ready AI agent workspace").version("1.2.0");
+program.command("init").description("Create a new AI workspace in the current directory").argument("[directory]", "Target directory", ".").option("-y, --yes", "Use defaults, skip prompts").action(async (directory, options) => {
+  await init(directory, options);
+});
+var add = program.command("add").description("Add components to the workspace");
+add.command("agent").description("Add a new agent definition").argument("<name>", "Agent name").action(async (name) => {
+  await addAgent(name);
+});
+add.command("skill").description("Add a new skill").argument("<name>", "Skill name").action(async (name) => {
+  await addSkill(name);
+});
+add.command("project").description("Add a new project").argument("<name>", "Project name").action(async (name) => {
+  await addProject(name);
+});
+program.command("status").description("Show workspace status and configuration").action(async () => {
+  await showStatus();
+});
+program.command("export").description("Export workspace to another format").requiredOption("-f, --format <format>", "Export format (paperclip)").option("-o, --out <dir>", "Output directory").option("-n, --name <name>", "Company name").option("-m, --mission <mission>", "Company mission").option("-a, --adapter <type>", "Agent adapter type (default: claude_local)").option("--validate", "Validate export without writing").action(async (options) => {
+  if (options.format !== "paperclip") {
+    console.error(
+      `
+Unknown format: ${options.format}. Supported: paperclip
+`
+    );
+    process.exit(1);
+  }
+  await exportPaperclip(options);
+});
+program.parse();