automatasaurus 0.1.14 → 0.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "automatasaurus",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Automated software development workflow powered by Claude Code",
   "type": "module",
   "bin": {

package/src/commands/init.js

@@ -1,7 +1,7 @@
 import { mkdir, cp, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { getTemplateDir, getProjectPaths, getVersion, SUBDIR_SYMLINK_DIRS, FILE_SYMLINK_DIRS } from '../lib/paths.js';
-import { symlinkDirectory, symlinkSubdirectories } from '../lib/symlinks.js';
+import { symlinkDirectory, symlinkSubdirectories, symlinkAgentFiles } from '../lib/symlinks.js';
 import { mergeBlockIntoFile } from '../lib/block-merge.js';
 import { mergeLayeredSettings, createLocalSettingsTemplate, mergeJsonFile } from '../lib/json-merge.js';
 import { readManifest, writeManifest, createManifest, updateManifest } from '../lib/manifest.js';
@@ -62,6 +62,21 @@ export async function init({ force = false } = {}) {
     }
   }
 
+  // Flat file symlinks for agents (enables Claude Code agent discovery)
+  {
+    const sourceDir = join(paths.automatasaurus, 'agents');
+    const targetDir = join(paths.claude, 'agents');
+    try {
+      const created = await symlinkAgentFiles(sourceDir, targetDir);
+      for (const file of created) {
+        allSymlinks.push(`agents/${file}`);
+        console.log(`  Linked agents/${file}`);
+      }
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error;
+    }
+  }
+
   // File-level symlinks (hooks, commands)
   for (const dir of FILE_SYMLINK_DIRS) {
     const sourceDir = join(paths.automatasaurus, dir);

package/src/commands/update.js

@@ -1,7 +1,7 @@
 import { mkdir, cp, readFile, rm, lstat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { getTemplateDir, getProjectPaths, getVersion, SUBDIR_SYMLINK_DIRS, FILE_SYMLINK_DIRS } from '../lib/paths.js';
-import { symlinkDirectory, symlinkSubdirectories } from '../lib/symlinks.js';
+import { symlinkDirectory, symlinkSubdirectories, symlinkAgentFiles } from '../lib/symlinks.js';
 import { mergeBlockIntoFile } from '../lib/block-merge.js';
 import { mergeLayeredSettings, createLocalSettingsTemplate, mergeJsonFile } from '../lib/json-merge.js';
 import { readManifest, writeManifest, updateManifest } from '../lib/manifest.js';
@@ -97,6 +97,21 @@ export async function update({ force = false } = {}) {
     }
   }
 
+  // Flat file symlinks for agents (enables Claude Code agent discovery)
+  {
+    const sourceDir = join(paths.automatasaurus, 'agents');
+    const targetDir = join(paths.claude, 'agents');
+    try {
+      const created = await symlinkAgentFiles(sourceDir, targetDir);
+      for (const file of created) {
+        allSymlinks.push(`agents/${file}`);
+      }
+      console.log(`  Updated agents/ flat files (${created.length} files)`);
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error;
+    }
+  }
+
   // File-level symlinks (hooks, commands)
   for (const dir of FILE_SYMLINK_DIRS) {
     const sourceDir = join(paths.automatasaurus, dir);

package/src/lib/symlinks.js

@@ -1,4 +1,4 @@
-import { symlink, unlink, readlink, mkdir, readdir, stat } from 'node:fs/promises';
+import { symlink, unlink, readlink, mkdir, readdir, stat, access } from 'node:fs/promises';
 import { join, dirname, relative } from 'node:path';
 
 /**
@@ -125,3 +125,43 @@ export async function symlinkSubdirectories(sourceDir, targetDir) {
 
   return created;
 }
+
+/**
+ * Create flat file symlinks for agent AGENT.md files.
+ * For each agent subdirectory containing AGENT.md, creates:
+ *   targetDir/{name}.md -> sourceDir/{name}/AGENT.md
+ *
+ * This enables Claude Code's flat-file agent discovery while
+ * preserving subdirectory symlinks for PROJECT.md support.
+ */
+export async function symlinkAgentFiles(sourceDir, targetDir) {
+  await mkdir(targetDir, { recursive: true });
+
+  const created = [];
+
+  try {
+    const entries = await readdir(sourceDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+
+      const agentMdPath = join(sourceDir, entry.name, 'AGENT.md');
+
+      try {
+        await access(agentMdPath);
+      } catch {
+        continue; // No AGENT.md in this subdirectory
+      }
+
+      const target = join(targetDir, `${entry.name}.md`);
+      await createSymlink(agentMdPath, target);
+      created.push(`${entry.name}.md`);
+    }
+  } catch (error) {
+    if (error.code !== 'ENOENT') {
+      throw error;
+    }
+  }
+
+  return created;
+}

package/template/CLAUDE.block.md

@@ -48,10 +48,10 @@ The following agents are available in `.claude/agents/`:
 | Agent | Role | Model | Review Status |
 |-------|------|-------|---------------|
 | `architect` | System design, ADRs, stuck-issue analysis, PR review | Opus | **Required** |
-| `evolver` | PROJECT.md generation, context synthesis | Sonnet | N/A |
-| `designer` | UI/UX specs, accessibility, design review | Sonnet | If UI changes |
-| `developer` | Implementation, PRs, addressing feedback | Sonnet | N/A |
-| `tester` | QA, Playwright, verification | Sonnet | **Required** |
+| `evolver` | PROJECT.md generation, context synthesis | Opus | N/A |
+| `designer` | UI/UX specs, accessibility, design review | Opus | If UI changes |
+| `developer` | Implementation, PRs, addressing feedback | Opus | N/A |
+| `tester` | QA, Playwright, verification | Opus | **Required** |
 
 **Note:** Commands handle orchestration. Agents are autonomous workers invoked by commands.
 
@@ -255,7 +255,7 @@ When the `/auto-work-issue` or `/auto-work-all` commands spawn agents, they:
 3. **Read the agent's report** after the Task returns
 4. **Include report summary** in the next agent's briefing
 
-Agents follow a **briefing protocol** defined in their AGENT.md files:
+Claude Code auto-loads each agent's system prompt from `.claude/agents/{name}.md` when spawned with matching `subagent_type`. Agents follow a **briefing protocol**:
 1. Read the briefing file first
 2. Do their work
 3. Write a report before completing

package/template/agents/architect/AGENT.md

@@ -3,12 +3,17 @@ name: architect
 description: Software Architect for system design, technical decisions, and code review. Use for reviewing discovery plans, reviewing PRs, or analyzing stuck issues. Required reviewer for all PRs.
 tools: Read, Edit, Write, Grep, Glob, Bash, WebSearch
 model: opus
+skills:
+  - code-review
 ---
 
 # Architect Agent
 
 You are a senior Software Architect responsible for technical vision and structural integrity of the codebase.
 
+## Project Context
+If `.claude/agents/architect/PROJECT.md` exists, read it before starting any task. It contains project-specific context, conventions, and guidance tailored to your role.
+
 ## Responsibilities
 
 1. **Discovery Review**: Review discovery plans for technical feasibility

package/template/agents/designer/AGENT.md

@@ -9,6 +9,9 @@ model: opus
 
 You are a UI/UX Designer responsible for creating intuitive, accessible, and visually coherent user experiences.
 
+## Project Context
+If `.claude/agents/designer/PROJECT.md` exists, read it before starting any task. It contains project-specific context, conventions, and guidance tailored to your role.
+
 ## Design Philosophy
 
 When creating or reviewing designs, apply these principles:

package/template/agents/developer/AGENT.md

@@ -3,12 +3,18 @@ name: developer
 description: Developer persona for implementing features, fixing bugs, and writing code. Use when writing code, implementing designs, fixing issues, or creating pull requests.
 tools: Read, Edit, Write, Bash, Grep, Glob
 model: opus
+skills:
+  - pr-writing
+permissionMode: acceptEdits
 ---
 
 # Developer Agent
 
 You are a Software Developer responsible for implementing features, fixing bugs, and maintaining code quality.
 
+## Project Context
+If `.claude/agents/developer/PROJECT.md` exists, read it before starting any task. It contains project-specific context, conventions, and guidance tailored to your role.
+
 ## First Steps
 
 Before writing code:

package/template/agents/evolver/AGENT.md

@@ -2,7 +2,7 @@
 name: evolver
 description: Generate project-specific context files for sub-agents after planning. Synthesizes discovery and implementation plan into tailored guidance for each agent.
 tools: Read, Write, Glob
-model: sonnet
+model: opus
 ---
 
 # Evolver Agent

package/template/agents/tester/AGENT.md

@@ -1,12 +1,18 @@
 ---
 name: tester
 description: QA/Tester agent that EXECUTES browser tests using Playwright MCP. Does not write test plans - actually navigates, clicks, and verifies using mcp__playwright__* tools. Unit tests alone are NOT sufficient. Escalates if app cannot run.
-tools: Read, Edit, Write, Bash, Grep, Glob, mcp__playwright__*
+tools: Read, Edit, Write, Bash, Grep, Glob
 model: opus
+mcpServers:
+  playwright: {}
+permissionMode: acceptEdits
 ---
 
 # Tester Agent
 
+## Project Context
+If `.claude/agents/tester/PROJECT.md` exists, read it before starting any task. It contains project-specific context, conventions, and guidance tailored to your role.
+
 ## Your Role: QA Engineer (Not a Developer)
 
 **You are a QA Engineer.** Your job is to TEST the software by actually using it - clicking buttons, filling forms, navigating pages, and verifying behavior.

package/template/commands/auto-discovery.md

@@ -223,16 +223,26 @@ After creating discovery.md, get feedback from specialist agents:
 
 ### Architect Review
 ```
-Use the architect agent to review this discovery plan for technical feasibility.
-Focus on: architecture fit, scalability, security implications, technology choices.
-The discovery plan is at: [path to discovery.md]
+Use the Task tool with:
+  subagent_type: "architect"
+  model: "opus"
+  description: "Architect review discovery plan"
+  prompt: |
+    Review this discovery plan for technical feasibility.
+    Focus on: architecture fit, scalability, security implications, technology choices.
+    The discovery plan is at: [path to discovery.md]
 ```
 
 ### Designer Review
 ```
-Use the designer agent to review this discovery plan for UI/UX considerations.
-Focus on: user flows, accessibility, responsive design, missing UI requirements.
-The discovery plan is at: [path to discovery.md]
+Use the Task tool with:
+  subagent_type: "designer"
+  model: "opus"
+  description: "Designer review discovery plan"
+  prompt: |
+    Review this discovery plan for UI/UX considerations.
+    Focus on: user flows, accessibility, responsive design, missing UI requirements.
+    The discovery plan is at: [path to discovery.md]
 ```
 
 Present the feedback to the user. Refine the discovery document based on feedback.

package/template/commands/auto-plan.md

@@ -82,14 +82,10 @@ Before implementation begins, spawn the Designer agent to establish the visual f
 
 ```
 Use the Task tool with:
-  subagent_type: "general-purpose"
-  model: "sonnet"
+  subagent_type: "designer"
+  model: "opus"
   description: "Create design language"
   prompt: |
-    You are the Designer agent. Load your role from .claude/agents/designer/AGENT.md
-
-    **[Designer]**
-
     Establish the design language and style guide for this project.
 
     1. Check for existing design documentation:

package/template/skills/agent-coordination/SKILL.md

@@ -216,9 +216,8 @@ Agent: {role}
    - PR created with "Closes #{number}"
 
 3. Use Task tool with:
+   subagent_type: "developer"
    prompt: |
-     You are the Developer agent. Load your role from .claude/agents/developer/AGENT.md
-
      Read orchestration/issues/{number}-{slug}/BRIEFING-implement.md first.
 
      After completing your work, write your report to:
@@ -254,9 +253,8 @@ Agent: {role}
    - OR ❌ CHANGES REQUESTED - Architect
 
 2. Use Task tool with:
+   subagent_type: "architect"
    prompt: |
-     You are the Architect agent. Load your role from .claude/agents/architect/AGENT.md
-
      Read orchestration/issues/{number}-{slug}/BRIEFING-architect-review.md first.
 
      After completing your review, write your report to:
@@ -286,9 +284,8 @@ Agent: {role}
    Post design specifications as issue comment following AGENT.md template.
 
 2. Use Task tool with:
+   subagent_type: "designer"
    prompt: |
-     You are the Designer agent. Load your role from .claude/agents/designer/AGENT.md
-
      Read orchestration/issues/{number}-{slug}/BRIEFING-design-specs.md first.
 
      After completing your specs, write your report to:
@@ -324,9 +321,8 @@ Agent: {role}
    - OR N/A - No UI changes
 
 2. Use Task tool with:
+   subagent_type: "designer"
    prompt: |
-     You are the Designer agent. Load your role from .claude/agents/designer/AGENT.md
-
      Read orchestration/issues/{number}-{slug}/BRIEFING-designer-review.md first.
 
      After completing your review, write your report to:
@@ -362,9 +358,8 @@ Agent: {role}
    - OR ❌ CHANGES REQUESTED - Tester
 
 2. Use Task tool with:
+   subagent_type: "tester"
    prompt: |
-     You are the Tester agent. Load your role from .claude/agents/tester/AGENT.md
-
      Read orchestration/issues/{number}-{slug}/BRIEFING-test.md first.
 
      After completing verification, write your report to:

package/template/skills/work-issue/SKILL.md

@@ -167,12 +167,10 @@ Post design specifications as an issue comment following your AGENT.md template,
 
 ```
 Use the Task tool with:
-  subagent_type: "general-purpose"
-  model: "sonnet"
+  subagent_type: "designer"
+  model: "opus"
   description: "Designer specs for issue #{ISSUE_NUMBER}"
   prompt: |
-    You are the Designer agent. Load your role from .claude/agents/designer/AGENT.md
-
     Read orchestration/issues/{ISSUE_NUMBER}-{slug}/BRIEFING-design-specs.md first.
 
     After completing your work, write your report to:
@@ -227,12 +225,10 @@ Implement issue #{ISSUE_NUMBER}: {title}
 
 ```
 Use the Task tool with:
-  subagent_type: "general-purpose"
-  model: "sonnet"
+  subagent_type: "developer"
+  model: "opus"
   description: "Implement issue #{ISSUE_NUMBER}"
   prompt: |
-    You are the Developer agent. Load your role from .claude/agents/developer/AGENT.md
-
     Read orchestration/issues/{ISSUE_NUMBER}-{slug}/BRIEFING-implement.md first.
 
     After completing your work, write your report to:
@@ -345,12 +341,10 @@ Spawn all reviewers in parallel (single message, multiple Task calls):
 ```
 # Architect review
 Use the Task tool with:
-  subagent_type: "general-purpose"
-  model: "sonnet"
+  subagent_type: "architect"
+  model: "opus"
   description: "Architect review PR #{pr_number}"
   prompt: |
-    You are the Architect agent. Load your role from .claude/agents/architect/AGENT.md
-
     Read orchestration/issues/{ISSUE_NUMBER}-{slug}/BRIEFING-architect-review.md first.
 
     After completing your review, write your report to:
@@ -358,12 +352,10 @@ Use the Task tool with:
 
 # Designer review (if UI)
 Use the Task tool with:
-  subagent_type: "general-purpose"
-  model: "sonnet"
+  subagent_type: "designer"
+  model: "opus"
   description: "Designer review PR #{pr_number}"
   prompt: |
-    You are the Designer agent. Load your role from .claude/agents/designer/AGENT.md
-
     Read orchestration/issues/{ISSUE_NUMBER}-{slug}/BRIEFING-designer-review.md first.
 
     After completing your review, write your report to:
@@ -371,12 +363,10 @@ Use the Task tool with:
 
 # Tester verification
 Use the Task tool with:
-  subagent_type: "general-purpose"
-  model: "sonnet"
+  subagent_type: "tester"
+  model: "opus"
   description: "Tester verify PR #{pr_number}"
   prompt: |
-    You are the Tester agent. Load your role from .claude/agents/tester/AGENT.md
-
     Read orchestration/issues/{ISSUE_NUMBER}-{slug}/BRIEFING-test.md first.
 
     After completing verification, write your report to:
@@ -437,12 +427,10 @@ Address review feedback on PR #{pr_number}.
 
 ```
 Use the Task tool with:
-  subagent_type: "general-purpose"
-  model: "sonnet"
+  subagent_type: "developer"
+  model: "opus"
   description: "Address feedback PR #{pr_number}"
   prompt: |
-    You are the Developer agent. Load your role from .claude/agents/developer/AGENT.md
-
     Read orchestration/issues/{ISSUE_NUMBER}-{slug}/BRIEFING-address-feedback.md first.
 
     After completing fixes, write your report to: