markdownlint
- Disable MD028 (no-blanks-blockquote): we intentionally separate
adjacent blockquote callouts (a tip + a warning side-by-side) with
a blank line; visually this renders as two callouts, which is the
intent.
- Switch MD029 (ol-prefix) to "one_or_ordered": both "1. / 2. / 3."
and "1. / 1. / 1." (auto-renumber) are valid; the rule was hitting
ordered lists that have intervening code blocks, where the lint
loses count.
- Add blank lines before lists in five places where MD032 fired
(test.md, git-release/SKILL.md, agents.md, skills.md, migration.md).
- Fix nested code-fence bug in database-engineer-prompt.md: the
outer ``` was being closed by an inner ```sql; switched the outer
fence to ```` (4 backticks) so the inner one stays nested.
link-check
- Ignore https://mcp.grep.app and https://ai.google.dev/ — the first
returns 405 to HEAD requests (verified working via GET); the second
trips an infinite-redirect bug in the link checker (real URL works).
- Ignore github.com/anomalyco/opencode/discussions — the upstream
repo currently has discussions disabled.
- Add 405 to aliveStatusCodes for endpoints that accept GET but
reject HEAD.
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.