create-keel-app 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jglasskatz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# create-keel-app
+
+Scaffold a new Keel project with all conventions pre-wired.
+
+## Usage
+
+```bash
+npx create-keel-app <project-name>
+npx create-keel-app <project-name> --template ai-app   # default
+npx create-keel-app <project-name> --template framework
+```
+
+The default template (`ai-app`) creates a project with a working MCP tool server,
+thin-slice agent, architecture map, and all Keel conventions in place.
+The `framework` template creates a minimal framework-only scaffold without the
+agent and MCP demo wiring.
+
+## Options
+
+### `--template <name>`
+
+Choose a project template. Valid values: `ai-app` (default) or `framework`.
+
+### `--local <path-to-keel>`
+
+Point the scaffolded project at a local Keel checkout via `link:` deps (pnpm link: protocol, also supported in npm 8+) instead of `"*"` npm version placeholders. Use this when the `@keel_flow/*` packages are not yet published to npm.
+
+```bash
+npx create-keel-app my-project --local /path/to/keel
+```
+
+The resulting `package.json` will have entries like:
+
+```json
+"@keel_flow/core": "link:/path/to/keel/packages/core"
+```
+
+Running `pnpm install` inside the scaffolded project will then resolve all `@keel_flow/*` deps from your local checkout immediately, with no publish step required.

package/dist/dep-emit.d.ts

@@ -0,0 +1,6 @@
+export interface KeelDepResolution {
+    versions: Record<string, string>;
+}
+export declare function resolveKeelDeps(localPath: string | undefined): KeelDepResolution;
+export declare function applyKeelDeps(packageJsonContent: string, versions: Record<string, string>): string;
+//# sourceMappingURL=dep-emit.d.ts.map

package/dist/dep-emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep-emit.d.ts","sourceRoot":"","sources":["../src/dep-emit.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAmBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAoBhF;AAED,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,MAAM,EAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAQR"}

package/dist/dep-emit.js

@@ -0,0 +1,47 @@
+import { existsSync } from "fs";
+import { resolve } from "path";
+const PACKAGE_DEPS = [
+    "@keel_flow/cli",
+    "@keel_flow/core",
+    "@keel_flow/schema",
+    "@keel_flow/runtime",
+    "@keel_flow/adopt",
+    "@keel_flow/extend",
+    "@keel_flow/pack-general-se",
+    "@keel_flow/pack-agent-topology",
+    "@keel_flow/pack-kb-hygiene",
+    "@keel_flow/eslint-plugin",
+];
+const FOLDER_OVERRIDES = {
+    "@keel_flow/eslint-plugin": "eslint-plugin",
+};
+export function resolveKeelDeps(localPath) {
+    const versions = {};
+    if (!localPath) {
+        // Pin to the current minor (^0.2.0) rather than "*": a future breaking
+        // @keel_flow minor must not retroactively break already-scaffolded apps or a
+        // fresh `npx create-keel-app`.
+        for (const pkg of PACKAGE_DEPS)
+            versions[pkg] = "^0.2.0";
+        return { versions };
+    }
+    const root = resolve(localPath);
+    if (!existsSync(`${root}/packages/core/package.json`)) {
+        throw new Error(`--local path "${root}" does not look like a Keel checkout (no packages/core/package.json)`);
+    }
+    for (const pkg of PACKAGE_DEPS) {
+        const folder = FOLDER_OVERRIDES[pkg] ?? pkg.replace("@keel_flow/", "");
+        versions[pkg] = `link:${root}/packages/${folder}`;
+    }
+    return { versions };
+}
+export function applyKeelDeps(packageJsonContent, versions) {
+    let updated = packageJsonContent;
+    for (const [name, version] of Object.entries(versions)) {
+        const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const re = new RegExp(`("${escaped}"\\s*:\\s*)"[^"]*"`);
+        updated = updated.replace(re, `$1"${version}"`);
+    }
+    return updated;
+}
+//# sourceMappingURL=dep-emit.js.map

package/dist/dep-emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep-emit.js","sourceRoot":"","sources":["../src/dep-emit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAM/B,MAAM,YAAY,GAAG;IACnB,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,oBAAoB;IACpB,kBAAkB;IAClB,mBAAmB;IACnB,4BAA4B;IAC5B,gCAAgC;IAChC,4BAA4B;IAC5B,0BAA0B;CAC3B,CAAC;AAEF,MAAM,gBAAgB,GAA2B;IAC/C,0BAA0B,EAAE,eAAe;CAC5C,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,SAA6B;IAC3D,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,uEAAuE;QACvE,6EAA6E;QAC7E,+BAA+B;QAC/B,KAAK,MAAM,GAAG,IAAI,YAAY;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;QACzD,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,6BAA6B,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,sEAAsE,CAC5F,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACvE,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,aAAa,MAAM,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,kBAA0B,EAC1B,QAAgC;IAEhC,IAAI,OAAO,GAAG,kBAAkB,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,KAAK,OAAO,oBAAoB,CAAC,CAAC;QACxD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,OAAO,GAAG,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import { resolve } from "path";
+import { existsSync } from "fs";
+import { scaffold, VALID_TEMPLATES, DEFAULT_TEMPLATE } from "./scaffold.js";
+const args = process.argv.slice(2);
+let localKeelPath;
+const localFlagIdx = args.indexOf("--local");
+if (localFlagIdx !== -1) {
+    const raw = args[localFlagIdx + 1];
+    if (!raw || raw.startsWith("--")) {
+        process.stderr.write("--local requires a path argument (pnpm link: protocol)\n");
+        process.exit(1);
+    }
+    localKeelPath = resolve(raw);
+    if (!existsSync(`${localKeelPath}/packages/core/package.json`)) {
+        process.stderr.write(`--local path "${localKeelPath}" does not look like a Keel checkout (no packages/core/package.json)\n`);
+        process.exit(1);
+    }
+    args.splice(localFlagIdx, 2);
+}
+let template = DEFAULT_TEMPLATE;
+const templateFlagIdx = args.indexOf("--template");
+if (templateFlagIdx !== -1) {
+    const raw = args[templateFlagIdx + 1];
+    if (!raw || raw.startsWith("--")) {
+        process.stderr.write(`--template requires a value. Valid templates: ${VALID_TEMPLATES.join(", ")}\n`);
+        process.exit(1);
+    }
+    if (!VALID_TEMPLATES.includes(raw)) {
+        process.stderr.write(`Unknown template "${raw}". Valid templates: ${VALID_TEMPLATES.join(", ")}\n`);
+        process.exit(1);
+    }
+    template = raw;
+    args.splice(templateFlagIdx, 2);
+}
+const projectName = args[0];
+if (!projectName) {
+    process.stderr.write("Usage: create-keel-app <project-name> [--template framework|ai-app] [--local <path-to-keel>]\n");
+    process.exit(1);
+}
+if (!/^[a-z0-9-_]+$/i.test(projectName)) {
+    process.stderr.write(`Invalid project name "${projectName}". Use only letters, numbers, hyphens, and underscores.\n`);
+    process.exit(1);
+}
+const targetDir = resolve(process.cwd(), projectName);
+process.stdout.write(`Creating Keel project: ${projectName}\n`);
+process.stdout.write(`Template: ${template}\n`);
+process.stdout.write(`Target: ${targetDir}\n\n`);
+const scaffoldOptions = { template };
+if (localKeelPath)
+    scaffoldOptions.localKeelPath = localKeelPath;
+scaffold(projectName, targetDir, scaffoldOptions);
+process.stdout.write(`Done! Next steps:\n`);
+process.stdout.write(`  cd ${projectName}\n`);
+process.stdout.write(`  pnpm install\n`);
+if (template === "ai-app") {
+    process.stdout.write(`  export ANTHROPIC_API_KEY=sk-...\n`);
+    process.stdout.write(`  pnpm dev\n`);
+}
+else {
+    process.stdout.write(`  pnpm verify\n`);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/scaffold.d.ts

@@ -0,0 +1,13 @@
+import { relative, resolve } from "path";
+import { statSync } from "fs";
+export type TemplateName = "framework" | "ai-app";
+export declare const VALID_TEMPLATES: TemplateName[];
+export declare const DEFAULT_TEMPLATE: TemplateName;
+export interface ScaffoldOptions {
+    template?: TemplateName;
+    localKeelPath?: string;
+}
+export declare function scaffold(projectName: string, targetDir: string, optionsOrLocalKeelPath?: ScaffoldOptions | string): void;
+export declare function getTemplatesDir(): string;
+export { relative, statSync, resolve };
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,QAAQ,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAK9B,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,YAAY,EAA4B,CAAC;AACvE,eAAO,MAAM,gBAAgB,EAAE,YAAuB,CAAC;AAsCvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,sBAAsB,CAAC,EAAE,eAAe,GAAG,MAAM,GAChD,IAAI,CAyBN;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC"}

package/dist/scaffold.js

@@ -0,0 +1,57 @@
+import { mkdirSync, writeFileSync, readdirSync, readFileSync } from "fs";
+import { join, dirname, relative, resolve } from "path";
+import { fileURLToPath } from "url";
+import { statSync } from "fs";
+import { resolveKeelDeps, applyKeelDeps } from "./dep-emit.js";
+const TEMPLATES_DIR = join(dirname(fileURLToPath(import.meta.url)), "../templates");
+export const VALID_TEMPLATES = ["framework", "ai-app"];
+export const DEFAULT_TEMPLATE = "ai-app";
+function substitute(content, projectName) {
+    return content.replaceAll("{{PROJECT_NAME}}", projectName);
+}
+function writeTemplate(templatePath, destPath, projectName) {
+    const content = readFileSync(templatePath, "utf-8");
+    const substituted = substitute(content, projectName);
+    mkdirSync(dirname(destPath), { recursive: true });
+    writeFileSync(destPath, substituted, "utf-8");
+}
+function copyTemplates(srcDir, destDir, projectName, skipDirNames = new Set()) {
+    const entries = readdirSync(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && skipDirNames.has(entry.name))
+            continue;
+        const srcPath = join(srcDir, entry.name);
+        if (entry.isDirectory()) {
+            copyTemplates(srcPath, join(destDir, entry.name), projectName, skipDirNames);
+        }
+        else {
+            const destName = entry.name.endsWith(".tpl")
+                ? entry.name.slice(0, -4)
+                : entry.name;
+            writeTemplate(srcPath, join(destDir, destName), projectName);
+        }
+    }
+}
+export function scaffold(projectName, targetDir, optionsOrLocalKeelPath) {
+    const options = typeof optionsOrLocalKeelPath === "string"
+        ? { localKeelPath: optionsOrLocalKeelPath }
+        : (optionsOrLocalKeelPath ?? {});
+    const template = options.template ?? DEFAULT_TEMPLATE;
+    if (!VALID_TEMPLATES.includes(template)) {
+        throw new Error(`Unknown template "${template}". Valid templates: ${VALID_TEMPLATES.join(", ")}`);
+    }
+    mkdirSync(targetDir, { recursive: true });
+    const sharedDir = join(TEMPLATES_DIR, "shared");
+    copyTemplates(sharedDir, targetDir, projectName);
+    const templateDir = join(TEMPLATES_DIR, template);
+    copyTemplates(templateDir, targetDir, projectName, new Set(["extras"]));
+    const pkgJsonPath = join(targetDir, "package.json");
+    const pkgContent = readFileSync(pkgJsonPath, "utf-8");
+    const { versions } = resolveKeelDeps(options.localKeelPath);
+    writeFileSync(pkgJsonPath, applyKeelDeps(pkgContent, versions), "utf-8");
+}
+export function getTemplatesDir() {
+    return TEMPLATES_DIR;
+}
+export { relative, statSync, resolve };
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "create-keel-app",
+  "version": "0.2.0",
+  "private": false,
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "bin": {
+    "create-keel-app": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@keel_flow/schema": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}

package/templates/ai-app/README.md.tpl

@@ -0,0 +1,56 @@
+# {{PROJECT_NAME}}
+
+A Keel AI-app project. https://github.com/jglasskatz/keel
+
+## Quick start
+
+```bash
+pnpm install
+export ANTHROPIC_API_KEY=sk-...
+pnpm dev
+```
+
+## Verify
+
+```bash
+pnpm verify
+```
+
+## Structure
+
+- `architecture/data.ts` — architecture map (keep in sync with code)
+- `principles/index.ts` — engineering principles registry
+- `src/agents/` — agent definitions via `defineAgent`
+- `src/tools/` — in-process tool definitions via `defineTool`
+- `src/index.ts` — bootstrap entrypoint
+
+## Tools (in-process)
+
+Tools live in `src/tools/` and are defined with `defineTool` from
+`@keel_flow/core`. Each tool exports a typed handler with a Zod
+`inputSchema`. The agent loop in `@keel_flow/runtime` invokes them
+directly in-process — no JSON-RPC, no child process, no extra
+runtime cost.
+
+### Adding a new tool
+
+1. Create `src/tools/my-tool.ts` exporting a `defineTool({...})` value.
+2. Register it in `src/tools/index.ts` so it's part of the tool
+   registry.
+3. Pass it into `runThinSlice({ ..., tools: [...] })` (or whichever
+   agent invocation needs it).
+
+### Opt-in: MCP
+
+If you need cross-host tool reuse (third-party MCP servers, sharing
+the same tool with a Claude Desktop install, multi-process
+isolation), see `create-keel-app`'s `extras/mcp.md` reference doc
+for the recipe. MCP is not included in the default scaffold — most
+projects don't need it.
+
+## Adding an agent
+
+1. Create `src/agents/my-agent.ts` using `defineAgent` from `@keel_flow/core`.
+2. Add the node to `architecture/data.ts`.
+3. Wire it into `src/index.ts`.
+4. Run `pnpm verify` — all checks must pass.

package/templates/ai-app/architecture/data.ts.tpl

@@ -0,0 +1,76 @@
+import type { ArchitectureMap } from "@keel_flow/schema";
+import { SCHEMA_VERSION } from "@keel_flow/schema";
+
+const data: ArchitectureMap = {
+  schemaVersion: SCHEMA_VERSION,
+  layers: [
+    {
+      id: "agents",
+      label: "Agents",
+      description: "AI agents for the {{PROJECT_NAME}} system",
+      color: "#4f46e5",
+    },
+    {
+      id: "tools",
+      label: "Tools",
+      description: "In-process tools called by agents via defineTool",
+      color: "#0891b2",
+    },
+  ],
+  nodes: [
+    {
+      id: "thin-slice-agent",
+      label: "Thin Slice Agent",
+      layer: "agents",
+      tech: "TypeScript / Anthropic SDK",
+      description:
+        "Seed agent for {{PROJECT_NAME}} — replace with your domain agents",
+      keyFiles: ["src/agents/thin-slice.ts"],
+      keyFunctionality: ["accept prompt", "call in-process tools", "return response"],
+      fileCount: 1,
+      linesOfCode: "~40",
+      principles: {
+        upholds: [
+          { id: "single-source-of-truth-per-tool", reason: "Each tool has one data path" },
+        ],
+        violates: [],
+      },
+    },
+    {
+      id: "hello-tool",
+      label: "Hello Tool",
+      layer: "tools",
+      tech: "TypeScript / Zod",
+      description:
+        "Example in-process tool defined via defineTool — replace with domain-specific tools",
+      keyFiles: ["src/tools/hello.ts"],
+      keyFunctionality: ["greet by name"],
+      fileCount: 1,
+      linesOfCode: "~10",
+      principles: {
+        upholds: [
+          { id: "tool-schemas-are-load-bearing", reason: "Zod inputSchema is source of truth" },
+        ],
+        violates: [],
+      },
+    },
+  ],
+  connections: [
+    {
+      from: "thin-slice-agent",
+      to: "hello-tool",
+      type: "tool-call",
+      label: "calls hello",
+    },
+  ],
+  contexts: [
+    {
+      id: "thin-slice",
+      label: "Thin Slice",
+      description: "Initial runnable context — expand as you add domain agents",
+      nodeIds: ["thin-slice-agent", "hello-tool"],
+    },
+  ],
+};
+
+export default data;

package/templates/ai-app/extras/mcp.md.tpl

@@ -0,0 +1,148 @@
+# Opt-in: Adding MCP to a Keel ai-app
+
+The default ai-app scaffold uses **in-process tools** defined with
+`defineTool` from `@keel_flow/core`. The agent loop calls them directly.
+This is the simplest, fastest, and most debuggable arrangement, and
+is the right default for almost every project.
+
+You only need MCP (Model Context Protocol) if you have one of these
+specific needs:
+
+- **Cross-host tool reuse** — a tool server you want to share
+  between this app, Claude Desktop, and other agents.
+- **Process isolation** — a tool that needs to run as a separate
+  process for sandboxing or because it uses a runtime your main
+  process cannot.
+- **Third-party MCP servers** — you want to consume an existing
+  off-the-shelf MCP server (filesystem, GitHub, databases).
+
+If none of those apply, **stick with in-process tools**. MCP adds a
+JSON-RPC layer, a child process, and a schema-translation round
+trip for zero functional benefit in the single-process case.
+
+> See the Keel whitepaper sections on MCP for the framework-level
+> rationale and the agent-topology principles that govern when to
+> reach for it.
+
+## Recipe (when you do need it)
+
+### 1. Install the SDK
+
+```bash
+pnpm add @modelcontextprotocol/sdk
+```
+
+### 2. Create `src/mcp-server.ts`
+
+A minimal stdio-transport MCP server that exposes the same
+`helloTool` over the wire:
+
+```ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const server = new Server(
+  { name: "{{PROJECT_NAME}}-tools", version: "0.1.0" },
+  { capabilities: { tools: {} } },
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "hello",
+      description: "Say hello to a name.",
+      inputSchema: {
+        type: "object",
+        properties: { name: { type: "string" } },
+        required: ["name"],
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+  if (req.params.name === "hello") {
+    const input = req.params.arguments as { name: string };
+    return {
+      content: [{ type: "text", text: `Hello, ${input.name}!` }],
+    };
+  }
+  throw new Error(`Unknown tool: ${req.params.name}`);
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+```
+
+### 3. Adapt the in-process tool through MCP
+
+Create `src/mcp-client.ts` that spawns the server, lists tools, and
+returns `ToolDefinition[]` for `@keel_flow/runtime`:
+
+```ts
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { defineTool } from "@keel_flow/core";
+import { z } from "zod";
+import type { ToolDefinition } from "@keel_flow/runtime";
+
+export async function createMCPTools(
+  command: string[],
+): Promise<ToolDefinition[]> {
+  const [cmd, ...args] = command;
+  if (!cmd) throw new Error("command must have at least one element");
+
+  const transport = new StdioClientTransport({ command: cmd, args });
+  const client = new Client(
+    { name: "{{PROJECT_NAME}}-client", version: "0.1.0" },
+    { capabilities: {} },
+  );
+  await client.connect(transport);
+
+  const { tools: mcpTools } = await client.listTools();
+  return mcpTools.map((t) =>
+    defineTool({
+      id: t.name,
+      description: t.description ?? t.name,
+      inputSchema: z.object({ name: z.string() }),
+      async handler(input: unknown) {
+        const result = await client.callTool({
+          name: t.name,
+          arguments: input as Record<string, unknown>,
+        });
+        return result.content;
+      },
+    }) as ToolDefinition,
+  );
+}
+```
+
+### 4. Wire it from `src/index.ts`
+
+```ts
+import { createProvider } from "@keel_flow/runtime";
+import { runThinSlice } from "./agents/thin-slice.js";
+import { createMCPTools } from "./mcp-client.js";
+
+const provider = createProvider({ kind: "anthropic", apiKey: process.env["ANTHROPIC_API_KEY"] ?? "" });
+const tools = await createMCPTools(["node", "./dist/mcp-server.js"]);
+const result = await runThinSlice({ provider, tools, prompt: "Say hi to the world." });
+console.log(result);
+```
+
+### 5. Update the architecture map
+
+Add a `mcp-server` node + an `mcp-client` node to
+`architecture/data.ts`. Mark the tool layer's tech as
+`"TypeScript / MCP"` and add the connections explicitly. Verify
+will block the merge until you do.
+
+---
+
+**Note:** this document is reference material that ships with
+`create-keel-app`. It is **not** emitted into your project by
+default. Copy from it manually when you decide you need MCP.

package/templates/ai-app/package.json.tpl

@@ -0,0 +1,37 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch ./src/index.ts",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "verify": "keel verify --diff origin/main..HEAD"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "*",
+    "@keel_flow/adopt": "^0.2.0",
+    "@keel_flow/cli": "^0.2.0",
+    "@keel_flow/core": "^0.2.0",
+    "@keel_flow/eslint-plugin": "^0.2.0",
+    "@keel_flow/extend": "^0.2.0",
+    "@keel_flow/runtime": "^0.2.0",
+    "@keel_flow/schema": "^0.2.0",
+    "@keel_flow/pack-agent-topology": "^0.2.0",
+    "@keel_flow/pack-general-se": "^0.2.0",
+    "@keel_flow/pack-kb-hygiene": "^0.2.0",
+    "next": "*",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}

package/templates/ai-app/src/agents/thin-slice.ts.tpl

@@ -0,0 +1,28 @@
+import { defineAgent } from "@keel_flow/core";
+import { runAgent } from "@keel_flow/runtime";
+import type { ModelProvider, ToolDefinition } from "@keel_flow/runtime";
+
+export const thinSliceAgent = defineAgent({
+  id: "thin-slice-agent",
+  description:
+    "Seed agent for {{PROJECT_NAME}} — accepts a prompt and invokes in-process tools",
+  tools: [],
+  prompt:
+    "You are a helpful assistant for the {{PROJECT_NAME}} project. Use the available tools to demonstrate end-to-end tool invocation.",
+  model: "claude-sonnet-4-6",
+});
+
+export interface RunThinSliceArgs {
+  provider: ModelProvider;
+  tools: ToolDefinition[];
+  prompt: string;
+}
+
+export async function runThinSlice(args: RunThinSliceArgs) {
+  return runAgent({
+    agent: thinSliceAgent.config,
+    tools: args.tools,
+    prompt: args.prompt,
+    provider: args.provider,
+  });
+}

package/templates/ai-app/src/index.ts.tpl

@@ -0,0 +1,20 @@
+import { createProvider } from "@keel_flow/runtime";
+import { runThinSlice } from "./agents/thin-slice.js";
+import { toolRegistry } from "./tools/index.js";
+
+const provider = createProvider({
+  kind:
+    process.env["KEEL_PROVIDER_KIND"] === "openai-compatible"
+      ? "openai-compatible"
+      : "anthropic",
+  apiKey:
+    process.env["ANTHROPIC_API_KEY"] ?? process.env["OPENAI_API_KEY"] ?? "",
+});
+
+const result = await runThinSlice({
+  provider,
+  tools: toolRegistry,
+  prompt: "Say hi to the world.",
+});
+
+console.log(result);

package/templates/ai-app/src/tools/hello.test.ts.tpl

@@ -0,0 +1,14 @@
+import { describe, it, expect } from "vitest";
+import { helloTool } from "./hello.js";
+
+describe("helloTool", () => {
+  it("returns a greeting for the given name", async () => {
+    const result = await helloTool.call({ name: "world" });
+    expect(result).toEqual({ greeting: "Hello, world!" });
+  });
+
+  it("has id 'hello' and a non-empty description", () => {
+    expect(helloTool.config.id).toBe("hello");
+    expect(helloTool.config.description.length).toBeGreaterThan(0);
+  });
+});

package/templates/ai-app/src/tools/hello.ts.tpl

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { defineTool } from "@keel_flow/core";
+
+export const helloTool = defineTool({
+  id: "hello",
+  description: "Say hello to a name",
+  inputSchema: z.object({ name: z.string() }),
+  handler: async ({ name }) => ({ greeting: `Hello, ${name}!` }),
+});

package/templates/ai-app/src/tools/index.ts.tpl

@@ -0,0 +1,6 @@
+import type { ToolDefinition } from "@keel_flow/runtime";
+import { helloTool } from "./hello.js";
+
+export const toolRegistry: ToolDefinition[] = [helloTool as unknown as ToolDefinition];
+
+export { helloTool };

package/templates/framework/README.md.tpl

@@ -0,0 +1,31 @@
+# {{PROJECT_NAME}}
+
+A Keel-disciplined project (framework template). https://github.com/jglasskatz/keel
+
+This template ships the Keel discipline only — `architecture/data.ts`,
+`principles/index.ts`, the verify gate, eslint plugin, and the
+principle packs. It does NOT include the agent runtime or any AI-app
+scaffolding. Add `@keel_flow/runtime` + `@keel_flow/core` `defineAgent` /
+`defineTool` patterns when you need them; until then, this project is
+a plain TypeScript module under Keel's architectural guardrails.
+
+## Quick start
+
+```bash
+pnpm install
+pnpm verify
+```
+
+## Structure
+
+- `architecture/data.ts` — architecture map (keep in sync with code)
+- `principles/index.ts` — engineering principles registry
+- `eslint.config.js` — editor-time principle checks via `@keel_flow/eslint-plugin`
+- `src/index.ts` — your code
+
+## Adding agents later
+
+If you decide you want an AI app, scaffold a new project with
+`create-keel-app <name> --template ai-app` and copy the relevant
+files over. The two templates share the same shared/ baseline so the
+disciplines align.

package/templates/framework/package.json.tpl

@@ -0,0 +1,30 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "verify": "keel verify --diff origin/main..HEAD"
+  },
+  "dependencies": {
+    "@keel_flow/cli": "^0.2.0",
+    "@keel_flow/core": "^0.2.0",
+    "@keel_flow/schema": "^0.2.0",
+    "@keel_flow/eslint-plugin": "^0.2.0",
+    "@keel_flow/pack-agent-topology": "^0.2.0",
+    "@keel_flow/pack-general-se": "^0.2.0",
+    "@keel_flow/pack-kb-hygiene": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}

package/templates/framework/src/index.test.ts.tpl

@@ -0,0 +1,8 @@
+import { describe, it, expect } from "vitest";
+import { projectName } from "./index.js";
+
+describe("{{PROJECT_NAME}}", () => {
+  it("exports the project name", () => {
+    expect(projectName).toBe("{{PROJECT_NAME}}");
+  });
+});

package/templates/framework/src/index.ts.tpl

@@ -0,0 +1 @@
+export const projectName = "{{PROJECT_NAME}}";

package/templates/shared/.github/workflows/keel-verify.yml.tpl

@@ -0,0 +1,29 @@
+name: Keel Verify
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  keel-verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Keel Verify
+        run: npx keel verify --diff origin/main..HEAD

package/templates/shared/.gitignore.tpl

@@ -0,0 +1,10 @@
+node_modules
+dist
+.turbo
+*.log
+.env
+.env.local
+.DS_Store
+.keel/sessions
+.keel/repo-map.cache.json
+.keel/encryption-key

package/templates/shared/.keel/local-skill.md.tpl

@@ -0,0 +1,19 @@
+<!--
+  Local skill overlay for {{PROJECT_NAME}}.
+
+  pi-keel reads this file (and ~/.keel/local-skill.md) and merges its
+  contents into the active skill at session start. Use it to encode
+  project-specific tool guidance, naming conventions, or repository
+  invariants that should be in the agent's context for every session.
+
+  Lines starting with "<!-- -->" comments are ignored. Uncomment and
+  edit to take effect.
+-->
+
+<!--
+## Project conventions
+
+- All new tools live under `src/tools/` and use `defineTool`.
+- All new agents live under `src/agents/` and use `defineAgent`.
+- Update `architecture/data.ts` in the same commit as code changes.
+-->

package/templates/shared/.keel/memory.md.tpl

@@ -0,0 +1,15 @@
+# Memory — {{PROJECT_NAME}}
+
+<!--
+  Append-only project memory consumed by pi-keel and @keel_flow/memory.
+
+  Use `keel memory add "..."` from the CLI to add entries (each
+  prefixed with a timestamped `## ` header). Edit-by-hand is fine
+  but breaks idempotent id derivation — prefer the CLI in practice.
+-->
+
+## {{PROJECT_NAME}} — project facts
+
+Replace this block with the load-bearing facts about this project:
+its domain, the primary agents, the data sources, the deployment
+target. The agent reads this file at the top of every session.

package/templates/shared/CLAUDE.md.tpl

@@ -0,0 +1,28 @@
+# CLAUDE.md — {{PROJECT_NAME}}
+
+This project uses the Keel framework: https://github.com/jglasskatz/keel
+
+## Conventions
+
+- `architecture/data.ts` — the architecture map. Update it when you add/remove/rename any node.
+- `principles/index.ts` — the principles registry. Add domain-specific principles here.
+- `src/agents/` — one file per agent, using `defineAgent` from `@keel_flow/core`.
+- `src/tools/` — one file per tool, using `defineTool` from `@keel_flow/core` with a Zod `inputSchema`.
+- `src/index.ts` — the public entrypoint.
+
+## Verify gate
+
+Every PR runs `keel verify --diff origin/main..HEAD` in CI.
+
+Critical violations block merge. Run `pnpm verify` locally before pushing.
+
+## Env vars required
+
+- `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` — required for agent invocations
+
+## Quick start
+
+```bash
+pnpm install
+ANTHROPIC_API_KEY=sk-... pnpm dev
+```

package/templates/shared/architecture/data.ts.tpl

@@ -0,0 +1,45 @@
+import type { ArchitectureMap } from "@keel_flow/schema";
+import { SCHEMA_VERSION } from "@keel_flow/schema";
+
+const data: ArchitectureMap = {
+  schemaVersion: SCHEMA_VERSION,
+  layers: [
+    {
+      id: "core",
+      label: "Core",
+      description: "Primary modules of the {{PROJECT_NAME}} system",
+      color: "#4f46e5",
+    },
+  ],
+  nodes: [
+    {
+      id: "{{PROJECT_NAME}}-root",
+      label: "{{PROJECT_NAME}} Root",
+      layer: "core",
+      tech: "TypeScript",
+      description:
+        "Seed node for {{PROJECT_NAME}} — replace with your domain modules and keep this map in sync with code",
+      keyFiles: ["src/index.ts"],
+      keyFunctionality: ["bootstrap"],
+      fileCount: 1,
+      linesOfCode: "~20",
+      principles: {
+        upholds: [
+          { id: "single-source-of-truth", reason: "One canonical entry per concept" },
+        ],
+        violates: [],
+      },
+    },
+  ],
+  connections: [],
+  contexts: [
+    {
+      id: "thin-slice",
+      label: "Thin Slice",
+      description: "Initial runnable context — expand as you add domain modules",
+      nodeIds: ["{{PROJECT_NAME}}-root"],
+    },
+  ],
+};
+
+export default data;

package/templates/shared/eslint.config.js.tpl

@@ -0,0 +1,42 @@
+import tseslint from "@typescript-eslint/eslint-plugin";
+import tsparser from "@typescript-eslint/parser";
+import keelPlugin from "@keel_flow/eslint-plugin";
+
+/** @type {import('eslint').Linter.Config[]} */
+const config = [
+  {
+    ignores: ["**/dist/**", "**/node_modules/**", "**/.turbo/**"],
+  },
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: "module",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tseslint,
+      "@keel_flow": keelPlugin,
+    },
+    rules: {
+      ...tseslint.configs.recommended.rules,
+      "@typescript-eslint/no-explicit-any": "error",
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
+      ],
+      "@keel_flow/tests-as-contracts": "warn",
+      "@keel_flow/wrong-way-impossible": "error",
+      "@keel_flow/naming-is-design": "warn",
+      "@keel_flow/tool-schemas-are-load-bearing": "error",
+      "@keel_flow/tool-failures-are-typed": "warn",
+      "@keel_flow/chunk-size-bounded": "warn",
+      "@keel_flow/retrieval-confidence-floor": "warn",
+    },
+  },
+];
+
+export default config;

package/templates/shared/principles/index.ts.tpl

@@ -0,0 +1,54 @@
+import { createPrincipleRegistry } from "@keel_flow/core";
+import type { PrincipleRegistry } from "@keel_flow/core";
+import type { PrincipleWithCheck } from "@keel_flow/schema";
+
+const generalSePrinciples: PrincipleWithCheck[] = [
+  {
+    id: "single-source-of-truth",
+    description: "Every fact has exactly one canonical home",
+    rationale: "Duplicated truth diverges over time",
+    severity: "critical",
+  },
+  {
+    id: "tests-as-contracts",
+    description: "Every public module has a co-located test",
+    rationale: "A test is the cheapest precise documentation",
+    severity: "critical",
+  },
+  {
+    id: "errors-at-boundaries",
+    description: "Validate and throw at every system boundary",
+    rationale: "Errors close to origin are cheap",
+    severity: "critical",
+  },
+];
+
+const agentTopologyPrinciples: PrincipleWithCheck[] = [
+  {
+    id: "single-source-of-truth-per-tool",
+    description: "Each tool reads/writes through exactly one data path",
+    rationale: "Multiple paths create state drift",
+    severity: "critical",
+  },
+  {
+    id: "tool-schemas-are-load-bearing",
+    description: "Tool input and output schemas are the source of truth",
+    rationale: "Prose descriptions drift; schemas are machine-checked",
+    severity: "critical",
+  },
+];
+
+const kbHygienePrinciples: PrincipleWithCheck[] = [
+  {
+    id: "cite-or-decline",
+    description: "Every agent response derived from the KB must cite the source chunk",
+    rationale: "Uncited claims are indistinguishable from hallucinations",
+    severity: "critical",
+  },
+];
+
+export const keelPrinciples: PrincipleRegistry = createPrincipleRegistry([
+  { principles: generalSePrinciples },
+  { principles: agentTopologyPrinciples },
+  { principles: kbHygienePrinciples },
+]);

package/templates/shared/tsconfig.json.tpl

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "esModuleInterop": false,
+    "skipLibCheck": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitAny": true,
+    "noImplicitOverride": true,
+    "exactOptionalPropertyTypes": true,
+    "outDir": "dist",
+    "lib": ["ES2022"],
+    "types": ["node"]
+  },
+  "include": ["src", "architecture", "principles"],
+  "exclude": ["**/*.test.ts", "dist"]
+}