lean-coding-agent-pack

Short, reversible working agreements for GPT-5.6 Sol and similar coding agents in Claude Code or Codex.

The failure mode this pack targets is extra work after the task is already solved: extra prose, tests, guards, files, abstractions, and scope. Capable models should choose the path; the pack supplies a small change boundary, safety invariants, and clear stop conditions.

The user's current request has the highest priority among user-level instructions. CUSTOM.md encodes that policy: when loaded, it takes precedence over conflicting pack defaults, generic prompts, and other lower-priority guidance in CLAUDE.md / AGENTS.md. System/developer instructions, platform safety and tool-permission boundaries, and later explicit user requests still apply; no user-level rule can override them. CLAUDE.md and AGENTS.md are the durable harness entry points; CUSTOM.md is the companion policy and is also installed into Claude Code's active rules directory.

Install (reversible)

chmod +x install.sh uninstall.sh
./install.sh --dry-run
./install.sh                 # user-level Claude Code / Codex when detected
CLAUDE_CONFIG_DIR=/path ./install.sh # use a custom Claude Code config dir
./install.sh --repo --effort # also Git root; lower xhigh/max/ultra → medium

Backups land in ~/.gpt56-sol-agent-pack-backups/<stamp>/. Undo:

./uninstall.sh

Uninstall skips destinations changed after installation instead of overwriting them. Details: docs/INSTALL-AND-RESTORE.md.

Open a new session after install or uninstall.

Files

File	Role
CUSTOM.md	Personal workflow, recovery policy, and security-sensitive storage guidance.
CLAUDE.md	Claude Code entry-point working agreement; generic defaults yield to the active CUSTOM.md policy.
AGENTS.md	Same bytes as CLAUDE.md, for Codex's entry-point filename.
examples/task-suffix.txt	Optional one-line task boundary.
docs/REPORT.md	Cited research behind the pack.
docs/CONFLICTS.md	Precedence and rule differences.

Do not dump a second copy of the same rules into a rules/ tree. The installer makes one deliberate Claude Code rules copy so the companion policy is on an active loading surface.

Optional task suffix

Make the smallest change that fully solves the task. Do not add abstractions, fallbacks, retries, defensive guards, refactors, or features unless requested, required by a reproduced failure, a real security or data-loss boundary, or the project's working agreement.

Do not add back

• Coverage thresholds, mandatory TDD, or unit+integration+E2E for every change
• Blanket try/catch, validation of trusted internal values, or hypothetical hardening
• Reviewer, planner, or verification agents after every edit
• Generic “be concise,” “think step by step,” or “verify one more time” slogans

License

MIT. See LICENSE.