docs(agents): summarize the OpenCode ecosystem (closes #100)

[dem-extra1]

Why

Issue #100 asks for a summary of the OpenCode ecosystem
(the projects listed at https://opencode.ai/docs/ecosystem/: plugins, providers, clients, and integrations)
plus NeuralNomadsAI/CodeNomad.
The site already covers three OpenCode topics
(local models, OpenRouter, and Oh My OpenCode)
but has no map of the wider ecosystem,
so a reader who wants to know which OpenCode add-ons are worth trying
has nowhere to look.

What

• Adds chapters/ai-tools/opencode-ecosystem.qmd, transcluded from chapters/coding-agents.qmd
  as "The OpenCode Ecosystem" (@sec-ai-opencode-ecosystem),
  with per-project notes (what it does, maintainer, activity, "useful to us?")
  and cross-references to the existing OpenCode sections instead of repeating them.
• Adds the cited sources to references.bib.

Closes #100

🤖 Generated with Claude Code

[Copilot]

🟢 Approval recommended

The changes are documentation-focused, references and section cross-links resolve correctly, and no concrete issues were found in the updated files.

Pull request overview

Adds a new documentation section mapping the OpenCode ecosystem (plugins, projects/clients, agent bundles, plus CodeNomad) and wires it into the existing “Coding agents” chapter, with supporting bibliography entries and spelling wordlist updates.

Changes:

• Adds a new ai-tools page summarizing notable OpenCode ecosystem projects with cross-references to existing OpenCode coverage.
• Includes the new section from chapters/coding-agents.qmd under “The OpenCode Ecosystem”.
• Extends references.bib and inst/WORDLIST to support citations and spelling checks for the new content.

File summaries

File	Description
references.bib	Adds BibTeX entries for OpenCode docs/repos and ecosystem projects cited by the new section.
inst/WORDLIST	Adds new proper nouns/terms used in the OpenCode ecosystem write-up to satisfy spellcheck.
chapters/coding-agents.qmd	Inserts a new top-level section that transcludes the OpenCode ecosystem page.
chapters/ai-tools/opencode-ecosystem.qmd	New content page summarizing the OpenCode ecosystem with “useful to us?” guidance and internal cross-references.

Review details

• Files reviewed: 4/4 changed files
• Comments generated: 0
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

One or more custom setup steps configured for this repository failed during this Copilot code review run:

Verify development environment

Setup steps run before each review. If the review above is missing context, or no review was posted at all, the failing step above may be the cause. See the workflow run for failure details, fix your setup steps configuration, and re-request a review.

Note

You can configure setup steps for Copilot code review separately from Copilot cloud agent with a copilot-code-review.yml file. Read the docs for details.

[Copilot]

🟡 Changes recommended

The newly added BibTeX block contains a malformed entry (missing closing brace) that can break bibliography rendering, and the new GitHub repo citations don’t match the file’s established howpublished = {Software} convention.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details

• Files reviewed: 4/4 changed files
• Comments generated: 1
• Review effort level: Lite

[github-actions]

Claude finished review — View run

---

Confirmed — no other files changed in this range, only references.bib.

Review: PR #209 — docs(agents): summarize the OpenCode ecosystem (closes #100)

What changed since the last review round (0c24cae8 → 433d5dc9, per the computed range): only references.bib changed (112 insertions, 55 deletions), via commit 70a3ed3 ("fix(bib): rebuild references.bib as a clean union after the main sync") and its merge commit 433d5dc. chapters/ai-tools/opencode-ecosystem.qmd, chapters/coding-agents.qmd, and inst/WORDLIST are unchanged from the prior round.

Verification of the fix for the previously-blocking finding. The last round (commit 0c24cae8) found references.bib malformed: the opencode_portal entry was missing its note field and closing brace, running directly into @misc{oh_my_claudecode, and breaking the [@opencode_portal] citation used at chapters/ai-tools/opencode-ecosystem.qmd:240. I re-verified this independently rather than taking the fix commit's message at face value:

• Brace balance: 426 { vs. 426 } — balanced (previously 425 vs. 424).
• Parsed with bibtexparser: 56/56 entries parse, 0 failed blocks on the current file, versus 55/56 with 1 failed block when I re-parsed the previously-reviewed commit (0c24cae8) the same way — the parser reproduces the exact same abort location (@misc block at line 384, "Expected a = after entry key, but found @misc") that the prior review reported, confirming that finding was real and is now resolved.
• Diffed entry-by-entry between the previously-reviewed commit and the current file for every entry whose @misc{...} line moved: oh_my_claudecode, hoyeon, superpowers, gsd_core, openharness, langchain_custom_harness, my_claude_code_harness are all byte-identical in content between the two commits (only their file position/ordering was rewritten by the rebuild); opencode_portal now has its correct, complete field set (title, author, year, howpublished, url, note = {Accessed 2026-09-09}, closing }) before @misc{oh_my_claudecode,.
• No entry ID was dropped or duplicated: comparing the parsed ID sets between the old and new file, the only difference is opencode_portal now being present (in old-parsed but not new-parsed... corrected: present in new, previously dropped due to the parse failure); zero duplicate IDs in the current file.
• The [@opencode_portal] citation at chapters/ai-tools/opencode-ecosystem.qmd:240 now resolves to a well-formed entry.

No other regressions were introduced by the rebuild — the reordering/whitespace changes to the other bibliography entries are cosmetic and don't affect parsing or content, consistent with a "clean union" rebuild as the commit message states.

Findings: none, new or outstanding. This confirms the fix for the sole blocking issue raised in the previous round (posted 2026-09-10T08:13:43Z, that review), and the content-accuracy verification from the first round (2026-09-09T15:52:00Z) still stands since the .qmd, coding-agents.qmd, and WORDLIST files are unchanged in this range.

Verdict

Ready for merge

Structured Review Data (JSON)

{
  "schema_version": "1.1",
  "reviewer": "claude",
  "commit_sha": "433d5dc97b45748c6570d0c18b5d970aa3a40fa8",
  "verdict": "CLEAN",
  "findings": [],
  "detailed_assessment": "references.bib now parses as 56/56 well-formed BibTeX entries with balanced braces, resolving the prior opencode_portal truncation that previously broke the citation on chapters/ai-tools/opencode-ecosystem.qmd line 240.",
  "holistic_assessment": "The rebuild commit only reordered and repaired references.bib without touching the qmd prose, coding-agents.qmd wiring, or WORDLIST scope, so the earlier content-accuracy verification and citation integrity both remain valid for merge."
}

Reviewed commit: 70a3ed3

[github-actions]

💰 Cost: $0.4231 (review) — run

[Copilot]

🟡 Changes recommended

New bibliography entries use howpublished = {GitHub repository} instead of the repo’s established howpublished = {Software} convention, and one statement in the new ecosystem page needs clarification to avoid confusing metrics.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details

Suppressed comments (1)

references.bib:330

• references.bib uses howpublished = {Software} for GitHub repository citations elsewhere (e.g., inflexa / torqclaw), but these new OpenCode ecosystem repo entries use howpublished = {GitHub repository}. For consistency (and to keep bibliography styling uniform), switch this and the other newly added GitHub repo entries to Software.

  howpublished = {GitHub repository},

• Files reviewed: 4/4 changed files
• Comments generated: 1
• Review effort level: Lite

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-09-10 08:58 UTC