agent-eng 0.7.0 → 0.8.0

package/README.md

@@ -8,7 +8,7 @@ Scaffold a structured agentic engineering workflow into any project. Run one com
 npx agent-eng init
 ```
 
-This creates the following structure in your project:
+This creates the following structure in your project: 
 
 ```
 ├── CLAUDE.md                              # Project instructions for AI agents

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-eng",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Scaffold a structured agentic engineering workflow for AI-assisted development",
   "type": "module",
   "bin": {

package/src/index.js

@@ -18,7 +18,7 @@ Examples:
   agent-eng init --dir ./my-project --conventions java
 `;
 
-export function run(args) {
+export async function run(args) {
   const command = args[0];
 
   if (!command || command === "-h" || command === "--help") {
@@ -28,7 +28,7 @@ export function run(args) {
 
   if (command === "init") {
     const options = parseInitArgs(args.slice(1));
-    init(options);
+    await init(options);
     return;
   }
 

package/src/init.js

@@ -1,4 +1,5 @@
-import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { appendFileSync, cpSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { createInterface } from "node:readline";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -24,10 +25,19 @@ const STRUCTURE = [
   "tickets/example/001-example-ticket.md",
   "orchestration.yaml",
   "architecture.yaml",
-  "CLAUDE.md",
 ];
 
-export function init(options) {
+function prompt(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
+export async function init(options) {
   const target = resolve(options.dir);
   const created = [];
   const skipped = [];
@@ -46,6 +56,34 @@ export function init(options) {
     created.push(file);
   }
 
+  // Handle CLAUDE.md separately — prompt user if it already exists
+  const claudeDest = join(target, "CLAUDE.md");
+  const claudeSrc = join(TEMPLATES, "CLAUDE.md");
+
+  if (!existsSync(claudeDest) || options.force) {
+    mkdirSync(dirname(claudeDest), { recursive: true });
+    cpSync(claudeSrc, claudeDest);
+    created.push("CLAUDE.md");
+  } else {
+    console.log("");
+    console.log("CLAUDE.md already exists.");
+    console.log("  1) Skip — keep existing file");
+    console.log("  2) Append — add agent-eng content to the end");
+    console.log("  3) Replace — overwrite with agent-eng template");
+    const answer = await prompt("Choose [1/2/3] (default: 1): ");
+
+    if (answer === "2" || answer === "append") {
+      const content = readFileSync(claudeSrc, "utf8");
+      appendFileSync(claudeDest, "\n\n" + content);
+      created.push("CLAUDE.md (appended)");
+    } else if (answer === "3" || answer === "replace") {
+      cpSync(claudeSrc, claudeDest);
+      created.push("CLAUDE.md (replaced)");
+    } else {
+      skipped.push("CLAUDE.md");
+    }
+  }
+
   for (const convention of options.conventions) {
     const file = `conventions/${convention}.md`;
     const dest = join(target, file);

package/src/templates/orchestration.yaml

@@ -82,7 +82,7 @@ agents:
     outputs:
       - Updated CLAUDE.md
       - Extracted reference files
-    color: gray
+    color: blue
     docLink: /.claude/agents/custodian.md
 
 connections: