spec-discovery

Locate spec headings across repositories and emit JSON or TOML manifests with SHA-256 hashes.

8|1|Updated Jul 11, 2025
One-click install
npx skills add https://github.com/ViperJuice/treesitter-chunker --skill spec-discovery-viperjuice
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-discovery
Source: https://github.com/ViperJuice/treesitter-chunker/tree/main/.ai-dev-kit/skills/spec-discovery
Command: npx skills add https://github.com/ViperJuice/treesitter-chunker --skill spec-discovery-viperjuice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locate specs across repositories and extract IDs, titles, and traceability metadata to support cross-repo governance and auditing.

Core Features & Use Cases

  • ID and Title Extraction: Detects spec headings matching patterns like REQ-XYZ and captures the associated title for each spec.
  • Traceability Generation: Computes SHA-256 hashes for spec files and records source_repo, path, and hash to enable provenance tracking.
  • Output & Compliance: Emits a structured manifest (JSON/TOON) organized by repository and path, including optional de-duplication and validation.

Quick Start

Parse the specs in your repos and generate a spec manifest with IDs, titles, and hashes.

Frequently Asked Questions about spec-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract spec IDs and traceability data across multiple repositories?▼

To extract spec IDs and traceability data across multiple repositories, you can parse markdown headings matching patterns like REQ-XYZ to capture associated spec titles, repository paths, and SHA-256 hashes. This generates a structured manifest organized by repository and path for cross-repo governance and auditing.

What is the best way to generate a spec manifest with provenance hashes for auditing?▼

The best way to generate a spec manifest with provenance hashes for auditing is to compute SHA-256 hashes for each spec file while recording its source repository and path. This produces a structured JSON or TOON manifest with normalized anchors to support compliance tracking.

Can I output traceability metadata in JSON format with normalized anchors?▼

Yes, you can output traceability metadata in JSON format with normalized anchors. The extraction process locates specs across repositories, captures IDs and titles, and emits a structured manifest organized by repository and path in either JSON or TOON format.

How do cross-repo spec governance tools handle duplicate spec files?▼

Cross-repo spec governance tools handle duplicate spec files by applying optional de-duplication and validation during manifest generation. This ensures the final JSON or TOON output accurately reflects unique spec instances while maintaining their source repository, path, and SHA-256 hash metadata.

Does spec-discovery work with markdown files to detect REQ-XYZ heading patterns?▼

Yes, spec-discovery works with markdown files to detect REQ-XYZ heading patterns. It parses these headings to extract associated spec titles and computes traceability metadata including the source repository, file path, and SHA-256 hash for each matched file.

When do I need to compute SHA-256 hashes for spec files?▼

You need to compute SHA-256 hashes for spec files when you require provenance tracking and cross-repo governance. Computing these hashes creates a verifiable traceability manifest that records the source repository and path to support auditing and compliance validation.