Fix Opus 5

OPUS 5 IS BROKEN — USE THIS TO FIX IT.

fix-opus5 is a local agent harness with a portable set of user-level reliability rules for Opus 5, Claude Code, Codex, and compatible coding-agent workflows. It addresses common failure modes such as unsupported claims, edits in live checkouts, unnecessary scope expansion, weak verification, unsafe operations, and excessive agent delegation.

The rules are plain Markdown. They do not install a model, change model or reasoning settings, configure authentication, or transmit project data. Project-local instructions remain authoritative when they are more specific.

Quick start

Clone the repository, review the policy files, and run the installer for your platform:

git clone https://github.com/Wildonuy/fix-opus5.git
cd fix-opus5

On Windows:

scripts\install.bat

On Linux, macOS, or another POSIX system:

./scripts/install.sh

Restart existing coding-agent sessions after installation. New sessions can then load the user-level instructions automatically.

Why use it?

Common failure mode	Harness guardrail
Confident claims without inspection	Requires grounding in relevant code, tests, schemas, and consumers
Changes made in a live or dirty checkout	Requires an explicitly owned Git worktree and branch
Scope drift and speculative refactoring	Requires the smallest sufficient change
Repeated testing without a stopping rule	Treats acceptance criteria as the stopping condition
Unsafe deployment or credential actions	Requires exact targets, reversible operations, and separate authorization
Unnecessary agent trees	Delegates only independent work and requires evidence back from workers

A local agent harness

The harness runs through local instruction files rather than a hosted service:

• Plain Markdown policies remain readable, reviewable, and easy to customize.
• User-level installation makes the same working agreements available across repositories and new sessions.
• No account credentials, model selection, telemetry, or remote execution are built into the harness.
• Project-specific instructions can extend or override the portable defaults.

What it installs

• CLAUDE.md to ~/.claude/CLAUDE.md
• AGENTS.md to ~/.codex/AGENTS.md

The installation is user-level and works independently of the current project. Existing files are never replaced unless the explicit force option is used. Forced replacement creates a timestamped backup first.

You can use the supplied configuration as-is or combine it with your existing instructions. The Codex policy is optional, but is recommended when Codex will dispatch Opus 5 agents.

Compatibility

Platform or tool	Support
Windows 10/11	install.bat or Windows PowerShell 5.1+
Linux and macOS	POSIX sh plus sha256sum, shasum, or openssl
Claude Code	User-level ~/.claude/CLAUDE.md policy
Codex	Optional user-level ~/.codex/AGENTS.md policy
Context7	Optional and compatible; not bundled

Git is required for the clone-based quick start. The policy files may also be downloaded and reviewed manually.

Install on Windows

From Command Prompt, PowerShell, or Windows Terminal:

scripts\install.bat

To review the PowerShell entry point directly:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1

Use -Force to back up and replace different installed policy files.

Install on Linux, macOS, or another POSIX system

chmod +x ./scripts/install.sh
./scripts/install.sh

Use --force to back up and replace different installed policy files.

Verify

On Windows:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify.ps1

On a POSIX system:

./scripts/verify.sh

Context7

This configuration works well with Context7. Context7 can provide current, version-specific library and API documentation when local project evidence is not sufficient. Context7 is optional and is not bundled or installed by this repository.

Contributing and support

Bug reports and feature requests are welcome through the repository's issue tracker. Please read CONTRIBUTING.md before submitting a pull request. For security-sensitive reports, follow SECURITY.md rather than opening a public issue.

License

fix-opus5 is free and open-source software licensed under the GNU General Public License v3.0 (GPL-3.0-only). Commercial use is permitted. Distributed modified versions and covered derivative works must make their corresponding source available under GPLv3 and preserve the applicable copyright and license notices.

Using the harness to guide work does not automatically place the resulting projects or other output under GPLv3.

Independence and trademarks

This is an independent community project. It is not affiliated with, sponsored by, or endorsed by Anthropic, OpenAI, or Upstash. Claude, Claude Code, Codex, Context7, and other product names are trademarks of their respective owners.

Contact

For questions, support, or commercial licensing, open a GitHub issue or email WildonUyeda@Luminiferous.onmicrosoft.com.