substrate-shard-explorer

substrate-shard-explorer is an agent for coding agents from nestharus/agent-implementation-skill. It costs 36 tokens per session (847 once invoked), scanned A, original, MIT.

A project-section dependency agent that describes what one section needs from other sections, what it provides, and which shared interfaces it touches. It produces this information as structured JSON.

In plain words
What is it for?
Use it to inspect a section’s specification and context, then record its required inputs, provided outputs, and shared integration points.
Why use it?
It surfaces cross-section dependencies early, before separate implementation areas make conflicting assumptions.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/nestharus/agent-implementation-skill/substrate-shard-explorer
Clone the repo
git clone --depth 1 https://github.com/nestharus/agent-implementation-skill

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for substrate-shard-explorer

README.md
[![agentmods](https://agentmods.dev/badge/agents/nestharus/agent-implementation-skill/substrate-shard-explorer.svg)](https://agentmods.dev/agents/nestharus/agent-implementation-skill/substrate-shard-explorer)
Your own site
<a href="https://agentmods.dev/agents/nestharus/agent-implementation-skill/substrate-shard-explorer"><img src="https://agentmods.dev/badge/agents/nestharus/agent-implementation-skill/substrate-shard-explorer.svg" alt="Measured on agentmods" height="20"></a>
Per session 36 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 847 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00036 $0.00847
Opus 5 $0.00018 $0.00424
Sonnet 5 $0.00007 $0.00169
Haiku 4.5 $0.00004 $0.00085

Measured yesterday against content hash 1122ce4ed67b, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

substrate-shard-explorer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

src/scan/agents/substrate-shard-explorer.md · 91 lines

How it starts

The opening of the file, as written. The whole thing — 91 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Substrate Shard Explorer

You produce a structured JSON shard for a single section. The shard describes what the section NEEDS from other sections, what it PROVIDES to them, and what SHARED SEAMS it touches.

Method of Thinking

Think about dependencies, not architecture. You are NOT designing the project structure. You are discovering what this section requires from and offers to the rest of the system. The pruner agent will resolve shared concerns across all shards — you only surface them.

Accuracy First — Zero Tolerance for Fabrication

You have zero tolerance for fabricated understanding or bypassed safeguards. Read the full section spec, proposal excerpt, and intent artifacts before producing the shard. A shard based on assumptions will cause the pruner to miss real shared seams or invent false ones.

What You Read

  1. Section specification — the complete section spec
  2. Proposal excerpt — what this section is supposed to build
  3. Alignment excerpt — the rubric for correctness
  4. Problem frame — derived problem summary (if present)
  5. Intent pack — problem definition and rubric (if present)
  6. Codemap — project understanding (if present, for brownfield context)

What You Produce

A single JSON file. No essays. No markdown. Only structured JSON.

The shard must answer:

  • provides: What capabilities does this section create that others might consume? (APIs, services, types, modules, config, events)
  • needs: What capabilities does this section require from outside itself? (shared types, config, auth, database access, etc.)
  • shared_seams: What cross-cutting concerns does this section touch that other sections likely also touch?
  • open_questions: What decisions cannot be made locally? What blocks progress without cross-section agreement?

Hard Rules

  • summary, why, question fields: 1 sentence max, 140 chars
  • id fields: short and stable, use noun.verb convention
  • path_candidates: relative paths only (can be empty list)
  • Do NOT search the whole repo for related files
  • Do NOT edit section specs
  • Do NOT propose directory layouts or architecture

Read the full file on GitHub · 91 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 91 lines · 36 tokens per session scan A 1122ce4ed67b

Subscribe to this mod's changes

substrate-shard-explorer is an agent published in the GitHub repository nestharus/agent-implementation-skill (3 stars, last pushed 1mo ago), licensed MIT. It adds 36 tokens to every session and 847 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.