What problem does it solve? Agents starting a session often miss the right documentation because context files are scattered across process/context/, development-protocols/, and feature folders. This Skill deterministically discovers every relevant file, extracts only its YAML frontmatter, and routes the agent to the correct domain docs without loading entire files into context. ## Core Features & Use Cases - Frontmatter-only discovery: The discover-context.mjs script walks context, protocol, plan, and feature directories and extracts only leading YAML frontmatter blocks, keeping context windows small. - Keyword-based routing: The --match flag tokenizes a task description and ranks context docs by overlap with their frontmatter keywords, then appends related sibling docs for cross-domain tasks. - Generated routing tables: The --emit-routing and --check-routing flags regenerate and lint the routing tables in all-context.md so the index never drifts from the actual files. - Use Case: At the start of a planning session for an authentication change, run the script with --match "update the user ORM model" to get a ranked list of context docs to read instead of guessing which files apply. ## Quick Start Ask the agent to run node .claude/skills/vc-context-discovery/scripts/discover-context.mjs with your task description to load the relevant context files for this session.
