claude-flow-novice 1.5.6 → 1.5.7

package/.claude-flow-novice/.claude/agents/CLAUDE.md

@@ -114,6 +114,28 @@ Priming Effect:
 
 ### Frontmatter (YAML)
 
+#### Required Frontmatter Fields
+
+- **name**: Lowercase with hyphens (e.g., `system-architect`, `api-developer`)
+- **description**: Clear, keyword-rich description (supports multiline with `|`)
+- **tools**: Comma-separated list of tool names (e.g., `Read, Write, Edit, Bash, Grep, Glob`)
+  - ⚠️ **IMPORTANT**: Use comma-separated format, NOT YAML array format
+  - ✅ **CORRECT**: `tools: Read, Write, Edit, Bash`
+  - ❌ **WRONG**: `tools:` followed by `- Read` on new lines
+- **model**: AI model to use (`sonnet`, `opus`, or `haiku`)
+- **color**: Visual identifier for the agent (e.g., `seagreen`, `royalblue`)
+
+#### Optional Frontmatter Fields
+
+- **type**: Agent classification (`specialist`, `coordinator`, `swarm`)
+- **capabilities**: YAML array of capability tags
+- **lifecycle**: Hooks for agent lifecycle events
+- **hooks**: Integration points with Claude Flow system
+- **triggers**: Automatic activation patterns (YAML array)
+- **constraints**: Limitations and boundaries (YAML array)
+
+#### Complete Frontmatter Example
+
 ```yaml
 ---
 name: agent-name                    # REQUIRED: Lowercase with hyphens
@@ -122,12 +144,7 @@ description: |                      # REQUIRED: Clear, keyword-rich description
   Use PROACTIVELY for [specific scenarios].
   ALWAYS delegate when user asks [trigger phrases].
   Keywords - [comma-separated keywords for search]
-tools:                              # REQUIRED: Array of tool names
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - TodoWrite
+tools: Read, Write, Edit, Bash, TodoWrite  # REQUIRED: Comma-separated list of tool names
 model: sonnet                       # REQUIRED: sonnet | opus | haiku
 color: seagreen                     # REQUIRED: Visual identifier
 type: specialist                    # OPTIONAL: specialist | coordinator | swarm
@@ -212,7 +229,7 @@ npx claude-flow@alpha hooks post-edit [FILE_PATH] --memory-key "agent/step" --st
 ---
 name: system-architect
 description: Expert in designing scalable systems
-tools: [Read, Write, Edit, Bash, TodoWrite]
+tools: Read, Write, Edit, Bash, TodoWrite
 model: sonnet
 color: seagreen
 ---
@@ -281,7 +298,7 @@ You are a senior system architect specializing in [domain]. You excel at [key st
 ---
 name: backend-api-dev
 description: Backend API development specialist
-tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+tools: Read, Write, Edit, Bash, Grep, Glob, TodoWrite
 model: sonnet
 color: royalblue
 ---
@@ -419,7 +436,7 @@ Test Pyramid:
 ---
 name: rust-coder-basic
 description: Rust implementation specialist for basic tasks
-tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+tools: Read, Write, Edit, Bash, Grep, Glob, TodoWrite
 model: sonnet
 color: mediumblue
 ---
@@ -839,7 +856,7 @@ Apply same principles but validate with testing:
 ---
 name: code-reviewer
 description: Expert code reviewer focusing on quality and maintainability
-tools: [Read, Grep, Bash]
+tools: Read, Grep, Bash
 model: sonnet
 color: orange
 ---
@@ -902,7 +919,7 @@ You are an experienced code reviewer who identifies issues and suggests improvem
 ---
 name: system-architect
 description: Senior system architect for scalable software design
-tools: [Read, Write, Edit, Bash, TodoWrite]
+tools: Read, Write, Edit, Bash, TodoWrite
 model: sonnet
 color: seagreen
 ---
@@ -956,7 +973,7 @@ You are a senior system architect specializing in [domain].
 ---
 name: unit-tester
 description: Comprehensive unit test specialist
-tools: [Read, Write, Edit, Bash, Grep, TodoWrite]
+tools: Read, Write, Edit, Bash, Grep, TodoWrite
 model: sonnet
 color: mediumvioletred
 ---
@@ -1052,7 +1069,7 @@ Test Categories:
 ---
 name: tech-researcher
 description: Technology research and analysis specialist
-tools: [Read, WebSearch, Bash, TodoWrite]
+tools: Read, WebSearch, Bash, TodoWrite
 model: sonnet
 color: steelblue
 ---
@@ -1103,7 +1120,7 @@ You conduct thorough research to inform technical decisions.
 ---
 name: cicd-engineer
 description: CI/CD pipeline specialist
-tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+tools: Read, Write, Edit, Bash, Grep, Glob, TodoWrite
 model: sonnet
 color: darkkhaki
 ---
@@ -1566,7 +1583,7 @@ description: |
   Use PROACTIVELY for distributed systems, event-driven architecture,
   microservices decomposition, scalability planning.
   Keywords - architecture, system design, microservices, scalability
-tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+tools: Read, Write, Edit, Bash, Grep, Glob, TodoWrite
 model: sonnet
 color: seagreen
 ---
@@ -1636,7 +1653,7 @@ description: |
   Backend API development specialist for RESTful and GraphQL APIs.
   Use for endpoint implementation, data modeling, API documentation.
   Keywords - API, REST, GraphQL, backend, endpoints
-tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+tools: Read, Write, Edit, Bash, Grep, Glob, TodoWrite
 model: sonnet
 color: royalblue
 ---
@@ -1786,7 +1803,7 @@ description: |
   Rust implementation specialist for basic string processing,
   error handling, and CRUD operations.
   Keywords - rust, basic tasks, string processing, error handling
-tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+tools: Read, Write, Edit, Bash, Grep, Glob, TodoWrite
 model: sonnet
 color: mediumblue
 ---

package/.claude-flow-novice/.claude/agents/validate-agent.js

@@ -357,6 +357,12 @@ function validateFrontmatter(frontmatter) {
   }
 
   // Tools validation
+  // NOTE: Tools can be specified as comma-separated string OR YAML array
+  // Examples:
+  //   tools: Read, Write, Edit          # Comma-separated string
+  //   tools:                             # YAML array
+  //     - Read
+  //     - Write
   if (!frontmatter.tools) {
     warnings.push({
       severity: 'warning',
@@ -365,9 +371,24 @@ function validateFrontmatter(frontmatter) {
       fix: 'Add "tools: Read, Write, Edit, ..." to frontmatter'
     });
   } else {
-    const tools = typeof frontmatter.tools === 'string'
-      ? frontmatter.tools.split(',').map(t => t.trim())
-      : frontmatter.tools;
+    // Parse tools: handle both comma-separated strings and YAML arrays
+    let tools;
+    if (typeof frontmatter.tools === 'string') {
+      // Comma-separated format: "Read, Write, Edit"
+      tools = frontmatter.tools.split(',').map(t => t.trim());
+    } else if (Array.isArray(frontmatter.tools)) {
+      // YAML array format: ["Read", "Write", "Edit"]
+      tools = frontmatter.tools;
+    } else {
+      // Invalid format
+      issues.push({
+        severity: 'error',
+        field: 'tools',
+        message: 'Tools must be comma-separated string or YAML array',
+        fix: 'Use "tools: Read, Write, Edit" or YAML array format'
+      });
+      tools = [];
+    }
 
     const invalidTools = tools.filter(tool => !APPROVED_TOOLS.includes(tool));
     if (invalidTools.length > 0) {