README
- Match the structure of common practical-guide repos: title, badges,
install one-liner, "Choose your path", "When to use what" decision
tree (mermaid) + table, "What's inside" topical map, deep dives,
Limitations, FAQ, Updates, References.
- Add explicit not-affiliated-with-OpenCode disclaimer per OpenCode's
own README request for third-party projects using "opencode" in the
name.
- Add AI-coding caveat (you're still the reviewer, hallucinations are
real) at the top.
- Add balanced "When OpenCode isn't the right tool" subsection naming
Claude Code, Cursor, Aider, Copilot, Codeium, Supermaven as better
fits for specific use cases.
- All factual claims verified against opencode.ai/docs and the JSON
config schema. Pricing/model table dated 2026-05-18.
AGENTS.md
- Repurpose from generic React boilerplate to actually describe this
repo: a documentation guide. Includes editing rules, style guide,
emoji policy, and "when to update what" matrix.
- Delete eight pre-refactor doc files under docs/ (AGENTS-GUIDE,
COMMANDS-REFERENCE, FAQ-TROUBLESHOOTING, MCP-GUIDE, MIGRATION-GUIDE,
SKILLS-GUIDE, TUI-MASTERY, ZEN-GUIDE). They were inaccurate to current
OpenCode behavior; replacements land in a follow-up commit.
- Remove .opencode/skills/{pr,review}.md — these were placed as files,
but OpenCode skills require folder-with-SKILL.md format. Equivalent
content is being re-shipped as .opencode/commands/ entries.
- Remove Images/opencode.png and opencode-installation.png — these are
OpenCode's own branding assets; not appropriate to redistribute from
a non-affiliated community guide.
- Remove Images/.gitkeep — superseded by Images/README.md in a later commit.
The previous .gitignore excluded .opencode/agents/, /commands/, and /skills/ —
which prevented committing the very example files this repo is meant to
showcase. Keep user-specific runtime state (cache, logs, sessions, audit log,
local state) ignored; un-ignore the example folders.