From drupal-workflow
Discovers Logic IDs and file paths from semantic docs/semantic/ for efficient codebase exploration. Use /discover FEATURE for lookups, keyword search, --prime for business index before Glob/Grep/Explore.
npx claudepluginhub gkastanis/drupal-workflow --plugin drupal-workflowThis skill uses the workspace's default tool permissions.
Fast, token-efficient codebase discovery using semantic documentation.
Navigates semantic documentation mapping business logic to Drupal code. Searches by Logic ID (AUTH-L1), feature code (MIGR), user story (US-001), or entity schema to answer 'where/how/what handles X?' questions.
Explores codebases to answer questions about how code works, trace execution flows, or research topics via semantic search. Offers autonomous mode for structured subagent output and interactive mode with narrative checkpoints.
Proactively searches codebase documentation for functions, classes, APIs, and comments before task implementation using Bash tools like docs-search.sh.
Share bugs, ideas, or general feedback.
Fast, token-efficient codebase discovery using semantic documentation.
Project-Agnostic: Works with any project that has docs/semantic/ documentation.
Before expensive file discovery:
With /discover:
$SKILL_DIR/scripts/discover.sh AUTH
Returns: Full technical spec with all Logic IDs and code locations.
$SKILL_DIR/scripts/discover.sh "timer approval workflow"
Returns: QMD search results + matching Logic IDs.
$SKILL_DIR/scripts/prime.sh
Returns: Business index summary for session context.
$SKILL_DIR/scripts/discover.sh --list
Returns: All available feature codes and descriptions.
$SKILL_DIR/scripts/discover.sh --status
Returns: Docs/QMD availability status for current project.
The scripts automatically detect:
timan → timan){project-name}-docs (e.g., timan-docs)docs/semantic/ in project rootPattern 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 IDs map business logic to code:
FEATURE-L# (e.g., AUTH-L3, TIME-L7)file:line:functionGenerate semantic docs:
Run semantic-architect-agent
Create QMD collection (optional, for fast search):
qmd collection add {project-name}-docs docs/
Verify setup:
/discover --status
This skill wraps:
/semantic-docs for tech specsqmd search for fast full-text searchstructural/services.md, structural/routes.md, structural/hooks.mdRelationship:
/semantic-docs: Deep lookup by specific ID/discover: Broad discovery before deep lookup=== 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]
When a structural index has been generated (/structural-index), discover supports prefix-based structural queries:
$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.
$SKILL_DIR/scripts/discover.sh route:/admin/config
$SKILL_DIR/scripts/discover.sh path:/node
Returns: Matching routes with controller, access requirements.
$SKILL_DIR/scripts/discover.sh hook:node_presave
Returns: All implementations (procedural + OOP) with file locations.
$SKILL_DIR/scripts/discover.sh plugin:Block
Returns: All plugins of the specified type with class and module.
$SKILL_DIR/scripts/discover.sh entity:node
$SKILL_DIR/scripts/discover.sh ent:paragraph
Returns: Entity type definitions with handlers and module.
$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.
If no semantic docs exist: