@kontourai/flow-agents 0.1.1

package/agents/tool-explore-deps.json

@@ -0,0 +1,92 @@
+{
+  "allowedTools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "code",
+    "ls"
+  ],
+  "hooks": {
+    "agentSpawn": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh agentSpawn tool-explore-deps",
+        "timeout_ms": 5000
+      }
+    ],
+    "postToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh postToolUse tool-explore-deps",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:edit:accumulator post-edit-accumulator.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:quality-gate quality-gate.js strict",
+        "matcher": "fs_write",
+        "timeout_ms": 15000
+      }
+    ],
+    "preToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh preToolUse tool-explore-deps",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:config-protection config-protection.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:commit-quality pre-commit-quality.js standard,strict",
+        "matcher": "execute_bash",
+        "timeout_ms": 30000
+      }
+    ],
+    "stop": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh stop tool-explore-deps",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js stop:format-typecheck stop-format-typecheck.js standard,strict",
+        "timeout_ms": 300000
+      }
+    ],
+    "userPromptSubmit": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh userPromptSubmit tool-explore-deps",
+        "timeout_ms": 5000
+      }
+    ]
+  },
+  "resources": [
+    "file://AGENTS.md",
+    "file://.kiro/steering/**/*.md",
+    "file://~/.kiro/steering/**/*.md",
+    "file://~/.flow-agents/context/common/subagents.md",
+    "file://~/.flow-agents/context/*.md"
+  ],
+  "tools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "code",
+    "ls"
+  ],
+  "toolsSettings": {
+    "write": {
+      "allowedPaths": []
+    }
+  },
+  "name": "tool-explore-deps",
+  "description": "Delegate to me for Dependency analysis - parses package manifests to identify tech stack and dependencies",
+  "prompt": "You are a Dependency Analyzer. Your ONLY job is to identify the tech stack and dependencies of a codebase.\n\n## Task\n1. Find dependency manifests: package.json, requirements.txt, go.mod, Cargo.toml, pom.xml, build.gradle, Gemfile, etc.\n2. Identify primary language(s) and runtime\n3. List key frameworks and libraries\n4. Note dev dependencies and build tools\n5. Flag any outdated or concerning dependencies if obvious\n\n## Output Format\n```\n## Tech Stack\n- **Language(s)**: [primary languages]\n- **Runtime**: [node, python, go, etc.]\n- **Framework**: [express, django, gin, etc.]\n\n## Key Dependencies\n- [dep1] - [what it's for]\n- [dep2] - [what it's for]\n\n## Dev/Build Tools\n- [tool1], [tool2]\n\n## Concerns\n- [any red flags]\n```\n\nBe FAST. Only read manifest files.",
+  "model": "kimi-k2.5"
+}

package/agents/tool-explore-entry.json

@@ -0,0 +1,92 @@
+{
+  "allowedTools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "code",
+    "ls"
+  ],
+  "hooks": {
+    "agentSpawn": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh agentSpawn tool-explore-entry",
+        "timeout_ms": 5000
+      }
+    ],
+    "postToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh postToolUse tool-explore-entry",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:edit:accumulator post-edit-accumulator.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:quality-gate quality-gate.js strict",
+        "matcher": "fs_write",
+        "timeout_ms": 15000
+      }
+    ],
+    "preToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh preToolUse tool-explore-entry",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:config-protection config-protection.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:commit-quality pre-commit-quality.js standard,strict",
+        "matcher": "execute_bash",
+        "timeout_ms": 30000
+      }
+    ],
+    "stop": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh stop tool-explore-entry",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js stop:format-typecheck stop-format-typecheck.js standard,strict",
+        "timeout_ms": 300000
+      }
+    ],
+    "userPromptSubmit": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh userPromptSubmit tool-explore-entry",
+        "timeout_ms": 5000
+      }
+    ]
+  },
+  "resources": [
+    "file://AGENTS.md",
+    "file://.kiro/steering/**/*.md",
+    "file://~/.kiro/steering/**/*.md",
+    "file://~/.flow-agents/context/common/subagents.md",
+    "file://~/.flow-agents/context/*.md"
+  ],
+  "tools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "code",
+    "ls"
+  ],
+  "toolsSettings": {
+    "write": {
+      "allowedPaths": []
+    }
+  },
+  "name": "tool-explore-entry",
+  "description": "Delegate to me to find the Entry point of a project - locates main files, CLI commands, API routes, and exports",
+  "prompt": "You are an Entry Point Finder. Your ONLY job is to locate where code execution starts and what's exposed.\n\n## Task\n1. Find main/index files (main.py, index.ts, main.go, App.java, etc.)\n2. Identify CLI entry points (bin/, scripts, __main__.py)\n3. Locate API route definitions\n4. Find exported modules/packages\n5. Check package.json \"main\", \"bin\", \"exports\" fields\n\n## Output Format\n```\n## Main Entry Points\n- [file] - [what it does]\n\n## CLI Commands\n- [command] - [file] - [purpose]\n\n## API Routes\n- [file/folder] - [framework used]\n\n## Exports\n- [what this package exposes]\n```\n\nBe FAST. Scan for patterns, don't read entire files.",
+  "model": "kimi-k2.5"
+}

package/agents/tool-explore-patterns.json

@@ -0,0 +1,92 @@
+{
+  "allowedTools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "ls",
+    "code"
+  ],
+  "hooks": {
+    "agentSpawn": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh agentSpawn tool-explore-patterns",
+        "timeout_ms": 5000
+      }
+    ],
+    "postToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh postToolUse tool-explore-patterns",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:edit:accumulator post-edit-accumulator.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:quality-gate quality-gate.js strict",
+        "matcher": "fs_write",
+        "timeout_ms": 15000
+      }
+    ],
+    "preToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh preToolUse tool-explore-patterns",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:config-protection config-protection.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:commit-quality pre-commit-quality.js standard,strict",
+        "matcher": "execute_bash",
+        "timeout_ms": 30000
+      }
+    ],
+    "stop": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh stop tool-explore-patterns",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js stop:format-typecheck stop-format-typecheck.js standard,strict",
+        "timeout_ms": 300000
+      }
+    ],
+    "userPromptSubmit": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh userPromptSubmit tool-explore-patterns",
+        "timeout_ms": 5000
+      }
+    ]
+  },
+  "resources": [
+    "file://AGENTS.md",
+    "file://.kiro/steering/**/*.md",
+    "file://~/.kiro/steering/**/*.md",
+    "file://~/.flow-agents/context/common/subagents.md",
+    "file://~/.flow-agents/context/*.md"
+  ],
+  "tools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "ls",
+    "code"
+  ],
+  "toolsSettings": {
+    "write": {
+      "allowedPaths": []
+    }
+  },
+  "name": "tool-explore-patterns",
+  "description": "Delegate to me for Pattern detection - identifies architectural patterns, frameworks, and coding conventions",
+  "prompt": "You are a Pattern Detective. Your ONLY job is to identify architectural patterns and conventions in a codebase.\n\n## Task\n1. Identify architecture style (MVC, microservices, monolith, serverless, etc.)\n2. Spot framework conventions (Rails, Django, Express, Spring patterns)\n3. Note coding conventions (naming, file organization)\n4. Identify design patterns in use (factory, singleton, repository, etc.)\n5. Check for DI/IoC containers\n\n## Output Format\n```\n## Architecture\n- **Style**: [monolith/microservices/serverless/etc.]\n- **Pattern**: [MVC/Clean Architecture/Hexagonal/etc.]\n\n## Framework Conventions\n- [framework] patterns detected: [specifics]\n\n## Coding Conventions\n- Naming: [camelCase/snake_case/etc.]\n- Organization: [by feature/by layer/etc.]\n\n## Design Patterns\n- [pattern] - [where used]\n```\n\nBe FAST. Sample a few files to detect patterns.",
+  "model": "kimi-k2.5"
+}

package/agents/tool-explore-structure.json

@@ -0,0 +1,92 @@
+{
+  "allowedTools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "code",
+    "ls"
+  ],
+  "hooks": {
+    "agentSpawn": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh agentSpawn tool-explore-structure",
+        "timeout_ms": 5000
+      }
+    ],
+    "postToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh postToolUse tool-explore-structure",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:edit:accumulator post-edit-accumulator.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:quality-gate quality-gate.js strict",
+        "matcher": "fs_write",
+        "timeout_ms": 15000
+      }
+    ],
+    "preToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh preToolUse tool-explore-structure",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:config-protection config-protection.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:commit-quality pre-commit-quality.js standard,strict",
+        "matcher": "execute_bash",
+        "timeout_ms": 30000
+      }
+    ],
+    "stop": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh stop tool-explore-structure",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js stop:format-typecheck stop-format-typecheck.js standard,strict",
+        "timeout_ms": 300000
+      }
+    ],
+    "userPromptSubmit": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh userPromptSubmit tool-explore-structure",
+        "timeout_ms": 5000
+      }
+    ]
+  },
+  "resources": [
+    "file://AGENTS.md",
+    "file://.kiro/steering/**/*.md",
+    "file://~/.kiro/steering/**/*.md",
+    "file://~/.flow-agents/context/common/subagents.md",
+    "file://~/.flow-agents/context/*.md"
+  ],
+  "tools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "code",
+    "ls"
+  ],
+  "toolsSettings": {
+    "write": {
+      "allowedPaths": []
+    }
+  },
+  "name": "tool-explore-structure",
+  "description": "Delegate to me to scout out the project structure - maps directory layout and identifies key folders in a codebase",
+  "prompt": "You are a Structure Scout. Your ONLY job is to quickly map the directory structure of a codebase.\n\n## Task\n1. Use glob/ls to list top-level directories\n2. Identify purpose of each key folder (src, lib, tests, docs, config, etc.)\n3. Note any unusual or project-specific directories\n4. Estimate codebase size (small/medium/large)\n\n## Output Format\n```\n## Directory Structure\n- /src - [purpose]\n- /tests - [purpose]\n- ...\n\n## Notable Patterns\n- [any unusual structure or conventions]\n\n## Size Estimate\n[small/medium/large] - [file count estimate]\n```\n\nBe FAST. Don't read file contents - just map structure.",
+  "model": "kimi-k2.5"
+}

package/agents/tool-explore-tests.json

@@ -0,0 +1,92 @@
+{
+  "allowedTools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "code",
+    "ls"
+  ],
+  "hooks": {
+    "agentSpawn": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh agentSpawn tool-explore-tests",
+        "timeout_ms": 5000
+      }
+    ],
+    "postToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh postToolUse tool-explore-tests",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:edit:accumulator post-edit-accumulator.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:quality-gate quality-gate.js strict",
+        "matcher": "fs_write",
+        "timeout_ms": 15000
+      }
+    ],
+    "preToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh preToolUse tool-explore-tests",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:config-protection config-protection.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:commit-quality pre-commit-quality.js standard,strict",
+        "matcher": "execute_bash",
+        "timeout_ms": 30000
+      }
+    ],
+    "stop": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh stop tool-explore-tests",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js stop:format-typecheck stop-format-typecheck.js standard,strict",
+        "timeout_ms": 300000
+      }
+    ],
+    "userPromptSubmit": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh userPromptSubmit tool-explore-tests",
+        "timeout_ms": 5000
+      }
+    ]
+  },
+  "resources": [
+    "file://AGENTS.md",
+    "file://.kiro/steering/**/*.md",
+    "file://~/.kiro/steering/**/*.md",
+    "file://~/.flow-agents/context/common/subagents.md",
+    "file://~/.flow-agents/context/*.md"
+  ],
+  "tools": [
+    "read",
+    "imageRead",
+    "glob",
+    "grep",
+    "code",
+    "ls"
+  ],
+  "toolsSettings": {
+    "write": {
+      "allowedPaths": []
+    }
+  },
+  "name": "tool-explore-tests",
+  "description": "Delegate to me to find and understand testing strategies - locates test files and understands testing strategy",
+  "prompt": "You are a Test Mapper. Your ONLY job is to understand the testing strategy of a codebase.\n\n## Task\n1. Find test directories and files (*test*, *spec*, __tests__, tests/)\n2. Identify testing frameworks (jest, pytest, go test, junit, etc.)\n3. Note test types present (unit, integration, e2e)\n4. Check for test utilities, mocks, fixtures\n5. Look for coverage configuration\n\n## Output Format\n```\n## Test Location\n- [folder/pattern] - [type of tests]\n\n## Testing Framework\n- [framework] - [config file if any]\n\n## Test Types\n- Unit: [yes/no] - [location]\n- Integration: [yes/no] - [location]\n- E2E: [yes/no] - [location]\n\n## Test Utilities\n- Mocks: [location]\n- Fixtures: [location]\n\n## Coverage\n- [configured/not configured] - [tool]\n```\n\nBe FAST. Map test structure, don't analyze test quality.",
+  "model": "kimi-k2.5"
+}

package/agents/tool-planner.json

@@ -0,0 +1,57 @@
+{
+  "allowedTools" : [ "read", "imageRead", "glob", "grep", "ls", "code", "write" ],
+  "hooks" : {
+    "agentSpawn" : [ {
+      "command" : "bash ~/.flow-agents/scripts/telemetry/telemetry.sh agentSpawn tool-planner",
+      "timeout_ms" : 5000
+    } ],
+    "postToolUse" : [ {
+      "command" : "bash ~/.flow-agents/scripts/telemetry/telemetry.sh postToolUse tool-planner",
+      "matcher" : "*",
+      "timeout_ms" : 3000
+    }, {
+      "command" : "node ~/.flow-agents/scripts/hooks/run-hook.js post:edit:accumulator post-edit-accumulator.js standard,strict",
+      "matcher" : "fs_write",
+      "timeout_ms" : 5000
+    }, {
+      "command" : "node ~/.flow-agents/scripts/hooks/run-hook.js post:quality-gate quality-gate.js strict",
+      "matcher" : "fs_write",
+      "timeout_ms" : 15000
+    } ],
+    "preToolUse" : [ {
+      "command" : "bash ~/.flow-agents/scripts/telemetry/telemetry.sh preToolUse tool-planner",
+      "matcher" : "*",
+      "timeout_ms" : 3000
+    }, {
+      "command" : "node ~/.flow-agents/scripts/hooks/run-hook.js pre:config-protection config-protection.js standard,strict",
+      "matcher" : "fs_write",
+      "timeout_ms" : 5000
+    }, {
+      "command" : "node ~/.flow-agents/scripts/hooks/run-hook.js pre:commit-quality pre-commit-quality.js standard,strict",
+      "matcher" : "execute_bash",
+      "timeout_ms" : 30000
+    } ],
+    "stop" : [ {
+      "command" : "bash ~/.flow-agents/scripts/telemetry/telemetry.sh stop tool-planner",
+      "timeout_ms" : 5000
+    }, {
+      "command" : "node ~/.flow-agents/scripts/hooks/run-hook.js stop:format-typecheck stop-format-typecheck.js standard,strict",
+      "timeout_ms" : 300000
+    } ],
+    "userPromptSubmit" : [ {
+      "command" : "bash ~/.flow-agents/scripts/telemetry/telemetry.sh userPromptSubmit tool-planner",
+      "timeout_ms" : 5000
+    } ]
+  },
+  "resources" : [ "file://AGENTS.md", "file://docs/context-map.md", "file://.kiro/steering/**/*.md", "file://~/.kiro/steering/**/*.md", "file://~/.flow-agents/context/*.md", "file://~/.flow-agents/context/contracts/*.md", "file://~/.flow-agents/schemas/*.json" ],
+  "tools" : [ "read", "imageRead", "glob", "grep", "ls", "code", "write" ],
+  "toolsSettings" : {
+    "write" : {
+      "allowedPaths" : [ ".flow-agents/**/*" ]
+    }
+  },
+  "name" : "tool-planner",
+  "description" : "Delegate to me for codebase analysis and execution planning. Explores code, identifies patterns and dependencies, and writes plan/sidecar artifacts under .flow-agents. No production file modifications.",
+  "prompt" : "You are a codebase analyst. You explore code and produce structured execution plans.\n\n## Shared Contracts\nFollow `context/contracts/artifact-contract.md` and `context/contracts/planning-contract.md`. Those contracts are the source of truth for plan artifact format, Definition Of Done, evidence-bearing acceptance criteria, stop-short risks, structured sidecars, and parallel wave rules.\n\n## Flow Kit Boundary\nFlow owns Flow Definition gate semantics, typed `expects`, `kind: \"surface.claim\"`, trusted producer config, and gate overrides. Flow Agents coordinates Flow Kit installation, runtime adapters, local control, and workflow artifacts. For Builder Kit work, use Kit Catalog, Flow Kit, Builder Kit, Probe, and `design-probe` vocabulary.\n\n## Important: Explore First, Then Plan\nYou have full read-only access to the codebase. If `docs/context-map.md` exists, read it before broad exploration so you can use the known repo shape, commands, schemas, skills, agents, Flow Kits, and Kit Catalog instead of rediscovering everything. If the orchestrator's request lacks specifics (for example no target directory or implementation details), use your tools to explore and fill in the gaps. Only push back if the goal itself is genuinely unclear.\n\n## Input\nYou receive:\n- A goal description, and optionally a target directory and constraints\n- A todo_file path for the orchestrator's session artifact\n\n## Process\n1. Read `docs/context-map.md` when it exists, then explore the codebase structure, patterns, dependencies, and constraints needed for the task.\n2. Identify existing code to reuse.\n3. Produce a plan artifact beside the todo_file, using the artifact path rules from `context/contracts/artifact-contract.md`.\n4. Create or update `state.json`, `acceptance.json`, and `handoff.json` beside the workflow artifact using the schemas under `schemas/`.\n5. Decompose work into parallel waves using `context/contracts/planning-contract.md`.\n6. Return the plan content and sidecar paths in your response so the orchestrator can read them directly.\n\n## Rules\n- Do not write production code.\n- Every task needs concrete acceptance criteria and evidence expectations.\n- The Definition Of Done must describe the user-facing finish line, not just implementation tasks.\n- `acceptance.json` must preserve the Definition Of Done criteria as pending criteria until verification updates them.\n- `state.json` must name the current phase/status and next action.\n- `handoff.json` must give the next agent or future session enough context to continue.\n- Include enough context per task that a worker can execute without rediscovering the whole codebase.",
+  "model" : "claude-sonnet-4.6-1m"
+}

package/agents/tool-playwright.json

@@ -0,0 +1,145 @@
+{
+  "allowedTools": [
+    "read",
+    "imageRead",
+    "@playwright/browser_close",
+    "@playwright/browser_resize",
+    "@playwright/browser_console_messages",
+    "@playwright/browser_handle_dialog",
+    "@playwright/browser_evaluate",
+    "@playwright/browser_file_upload",
+    "@playwright/browser_fill_form",
+    "@playwright/browser_install",
+    "@playwright/browser_press_key",
+    "@playwright/browser_type",
+    "@playwright/browser_navigate",
+    "@playwright/browser_navigate_back",
+    "@playwright/browser_network_requests",
+    "@playwright/browser_run_code",
+    "@playwright/browser_take_screenshot",
+    "@playwright/browser_snapshot",
+    "@playwright/browser_click",
+    "@playwright/browser_drag",
+    "@playwright/browser_hover",
+    "@playwright/browser_select_option",
+    "@playwright/browser_tabs",
+    "@playwright/browser_wait_for",
+    "ls"
+  ],
+  "hooks": {
+    "agentSpawn": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh agentSpawn tool-playwright",
+        "timeout_ms": 5000
+      }
+    ],
+    "postToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh postToolUse tool-playwright",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:edit:accumulator post-edit-accumulator.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js post:quality-gate quality-gate.js strict",
+        "matcher": "fs_write",
+        "timeout_ms": 15000
+      }
+    ],
+    "preToolUse": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh preToolUse tool-playwright",
+        "matcher": "*",
+        "timeout_ms": 3000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:config-protection config-protection.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:commit-quality pre-commit-quality.js standard,strict",
+        "matcher": "execute_bash",
+        "timeout_ms": 30000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js pre:report-only-guard report-only-guard.js standard,strict",
+        "matcher": "fs_write",
+        "timeout_ms": 3000
+      }
+    ],
+    "stop": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh stop tool-playwright",
+        "timeout_ms": 5000
+      },
+      {
+        "command": "node ~/.flow-agents/scripts/hooks/run-hook.js stop:format-typecheck stop-format-typecheck.js standard,strict",
+        "timeout_ms": 300000
+      }
+    ],
+    "userPromptSubmit": [
+      {
+        "command": "bash ~/.flow-agents/scripts/telemetry/telemetry.sh userPromptSubmit tool-playwright",
+        "timeout_ms": 5000
+      }
+    ]
+  },
+  "mcpServers": {
+    "playwright": {
+      "args": [
+        "@playwright/mcp@latest",
+        "--headless",
+        "--isolated"
+      ],
+      "command": "npx"
+    }
+  },
+  "resources": [
+    "file://AGENTS.md",
+    "file://.kiro/steering/**/*.md",
+    "file://~/.kiro/steering/**/*.md",
+    "file://~/.flow-agents/context/common/subagents.md",
+    "file://~/.flow-agents/context/*.md"
+  ],
+  "tools": [
+    "read",
+    "imageRead",
+    "@playwright/browser_close",
+    "@playwright/browser_resize",
+    "@playwright/browser_console_messages",
+    "@playwright/browser_handle_dialog",
+    "@playwright/browser_evaluate",
+    "@playwright/browser_file_upload",
+    "@playwright/browser_fill_form",
+    "@playwright/browser_install",
+    "@playwright/browser_press_key",
+    "@playwright/browser_type",
+    "@playwright/browser_navigate",
+    "@playwright/browser_navigate_back",
+    "@playwright/browser_network_requests",
+    "@playwright/browser_run_code",
+    "@playwright/browser_take_screenshot",
+    "@playwright/browser_snapshot",
+    "@playwright/browser_click",
+    "@playwright/browser_drag",
+    "@playwright/browser_hover",
+    "@playwright/browser_select_option",
+    "@playwright/browser_tabs",
+    "@playwright/browser_wait_for",
+    "ls"
+  ],
+  "toolsSettings": {
+    "write": {
+      "allowedPaths": []
+    }
+  },
+  "name": "tool-playwright",
+  "description": "Delegate to me for browser automation, testing, and debugging - loading real pages, testing navigation, checking accessibility via structured snapshots, evaluating scripts, and visual verification. Anything that would otherwise require a browser. Do NOT use for general web search or fetching content",
+  "prompt": "You interact with a browser through Playwright for real browser testing and frontend debugging.\n\n## When to Use Me\n- Loading and navigating real web pages\n- Testing frontend accessibility via structured accessibility snapshots (ARIA, tab order, roles)\n- Evaluating JavaScript in a live browser context\n- Taking screenshots for visual verification\n- Inspecting page content, forms, and interactive elements\n- Filling forms, clicking buttons, and testing user flows\n- Generating and validating Playwright test code\n\n## NOT For\n- General web search or fetching page content for research \u2014 decline and suggest a research/web agent instead\n- Scraping data from websites\n\n## Screenshot Verification\nWhen you take a screenshot with `browser_screenshot`, ALWAYS read the saved image file back using the `Read` tool to visually confirm what the page actually looks like. Don't just take the screenshot and assume it worked \u2014 look at it. This catches rendering issues, unexpected states, and layout problems that accessibility snapshots miss.\n\n## Tips\n- Use accessibility snapshots (`browser_snapshot`) as the primary way to understand page structure \u2014 it's more token-efficient than screenshots\n- Use `browser_navigate` to load pages, then `browser_snapshot` to inspect\n- For interactions, prefer `browser_click`, `browser_type`, `browser_select_option` over raw JS evaluation\n- When visual verification matters, take a screenshot AND read it back to confirm\n- Close the browser when done",
+  "model": "claude-sonnet-4.6-1m"
+}