Audit Agent Settings

Scan the platform's docs exhaustively, cross-reference them against the user's real config, deliver a ranked report, and apply what the user picks. Tie every suggestion to a named user fact — tailored, not generic.

Use AskUserQuestion in Claude Code, with multi-select for several picks. In Codex, use request_user_input for single choices; for several picks, present a numbered list and collect the selected numbers in a free-text reply. Use plain text when the named tool is unavailable.

1. Pick the targets

Use targets already specified by the user. Otherwise, offer the existing targets with this session's platform first: Claude Code settings, Codex config, or both. Read one reference per target:

• references/claude-code.md for Claude Code's docs mirrors, settings scopes, validator, dead-key probe, and gotchas.
• references/codex.md for the same on Codex.

Done when every target has its reference loaded.

2. Fetch ground truth

Curl each raw markdown mirror the reference lists into <scratchpad>. <scratchpad> is your session's scratchpad directory, or /tmp when the harness provides none. -f makes a missing page a failed command instead of a silently saved 404 body. These files are the only acceptable source for the scan; the reference's installed-CLI probes verify behavior, they do not replace the files.