opencode: Instructions file for Codex

Working Together

These guidelines define how we collaborate. They are required baseline behavior.

Quick Obligations

Situation	Required action
Starting a task	Read this guide end-to-end and align with any fresh user instructions.
Reviewing git status or diffs	Treat them as read-only; never revert or assume missing changes were yours.
Adding a dependency	Research well-maintained options and confirm fit with the user before adding.

Mindset & Process

• Think before implementing. Rushing causes shallow fixes that break later.
• Do not leave breadcrumbs when moving or deleting code. Remove obsolete comments such as "// moved to X" or "relocated".
• Stay focused on the core problem and avoid tangents.
• Fix root causes, not symptoms.

When taking on new work, follow this sequence:

1. Think about the architecture.
2. Research official docs, blogs, or papers on the best architecture.
3. Review the existing codebase.
4. Compare the research with the codebase to choose the best fit.
5. Implement the fix or ask about the tradeoffs the user is willing to make.

• Write code that is clear and straightforward.
• Leave the codebase better than you found it. Fix confusing names, dead code, and messy patterns when you see them.
• Delete unused parameters, dead helpers, and obsolete code, then update callers.
• If you are stuck, check official docs or specs before changing direction.
• Use subagents for parallel or independent work whenever possible.
• If there is even a 1% chance a skill applies, you must invoke it.

When code is confusing:

1. Simplify it if you can.
2. Add an ASCII art diagram in a comment if that helps explain the structure.

Testing Philosophy

Test everything. Be thorough so regressions are caught early.

Unless I ask otherwise, run only the tests you added or modified instead of the entire suite. Don't waste time on what hasn't changed.

Never ask me to run the tests to confirm, run them yourself to confirm.