create-cofounder 0.1.2 → 0.1.4

package/README.md

@@ -1,16 +1,22 @@
 # create-cofounder
 
-Initializer for Cofounder Crew project config.
+Initializer for Cofounder Crew projects.
 
 ```bash
-npm create cofounder@latest
-npm create cofounder@latest -- --template worktree --setup-codex --yes
+npm create cofounder@latest -- --setup-codex --yes
+codex
 ```
 
-This creates a `.cofounder/` skeleton in the current project and can optionally install the Codex MCP entry.
+This creates a `.cofounder/` team skeleton, adds Codex-facing project instructions when `AGENTS.md` is not already present, and can install the Codex MCP entry.
 
-`npm create` does not install a persistent `cofounder` shell command. For one-off runtime commands:
+If `AGENTS.md` already exists, Cofounder will not modify it. Add the short Cofounder bridge block printed by the initializer so Codex knows to read `.cofounder/codex-instructions.md`.
 
-```bash
-npx -y --package cofounder-crew -- cofounder team
+After initialization, the intended interface is Codex chat:
+
+```text
+Use the Cofounder team. Show me who is available.
+Ask backend to inspect this repo.
+Help me add or adjust a Cofounder teammate.
 ```
+
+The `worktree` template requires a Git repository with at least one commit before delegated tasks can run in isolated worktrees.

package/index.js

@@ -13,16 +13,31 @@ async function main(argv = process.argv.slice(2)) {
   const template = answers.template ?? "default";
 
   await runCofounder(["init", "--template", template], { inherit: true });
+  if (template === "worktree" && !(await hasGitHead())) {
+    printWorktreePrerequisiteWarning();
+  }
 
   if (answers.setupCodex) {
     await runCofounder(["setup", "codex", "--install"], { inherit: true });
-  } else {
-    console.log("");
-    console.log("Next:");
+    printConversationNext({ setupInstalled: true });
+    return;
+  }
+
+  printConversationNext({ setupInstalled: false });
+}
+
+function printConversationNext({ setupInstalled }) {
+  console.log("");
+  console.log("Next:");
+  if (!setupInstalled) {
     console.log(`  ${formatCofounderCommand(["setup", "codex", "--install"])}`);
-    console.log(`  ${formatCofounderCommand(["team"])}`);
-    console.log(`  ${formatCofounderCommand(["delegate", "backend", "inspect this repo and summarize the API boundaries"])}`);
   }
+  console.log("  codex");
+  console.log("");
+  console.log("Then ask Codex:");
+  console.log('  "Use the Cofounder team. Show me who is available."');
+  console.log('  "Ask backend to inspect this repo and summarize the implementation boundaries."');
+  console.log('  "Help me add or adjust a Cofounder teammate for this project."');
 }
 
 function parseArgs(args) {
@@ -122,6 +137,36 @@ function formatCofounderCommand(args) {
   return ["npx", ...resolveNpxCofounderArgs(args)].map(quoteShellArg).join(" ");
 }
 
+async function hasGitHead() {
+  return commandSucceeds("git", ["rev-parse", "--verify", "HEAD"]);
+}
+
+async function commandSucceeds(bin, args) {
+  return new Promise((resolve) => {
+    const child = spawn(bin, args, {
+      cwd: process.cwd(),
+      env: process.env,
+      stdio: "ignore"
+    });
+    child.on("error", () => resolve(false));
+    child.on("close", (code) => resolve(code === 0));
+  });
+}
+
+function printWorktreePrerequisiteWarning() {
+  console.log("");
+  console.log("Warning:");
+  console.log("  worktree template needs a Git repository with at least one commit before delegation.");
+  console.log("  Worktrees are created from HEAD, so commit the baseline delegated agents should see.");
+  console.log("");
+  console.log("  For a scratch test:");
+  console.log("    git init");
+  console.log("    git add .");
+  console.log('    git commit -m "chore: initial commit"');
+  console.log("");
+  console.log('  Or use direct mode by setting mode = "direct" under [write] in .cofounder/members/backend/settings.toml.');
+}
+
 function quoteShellArg(value) {
   if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(value)) {
     return value;

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "create-cofounder",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Initializer for Cofounder Crew projects",
+  "homepage": "https://github.com/eugeneyvt/cofounder-crew#readme",
+  "bugs": {
+    "url": "https://github.com/eugeneyvt/cofounder-crew/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eugeneyvt/cofounder-crew.git",
+    "directory": "packages/create-cofounder"
+  },
   "type": "module",
   "bin": {
     "create-cofounder": "index.js"