This repo doubles as a fully-configured OpenCode project so readers can
see real files instead of abstract format docs.
Agents (.opencode/agents/, OpenCode YAML + markdown body):
- code-reviewer.md — read-only subagent, glob-gated bash perms,
Severity/Where/Why/Fix output format. Rewrites the pre-refactor file
which used incorrect frontmatter shape (no YAML, claude-sonnet-4.6
as bare ID, made-up tool keys).
- security-auditor.md — OWASP-focused review subagent, deny edit,
ask bash, CWE-aware output template.
Commands (.opencode/commands/):
- review.md, pr.md, test.md, optimize.md — uses real placeholders
($ARGUMENTS, @file, !shell), points the right agent at each task.
Plugins (.opencode/plugins/):
- protect-secrets.js — blocks tool calls touching .env*, secrets/,
credentials*, SSH keys, .npmrc, .pypirc. Pure JS, no deps.
- audit-log.js — appends one JSON line per successful tool call to
.opencode/audit.jsonl (also added to .gitignore).
- README.md — how to install/disable, sample audit-log line, link to
docs/plugins.md.
Skills (.opencode/skills/git-release/SKILL.md):
- Proper folder-with-SKILL.md format. Trigger-shaped description so the
model actually loads it when the conversation touches release prep.
- 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.