create-shallot 0.8.0 → 0.9.0

package/index.ts

@@ -9,8 +9,8 @@ import { dirname, join, resolve } from "path";
  *
  * the project is pure data — a `shallot.json` manifest + plugin modules + `public/`, no vite
  * boilerplate. the CLI provides every harness over it: `shallot dev` runs it standalone with hot
- * reload, `shallot build` ships it (web + native targets). the emitted CLAUDE.md / AGENTS.md point an
- * agent at the installed engine's contract.
+ * reload, `shallot build` ships it (web + native targets). the emitted AGENTS.md points an agent at
+ * the installed engine's contract, and CLAUDE.md imports it.
  */
 export function template(name: string): Record<string, string> {
     return {
@@ -23,8 +23,8 @@ export function template(name: string): Record<string, string> {
                     version: "0.0.0",
                     private: true,
                     type: "module",
-                    dependencies: { "@dylanebert/shallot": "latest" },
-                    devDependencies: { typescript: "^7.0.2" },
+                    dependencies: { "@dylanebert/shallot": "latest", typegpu: "~0.11.9" },
+                    devDependencies: { "unplugin-typegpu": "~0.11.6", typescript: "^7.0.2" },
                 },
                 null,
                 2,
@@ -53,10 +53,21 @@ export function template(name: string): Record<string, string> {
         "public/scenes/scene.scene": SCENE,
         "README.md": readme(name),
         "AGENTS.md": agents(name),
-        "CLAUDE.md": agents(name),
+        "CLAUDE.md": CLAUDE_IMPORT,
     };
 }
 
+// one contract, two entrypoints: Codex reads AGENTS.md, Claude Code reads CLAUDE.md and expands the
+// `@`-import. An import, not a symlink — a Windows checkout without developer mode gets a literal
+// text file from a symlink. The trailing sentence is the cost of that choice: the import expands only
+// for a session rooted in this file's own directory, so opened from a parent the line is literal text
+// and the prose pointer is all the reader gets. Kept identical to the copy-out's stanza in
+// `packages/shallot/bin/scaffold.ts`.
+const CLAUDE_IMPORT = `@AGENTS.md
+
+If the import line above is showing as literal text, this file was loaded from a parent directory; read the AGENTS.md next to this file before working here.
+`;
+
 /** write a template file map under dir, creating parent directories as needed. */
 export function scaffold(dir: string, files: Record<string, string>): void {
     for (const [rel, content] of Object.entries(files)) {
@@ -145,6 +156,8 @@ The engine is the documentation. Read \`node_modules/@dylanebert/shallot/AGENTS.
 contract (ECS, plugins, scenes, GPU, UI, and the \`shallot verify\` harness), and every public export
 carries JSDoc. The examples index lives at \`node_modules/@dylanebert/shallot/examples/AGENTS.md\` — grep
 it for the problem you have, then read that recipe's source, before writing a pattern from scratch.
+\`bunx shallot recipe <name> [dir]\` copies a recipe out of the installed package into a runnable project
+(bare: lists them).
 
 ## Conventions
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "create-shallot",
-    "version": "0.8.0",
+    "version": "0.9.0",
     "type": "module",
     "bin": "./index.ts",
     "files": ["index.ts"],