vc-plan-discovery

Plan discovery automates finding related project plans for a specific task by scanning feature folders and extracting YAML frontmatter. It provides grouped lists of active plans, backlogs, and completed items to give full task context.

Extracting YAML frontmatter reads fields like name, description, type, feature, and phase from plan artifacts. This process parses files deterministically using Node.js to route and match relevance for project management workflows.

Plan discovery works with Node.js and relevant parsing libraries to scan feature folders, active plans, and general plans. It requires a Node.js environment to run scripts that deterministically extract machine-readable output.

Organizing task plans requires applying scope rules based on feature folders, active plans, and general plans. This approach ensures the discovery script efficiently extracts frontmatter and groups output into active, backlog, completed, reports, and references.

Plan discovery groups output into categories like active plans, backlogs, completed, reports, and references to provide comprehensive context on what was tried, what is in progress, and what exists for current tasks.

You can use plan discovery to find historical reports and references for current tasks. The tool scans specified folders and extracts frontmatter to output clear, grouped lists of existing reports alongside active and completed plans.