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.