sdd-spec-search

Search indexed SDD spec directories for tickets, epics, and planning documents.

Updated Nov 9, 2025
One-click install
npx skills add https://github.com/manifoldlogic/claude-code-plugins --skill sdd-spec-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-spec-search
Source: https://github.com/manifoldlogic/claude-code-plugins/tree/main/plugins/maproom/skills/sdd-spec-search
Command: npx skills add https://github.com/manifoldlogic/claude-code-plugins --skill sdd-spec-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @crewchief/maproom, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Searching through extensive SDD (Spec-Driven Development) specifications manually is time-consuming and error-prone. This skill provides an efficient way to locate tickets, epics, planning documents, and architecture decisions without the need for manual reading.

Core Features & Use Cases

  • Semantic Search: Quick and accurate search through indexed SDD spec directories using maproom.
  • SDD-Specific Patterns: Utilizes SDD-specific directory structure and search strategies.
  • Use Case: When you need to find the planning documents for a ticket, understand architecture decisions, or locate related tickets and epics, this skill can help you do so efficiently.

Quick Start

To search for SDD specifications related to a ticket, use the following command:

/sdd-spec-search search --repo <repo-name> --query "<search-term>"

Frequently Asked Questions about sdd-spec-search

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

FAQPage Schema
How do I search through SDD specifications without reading manually?

You can search SDD specifications using semantic search to quickly locate tickets, epics, and planning documents. This approach leverages indexed directories and SDD-specific patterns to retrieve information accurately without manual reading.

Do I need maproom to run semantic search on spec directories?

Yes, you need maproom and the SDD_ROOT_DIR environment variable configured to locate spec directories. These dependencies are required for the semantic search functionality to operate on indexed SDD specification structures.

How can I find architecture decisions and related tickets in an SDD directory?

Finding architecture decisions and related tickets in an SDD directory is done by running a semantic search query. This retrieves relevant planning documents and architecture records quickly by utilizing SDD-specific directory structure knowledge.

What is the best way to locate planning documents for a specific ticket?

The best way to locate planning documents for a specific ticket is using semantic search with a targeted query. This retrieves the exact documents needed by searching indexed SDD spec directories, saving time on manual analysis.

Can I use semantic search to retrieve information across different spec repositories?

Yes, you can retrieve information across spec repositories by specifying the repo name in your search command. The semantic search operates on indexed SDD spec directories, allowing you to query specific repositories for accurate document retrieval.

Why does SDD specification search require an environment variable for directory location?

SDD specification search requires the SDD_ROOT_DIR environment variable to pinpoint the exact location of your spec directories. This allows the semantic search tool to index and query the correct SDD-specific directory structures accurately.