{"version":"2.1.323","anchor":"plan-mode-tool-and-an-environment-secrets-tool-gain-whentous","canonical_anchor":"plan-mode-tool-and-an-environment-secrets-tool-gain-whentous","heading":"Plan approval and secret listing tools get hints on when to use them","tier":"notice","area":"Tool Hints","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.323\/e\/plan-mode-tool-and-an-environment-secrets-tool-gain-whentous","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.323","markdown":"### Plan approval and secret listing tools get hints on when to use them\n\nThe plan-approval tool and a tool that lists environment secrets now carry short hints telling Claude when to use them\n\n**What**\n\nTwo tools now carry a short `whenToUse` hint for Claude:\n\n- The plan-approval tool: use it, rather than starting on edits, when about to write code for a task that is not simple, so you approve the approach first.\n\n- The list-secrets tool: it returns only ids, labels, dates and status, never secret values.\n\n**Why**\n\nWhen tools are not all shown to Claude up front and it has to search for them, these hints help it pick the right one. In practice Claude is more likely to ask you to approve a plan before larger changes.\n\n- Area: Tool Hints\n- Names: `whenToUse`\n- Tier: You'll notice\n- Useful: 1\/5\n- Signal: 1\/5\n- Scope: individual\n- Heads-up: no"}