What is the difference between a Task and a Backlog Item in Metis?

A Task is a discrete unit of work that belongs to a specific parent Initiative, whereas a Backlog Item is for ad-hoc bugs, features, or technical debt that do not yet have a parent.

When should I create an ADR?

Create an Architectural Decision Record (ADR) when making significant technical choices that involve trade-offs and will impact future development, rather than using a standard task.

Can I move a Backlog Item into an Initiative later?

Yes, you can use the reassign_parent function to move a standalone Backlog Item into an Initiative, effectively converting it into a Task within that project's scope.

How does Metis handle 'bug tickets'?

Metis maps user terms like 'bug' or 'defect' to a Task document type with a specific 'bug' backlog category, helping maintain consistent metadata across the project.

What is a 'Vision' document in this context?

A Vision document serves as the 'North Star' for a project, defining why the project exists and its primary objectives, and acts as the parent for Strategies and Initiatives.

Metis Document Selection

Name: Metis Document Selection
Author: colliery-io

bycolliery-io

•

Productivity & Workflow

Guides users in choosing the correct Metis document type for tasks, initiatives, architectural decisions, and project visions.

About

The Metis Document Selection skill streamlines work management by helping users navigate the Flight Levels framework to select the most appropriate document type for their needs. Whether you are logging a bug, starting a new project, or documenting a complex architectural decision, this skill provides a structured decision guide to differentiate between Visions, Strategies, Initiatives, Tasks, Backlog Items, and ADRs. By mapping common industry terminology to Metis-specific categories and enforcing proper parent-child hierarchies, it ensures that project data remains organized, actionable, and aligned with organizational objectives.

Key Features

Hierarchical enforcement for parent-child document relationships within Flight Levels
Guidance on architectural decision record (ADR) creation versus implementation tasks
Support for both standard and full strategy presets for multi-team coordination
Context-aware mapping of common terms like 'bug' or 'epic' to Metis document types
Decision guide for distinguishing between standalone backlog items and initiative-linked tasks
1 GitHub stars

Use Cases

Structuring a new project by defining its Vision and decomposing it into actionable Initiatives
Determining if a new work request should be an initiative or a standalone backlog item
Deciding when to document a technical trade-off as an ADR instead of a standard task

About

Key Features

Hierarchical enforcement for parent-child document relationships within Flight Levels
Guidance on architectural decision record (ADR) creation versus implementation tasks
Support for both standard and full strategy presets for multi-team coordination
Context-aware mapping of common terms like 'bug' or 'epic' to Metis document types
Decision guide for distinguishing between standalone backlog items and initiative-linked tasks
1 GitHub stars

Use Cases

Structuring a new project by defining its Vision and decomposing it into actionable Initiatives
Determining if a new work request should be an initiative or a standalone backlog item
Deciding when to document a technical trade-off as an ADR instead of a standard task