From f7490d2e0911fb82a92c80e7938bae4fb04e16cd Mon Sep 17 00:00:00 2001
From: Arti Zirk <arti.zirk@gmail.com>
Date: Sat, 31 Oct 2026 20:03:06 +0200
Subject: [PATCH] feat(opencode): add tms34010 agent with the whole User's
 Guide preloaded

Subagent/primary agent whose system prompt inlines docs/TMS34010-users-guide.txt
(SPVU001A, 1.75 MB, ~361k tokens) via {file:} substitution, so whole-book
questions -- cross-chapter synthesis, complete opcode lists, encoding and
timing tables -- are answered from the text in one pass.

Read-only (edit and subagent denied) and keeps read/shell, so it can render a
page with pdftoppm when the OCR text layer is mangled: section 12 prints XY as
XV and checkmarks as 'J'.
---
 opencode.json | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/opencode.json b/opencode.json
index 6bc742f..fe2bb32 100644
--- a/opencode.json
+++ b/opencode.json
@@ -12,5 +12,16 @@
         "cwd": "."
       }
     }
+  },
+  "agents": {
+    "tms34010": {
+      "description": "Answers from the complete TI TMS34010 User's Guide (SPVU001A, 667 pages) preloaded in context. Use for cross-chapter synthesis, complete opcode lists, encoding/timing tables, or edition comparisons - questions that need the whole book rather than one grep hit.",
+      "mode": "all",
+      "system": "You answer questions about the TI TMS34010 Graphics System Processor. Your context is the complete TI TMS34010 User's Guide (SPVU001A, 1988-08, 667 pages), reproduced below in full.\n\nRules:\n- Cite the chapter and printed page when you quote, e.g. \"Section 12.6.6, page 12-27\".\n- Quote opcode encodings, bit-field layouts, register layouts and hex values verbatim. Never paraphrase a hex digit or synthesize an encoding you cannot see. If a passage is unreadable, say so.\n- The source is OCR'd from a scan, so tables, figures and timing diagrams are frequently mangled. Flag that explicitly and state what you can and cannot read instead of inventing missing cells.\n- If the book states something that contradicts general knowledge about the 34010, the book wins. Say when you are unsure whether a passage is a transcription artifact.\n- The 34010 is bit-addressed: addresses in the book are often bit addresses. Be explicit about which form you are quoting.\n\n===== BEGIN: TMS34010 USER'S GUIDE (SPVU001A) =====\n\n{file:docs/TMS34010-users-guide.txt}\n\n===== END: TMS34010 USER'S GUIDE (SPVU001A) =====",
+      "permissions": [
+        { "action": "edit", "resource": "*", "effect": "deny" },
+        { "action": "subagent", "resource": "*", "effect": "deny" }
+      ]
+    }
   }
 }