Documentation

Learn Michi

Everything you need to master debt-aware sprint planning.

Quick Start Guide

New to Michi? Get your first debt-aware roadmap set up in 5 minutes.

Get Started

Getting Started

Set up your account and create your first debt-aware roadmap in under 5 minutes.

  • Creating your account
  • Setting up your first project
  • Configuring debt allocation (20% default)
  • Inviting your team
  • Understanding the dashboard

Integrations

Connect Michi to your existing tools for seamless two-way sync.

  • Connecting Jira Cloud
  • Connecting Linear
  • Syncing backlogs and sprints
  • Webhook configuration
  • Troubleshooting sync issues

Roadmap Planning

Create and manage roadmaps that balance features with debt reduction.

  • Creating a roadmap
  • Setting sprint length and buffer
  • Adding epics and milestones
  • AI roadmap generation
  • Managing roadmap lifecycle

Sprint Management

Plan, execute, and review sprints with full debt visibility.

  • Creating a sprint
  • Using the Kanban board
  • Task types: Feature, Bug, Debt, Spike, Chore
  • Sprint capacity and debt allocation
  • Marking debt sprints
  • Sprint completion and review

AI Features

Leverage AI for smarter planning and data-driven recommendations.

  • How velocity prediction works
  • AI roadmap generation explained
  • Sprint recommendations engine
  • Cost projection methodology
  • Tuning AI accuracy for your team

Team & Settings

Manage teams, roles, permissions, and organization settings.

  • Team roles: Admin, Manager, Developer, Designer
  • Setting weekly capacity per member
  • Configuring debt sprint frequency
  • Organization-level settings
  • Profile and notification preferences

Advanced Configuration

Fine-tune Michi to match your team's unique workflow.

  • Custom debt allocation per project
  • Sprint length configuration
  • Planning buffer percentages
  • Task priority and story point scales
  • Data export and backups

Concepts & Guides

Deep dives into the methodology behind debt-aware planning.

  • What is debt-aware planning?
  • The 20% allocation rule explained
  • Velocity prediction methodology
  • Health score calculation
  • Best practices for debt reduction

Can't find what you need? Contact support or join the community.