spec-inventory

Capability: substrate:framework-dev + substrate:analytics

Harness: agnostic

A deterministic uv tool that emits a compact routing inventory for the spec-loop prompts. It summarizes spec frontmatter, where-it-lives hints, validation commands, known gaps, skill frontmatter, and tool/test presence so agents can choose what to read next without first scanning the whole repository.

The output is a routing aid, not proof. Prompts still require direct file reads or code search before declaring behaviour present or absent.

Prerequisites

Runtime: Python 3.11+ run via uv; stdlib-only (no runtime dependencies). The dev group pulls pytest, ruff, and mypy.
CLIs: None beyond the runtime.
Credentials / auth: None.
Network: Runs fully offline; reads local specs, skills, and tool metadata from the repository checkout.

Usage

uv run --project tools/spec-inventory spec-inventory
uv run --project tools/spec-inventory spec-inventory --brief --max-where 1 --max-validation 1 --max-gaps 1
uv run --project tools/spec-inventory spec-inventory --json

Run tests

uv run --project tools/spec-inventory --group dev pytest tools/spec-inventory/tests