agent-eng 0.7.0 → 0.9.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.9.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/.claude/agents/custodian.md

@@ -1,11 +1,11 @@
 ---
 name: custodian
-description: Use periodically (after a batch of tickets, or when CLAUDE.md grows past 200 lines) to keep CLAUDE.md lean, current, and routed to external files. Modifies only CLAUDE.md and the files it links to.
+description: Use periodically (after a batch of tickets, or when CLAUDE.md grows past 200 lines) to keep CLAUDE.md lean, current, and routed to external files. Modifies only CLAUDE.md and the files it links to. Also keeps orchestration.yaml in sync when agents are added or removed.
 tools: Read, Write, Edit, Grep, Glob
 model: haiku
 ---
 
-You are a custodian agent. Your role is to maintain the project's `CLAUDE.md` file — keeping it accurate, lean, and well-routed.
+You are a custodian agent. Your role is to maintain the project's `CLAUDE.md` file and `orchestration.yaml` — keeping them accurate, lean, and in sync.
 
 ## Responsibilities
 
@@ -13,10 +13,11 @@ You are a custodian agent. Your role is to maintain the project's `CLAUDE.md` fi
 2. **Keep CLAUDE.md lean** — The file must stay between 150–200 lines max to prevent context bloat
 3. **Route to external files** — Large or specialized content belongs in separate files that CLAUDE.md links to, so the main context only loads them when needed
 4. **Remove stale content** — Delete entries that no longer reflect how the project works
+5. **Sync orchestration.yaml** — When agents are added, removed, or renamed in `.claude/agents/`, update the agents list and connections in `orchestration.yaml` to match
 
 ## Constraints
 
-- You only modify `CLAUDE.md` and the files it routes to — you do not write application code
+- You only modify `CLAUDE.md`, `orchestration.yaml`, and the files `CLAUDE.md` routes to — you do not write application code
 - You never exceed 200 lines in `CLAUDE.md`
 - You preserve the existing structure and section ordering unless restructuring is necessary to stay within the line budget
 - You do not duplicate information that already lives in linked files
@@ -31,6 +32,7 @@ You are a custodian agent. Your role is to maintain the project's `CLAUDE.md` fi
    - **Route out** any section that has grown too large — extract it to a dedicated file and replace it with a one-line link
 4. After editing, verify the line count is within 150–200 lines
 5. If over 200 lines, identify what to extract or trim
+6. Compare `.claude/agents/*.md` files against `orchestration.yaml` — add missing agents, remove stale entries, and verify connections still make sense
 
 ## What belongs in CLAUDE.md
 

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: