From 1ac9fd69f657b0f65b72edd34d42b2cc7257b0a8 Mon Sep 17 00:00:00 2001 From: dMiller Date: Mon, 24 Aug 2026 08:14:49 -0500 Subject: [PATCH] fix(agents): correct doc-updater description claiming command-invoking tools MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The doc-updater description said it 'Runs /update-codemaps and /update-docs', but its tools are Read, Write, Edit, Bash, Grep, Glob — no command-invoking tool exists in this repo, and no agent is granted one. The agent body already does the right thing (invokes generators directly); only the description was wrong. Agent descriptions drive selection, so a false capability claim can misroute work to this agent on the assumption it can run slash commands. docs/COMMAND-AGENT-MAP.md already records the true direction (/update-codemaps -> doc-updater), so the description now matches: the agent backs those commands rather than invoking them. Applied to the canonical agent file and the two active .kiro mirrors that carried the identical string. --- .kiro/agents/doc-updater.json | 2 +- .kiro/agents/doc-updater.md | 2 +- agents/doc-updater.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.kiro/agents/doc-updater.json b/.kiro/agents/doc-updater.json index 3aef9eeb1..e61e0d98c 100644 --- a/.kiro/agents/doc-updater.json +++ b/.kiro/agents/doc-updater.json @@ -1,6 +1,6 @@ { "name": "doc-updater", - "description": "Documentation and codemap specialist. Use PROACTIVELY for updating codemaps and documentation. Runs /update-codemaps and /update-docs, generates docs/CODEMAPS/*, updates READMEs and guides.", + "description": "Documentation and codemap specialist. Use PROACTIVELY for updating codemaps and documentation. Generates docs/CODEMAPS/*, updates READMEs and guides. Backs the /update-codemaps and /update-docs commands.", "mcpServers": {}, "tools": [ "@builtin" diff --git a/.kiro/agents/doc-updater.md b/.kiro/agents/doc-updater.md index 31b19e963..ea9baa6c6 100644 --- a/.kiro/agents/doc-updater.md +++ b/.kiro/agents/doc-updater.md @@ -1,6 +1,6 @@ --- name: doc-updater -description: Documentation and codemap specialist. Use PROACTIVELY for updating codemaps and documentation. Runs /update-codemaps and /update-docs, generates docs/CODEMAPS/*, updates READMEs and guides. +description: Documentation and codemap specialist. Use PROACTIVELY for updating codemaps and documentation. Generates docs/CODEMAPS/*, updates READMEs and guides. Backs the /update-codemaps and /update-docs commands. allowedTools: - read - write diff --git a/agents/doc-updater.md b/agents/doc-updater.md index 4fd5bd46e..5cc7dac99 100644 --- a/agents/doc-updater.md +++ b/agents/doc-updater.md @@ -1,6 +1,6 @@ --- name: doc-updater -description: Documentation and codemap specialist. Use PROACTIVELY for updating codemaps and documentation. Runs /update-codemaps and /update-docs, generates docs/CODEMAPS/*, updates READMEs and guides. +description: Documentation and codemap specialist. Use PROACTIVELY for updating codemaps and documentation. Generates docs/CODEMAPS/*, updates READMEs and guides. Backs the /update-codemaps and /update-docs commands. tools: Read, Write, Edit, Bash, Grep, Glob model: haiku ---