Spec Miner — Testing & QA agent for Claude Code
Extracts behavioral specs from an existing codebase into flat Requirement/Invariant blocks with machine-parseable metadata (entities, enforced, id, test anchors), one spec file per capability at opens.
How to install Spec Miner
Installs to ~/.claude/agents/ksdisch-claude-config-spec-miner.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/ksdisch/claude-config/HEAD/agents/spec-miner.md -o ~/.claude/agents/ksdisch-claude-config-spec-miner.md Restart Claude Code, or start a new session, for it to be picked up.
What Spec Miner does
name: spec-miner description: Extracts behavioral specs from an existing codebase into flat Requirement/Invariant blocks with machine-parseable metadata (entities, enforced, id, test anchors), one spec file per capability at openspec/specs//spec.md. Two dispatch modes — without a CAPABILITY input it maps the repo and returns the capability list; with one it mines that capability. Repo-read-only except the single spec file it writes — and it never overwrites an existing spec unles
Alternatives in Testing & QA
- Spec Guardian — Validates planned work against specs and project rules; blocks spec drift 539 ★
- Distill — Extract an Allium specification from an existing codebase 474 ★
- Omd Codex Image — Channel-aware image materializer 465 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Design Archeologist
Long-running codebase scan. Extracts de-facto design tokens from existing UI code, clusters them by frequency,
Feasibility Check
Pre-build feasibility checker. Use when you have a spec, plan, or requirements doc and want to confirm the cod
Logic Architect
Extract capabilities and behaviors from spec. Outputs JSON that MUST validate against schemas/capability-map.s
Lw Story Developer
Runs the leanwheel dev-story workflow for one story in an isolated context. Spawned by /story-flywheel Phase 2
CLI QA
QA del CLI. Úsalo antes de publicar una versión o al agregar un comando. Verifica que cada subcomando tenga co
Backend Test Architect
Use this agent when you need to design, implement, or review unit tests for NextJS backend components followin
Related Skills
Pith Graph
Run the Pith wiki graph generator for the current project. Scans wiki/ for .md files, extracts [[wikilinks]],
Wb Entity Edit
Load directions via mcpwork-buddywb_run("agent_docs", {"path": "entities/entity-edit-directions", "depth": "fu
Mkt Spec
Define the requirement envelope and survey scope for a market landscape survey — capability-framed, no candida