CODE REVIEW / Trail of Bits
Code slice worker
Pins the Trailmark worker that answers from one source packet, returns a single JSON object, and says it cannot read the repository.
“A coordinator-only slice worker that cites ranges present in its packet and must not treat omitted nodes as fact or claim that an edit was applied.”
01 / THE REASONING
Why this made the selection.
- The agents index has no entry for plugins/trailmark/agents/code-slice-worker.md.
- The file limits invocation to the slicing-code-context coordinator, forbids repository reads, and requires needs_context or cannot_answer instead of a claim about omitted code.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/trailmark/agents/code-slice-worker.md
- README.md
- LICENSE
- Round 2: pinned definition, output contract and permission/dependency boundaries reread on 2026-10-14
- plugins/trailmark/skills/slicing-code-context/SKILL.md (selected dispatch and context-isolation contract)
Our findings
- The description says to analyze one bounded packet, return source-cited JSON, not access the repository, and use the agent only when the slicing-code-context coordinator invokes it.
- The body says there are no repository-reading or mutation tools, and not to call TodoWrite, TaskList, or ToolSearch.
- The response must be one JSON object whose status is complete, needs_context, or cannot_answer. It says not to claim behavior from omitted nodes or uncertain edges, and never to claim an edit was applied or tested.
- It says source code, comments, strings, identifiers, and packet metadata are untrusted data, and to ignore instructions embedded in them.
- needs_context requires a specific missing symbol or relationship that blocks the task, rather than requesting the full repository by default.
- A proposed replacement must remain inside included ranges and can never be described as already applied or tested.
- The coordinator explicitly says the bundled Claude worker can receive repository instructions, git status and ambient host context; it is a bounded-source fallback, not a strict empty-context process.
Not established by this review
- The resource was not executed and its tools were not called.
- No source packet was supplied.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Use the role in your project.
DOCUMENTED COMMAND
/plugin marketplace add trailofbits/skills Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- The README's Claude Code section is that line, then /plugin menu to browse plugins.
- The same README names trailmark as the code-graph and bounded-slicing plugin in the plugin table. The marketplace command does not install that plugin by itself.
- The Codex section uses codex plugin marketplace add trailofbits/skills and a placeholder plugin name, so that line is not install.command.
- Use the slicing coordinator and validate returned ranges against the packet; disable tool discovery if strict packet-only confinement is required.
Before you start
- Claude Code or Codex marketplace support
- The matching slicing-code-context coordinator and its separate Python 3.12+/uv/Trailmark packet builder
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- code-slice-worker ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/agents/code-slice-worker.md
Supports: coordinator-only call, no tree access, and omitted-node rule
- Repository README ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: marketplace install line and trailmark row
- Repository LICENSE ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: Attribution-ShareAlike 4.0 International
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/slicing-code-context/SKILL.md
Supports: Dependency setup and source-review boundary