SuperAPI AI Directory
Partner中文AI newsFavorites
Skillsdiscover

discover

Coding & development

View repository

Updated 10-20 16:12

About this skill

Docs-First Discovery Skill

Fast, token-efficient codebase discovery using semantic documentation.

Project-Agnostic: Works with any project that has docs/semantic/ documentation.

Why Use This

Before expensive file discovery:

  • Glob patterns: Can return hundreds of files
  • Grep searches: Token-heavy output
  • Explore agents: Multiple tool calls

With /discover:

  • Direct Logic ID → file:line mapping
  • Pre-indexed feature specs
  • 70-90% token savings on discovery

Quick Commands

Feature Lookup

$SKILL_DIR/scripts/discover.sh AUTH

Returns: Full technical spec with all Logic IDs and code locations.

Keyword Search

$SKILL_DIR/scripts/discover.sh "timer approval workflow"

Returns: QMD search results + matching Logic IDs.

Prime Session Context

$SKILL_DIR/scripts/prime.sh

Returns: Business index summary for session context.

List All Features

$SKILL_DIR/scripts/discover.sh --list

Returns: All available feature codes and descriptions.

Check Status

$SKILL_DIR/scripts/discover.sh --status

Returns: Docs/QMD availability status for current project.

Project Detection

The scripts automatically detect:

  • Project name: From directory name (e.g., timan → timan)
  • QMD collection: {project-name}-docs (e.g., timan-docs)
  • Docs path: docs/semantic/ in project root

Usage Patterns

Pattern 1: Feature Implementation

User: "I need to modify the assignment approval workflow"
You: Run /discover ASGN
Result: Get ASGN-L1 through ASGN-L10 with exact file:line locations
Action: Read specific files instead of Glob/Grep

Pattern 2: Code Location Search

User: "Where is timer functionality implemented?"
You: Run /discover timer
Result: TIMR-L1 → TimerController.php:45:startTimer
Action: Direct file read

Pattern 3: Session Setup

User: "Let's work on the time tracking module"
You: Run /discover --prime
Result: Full business index loaded
Action: Reference Logic IDs throughout conversation

Pattern 4: New Project Check

User: "What features are documented?"
You: Run /discover --status
Result: Shows if docs exist and QMD collection is available

Logic ID Format

Logic IDs map business logic to code:

  • Format: FEATURE-L# (e.g., AUTH-L3, TIME-L7)
  • Resolves to: file:line:function

Setting Up for a New Project

  1. Generate semantic docs:

    Run semantic-architect-agent

  2. Create QMD collection (optional, for fast search):

    qmd collection add {project-name}-docs docs/

  3. Verify setup:

    /discover --status

Integration with Semantic Docs

This skill wraps:

  • /semantic-docs for tech specs
  • qmd search for fast full-text search
  • Business index for feature registry
  • Structural index files: structural/services.md, structural/routes.md, structural/hooks.md

Relationship:

  • /semantic-docs: Deep lookup by specific ID
  • /discover: Broad discovery before deep lookup

When This Triggers

  • "Find where X is implemented"
  • "Show me the code for X"
  • "What handles X?"
  • "Discover X feature"
  • "Prime context for X"
  • Before spawning Explore agents
  • Before complex Glob/Grep searches

Output Format

=== DISCOVER: [query] ===
Project: [project-name]

MATCHING FEATURES
[Feature table from business index]

TECHNICAL SPECS
[List of relevant tech spec files]

LOGIC ID MAPPINGS
[ID → file:line:function]

SUGGESTED ACTIONS
[Specific Read commands to run]

Structural Queries

When a structural index has been generated (/structural-index), discover supports prefix-based structural queries:

Service Lookup

$SKILL_DIR/scripts/discover.sh service:entity_type.manager
$SKILL_DIR/scripts/discover.sh svc:config.factory

Returns: Matching services with class, dependencies, and module.

Route Lookup

$SKILL_DIR/scripts/discover.sh route:/admin/config
$SKILL_DIR/scripts/discover.sh path:/node

Returns: Matching routes with controller, access requirements.

Hook Lookup

$SKILL_DIR/scripts/discover.sh hook:node_presave

Returns: All implementations (procedural + OOP) with file locations.

Plugin Lookup

$SKILL_DIR/scripts/discover.sh plugin:Block

Returns: All plugins of the specified type with class and module.

Entity Lookup

$SKILL_DIR/scripts/discover.sh entity:node
$SKILL_DIR/scripts/discover.sh ent:paragraph

Returns: Entity type definitions with handlers and module.

Dependency / Impact Analysis

$SKILL_DIR/scripts/discover.sh deps:AUTH
$SKILL_DIR/scripts/discover.sh impact:my_module

Returns: Dependencies, consumers, blast radius from DEPENDENCY_GRAPH.md.

Note: Structural queries require running /structural-index first. Without it, these prefixes fall through to standard search.

Graceful Fallback

If no semantic docs exist:

  • Hook silently skips (doesn't block agents)
  • Skill shows helpful setup instructions
  • Standard Glob/Grep still works as fallback