workflow-claude-settings

Workflow Changelog — Settings Report

You are a coordinator for the claude-code-best-practice project. Your job is to launch two research agents in parallel, wait for their results, merge findings, and present a unified report about drift in the Settings Reference report (best-practice/claude-settings.md).

Versions to check: $ARGUMENTS (default: 10 if empty or not a number)

This is a read-then-report workflow. Launch agents, merge results, and produce a report. Only take action if the user approves.

---

Phase 0: Launch Both Agents in Parallel

Immediately spawn both agents using the Task tool in the same message (parallel launch):

Agent 1: workflow-claude-settings-agent

Spawn using subagent_type: "workflow-claude-settings-agent". Give it this prompt:

Research the claude-code-best-practice project for settings report drift. Check the last $ARGUMENTS versions (default: 10).

Fetch these 3 external sources:

1. Settings Documentation: https://code.claude.com/docs/en/settings
2. CLI Reference: https://code.claude.com/docs/en/cli-reference
3. Changelog: https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

Then read the local report file (best-practice/claude-settings.md) and the CLAUDE.md file. Analyze differences between what the official docs say about settings keys, permission syntax, hook events, MCP configuration, sandbox options, plugin settings, model aliases, display settings, and environment variables versus what our report documents. Return a structured findings report covering missing settings, changed types/defaults, new settings additions, deprecated settings, permission syntax changes, hook event changes, MCP setting changes, sandbox setting changes, environment variable completeness, example accuracy, settings hierarchy accuracy, and sources validity.

Agent 2: claude-code-guide

Spawn using subagent_type: "claude-code-guide". Give it this prompt:

Research the latest Claude Code settings system. I need you to find:

1. The complete list of all currently supported settings.json keys with their types, defaults, and descriptions
2. Any new settings keys introduced in recent Claude Code versions
3. Changes to existing settings behavior (e.g. new permission modes, new hook events, new sandbox options)
4. Changes to the settings hierarchy (new priority levels, new file locations)
5. Changes to permission syntax (new tool patterns, new wildcard behavior)
6. New hook events or changes to hook configuration structure
7. Changes to MCP server configuration (new matching fields, new settings)
8. Changes to sandbox settings (new network options, new commands)
9. Changes to plugin configuration (new fields, new marketplace options)
10. Changes to environment variables (new vars, deprecated vars, changed behavior)
11. Changes to model aliases or model configuration
12. Changes to display/UX settings (status line, spinners, progress bars)
13. Any deprecations or removals of settings keys

Be thorough — search the web, fetch docs, and provide concrete version numbers and details for everything you find.