document-selection

Map user requests to Metis document types using predefined decision trees and ADR guidance.

13|3|Updated Jul 2, 2025
One-click install
npx skills add https://github.com/colliery-io/metis --skill document-selection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-selection
Source: https://github.com/colliery-io/metis/tree/main/plugins/metis/skills/document-selection
Command: npx skills add https://github.com/colliery-io/metis --skill document-selection

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Assist teams in selecting the correct Metis document type (Vision, Strategy, Initiative, Task, Backlog Item, ADR) based on user input to streamline project structuring.

Core Features & Use Cases

  • Maps user requests to the appropriate document type using a decision framework.
  • Guides parent-child relationships and eligibility (e.g., when a backlog item becomes an initiative).
  • Provides references to the decision trees and ADR guidance for deeper understanding.

Quick Start

Ask Metis to suggest the correct document type for my current project.

Frequently Asked Questions about document-selection

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

FAQPage Schema
How do I choose the right document type for a new project task?

Choosing the right document type involves mapping your user request to a Vision, Strategy, Initiative, Task, Backlog Item, or ADR using a decision tree that evaluates work scope and parent-child relationships.

When should I create an ADR instead of a standard backlog item?

You should create an ADR instead of a backlog item when the work involves a significant architectural or strategic choice, guided by specific decision criteria that distinguish technical decisions from routine implementation tasks.

What is the difference between an initiative and a backlog item in project planning?

An initiative is a broader container for work, while a backlog item is a discrete task. A backlog item becomes an initiative when it requires standalone parentage and encompasses multiple nested child tasks.

How do I determine the correct parent document for a new task?

To determine the correct parent document, apply the enforced parentage rules from the decision tree, which checks whether a task belongs under an existing initiative or requires a higher-level strategy or vision document.

Does this document selection framework support organizing existing work?

Yes, the document selection framework supports organizing existing work by evaluating current tasks and mapping them to the appropriate document type, ensuring proper parent-child eligibility and structural alignment.