tracking

by @ReinaMacCredy in AI & LLM

# Install this skill:

npx skills add ReinaMacCredy/maestro --skill "tracking"

Install specific skill from multi-skill repository

# Description

# SKILL.md

name: tracking
description: >
Tracks complex, multi-session work using the Beads issue tracker and dependency graphs, and provides
persistent memory that survives conversation compaction. Use when work spans multiple sessions, has
complex dependencies, or needs persistent context across compaction cycles. Trigger with phrases like
"create task for", "what's ready to work on", "show task", "track this work", "what's blocking", or
"update status". MUST load maestro-core skill first for routing.
metadata:
version: "2.2.0"

Prerequisites

Load maestro-core first - maestro-core for routing table and fallback policies
Routing and fallback policies are defined in AGENTS.md.

Tracking - Persistent Memory for AI Agents

Graph-based issue tracker that survives conversation compaction. Provides persistent memory for multi-session work with complex dependencies.

Entry Points

Trigger	Reference	Action
`bd`, `beads`	`references/workflow.md`	Core CLI operations
`fb`, `file-beads`	`references/FILE_BEADS.md`	File beads from plan → auto-orchestration
`rb`, `review-beads`	`references/REVIEW_BEADS.md`	Review filed beads

Quick Decision

bd vs TodoWrite:
- "Will I need this in 2 weeks?" → YES = bd
- "Could history get compacted?" → YES = bd
- "Has blockers/dependencies?" → YES = bd
- "Done this session?" → YES = TodoWrite

Rule: If resuming in 2 weeks would be hard without bd, use bd.

Essential Commands

Command	Purpose
`bd ready`	Show tasks ready to work on
`bd create "Title" -p 1`	Create new task
`bd show <id>`	View task details
`bd update <id> --status in_progress`	Start working
`bd update <id> --notes "Progress"`	Add progress notes
`bd close <id> --reason completed`	Complete task
`bd dep add <child> <parent>`	Add dependency
`bd sync`	Sync with git remote

Session Protocol

Start: bd ready → pick highest priority → bd show <id> → update to in_progress
Work: Add notes frequently (critical for compaction survival)
End: Close finished work → bd sync → git push

Reference Files

Category	Files
Workflows	`workflow.md`, `WORKFLOWS.md`, `FILE_BEADS.md`, `REVIEW_BEADS.md`
CLI	`CLI_REFERENCE.md`, `DEPENDENCIES.md`, `LABELS.md`
Integration	`conductor-integration.md`, `VILLAGE.md`, `GIT_INTEGRATION.md`
Operations	`AGENTS.md`, `RESUMABILITY.md`, `TROUBLESHOOTING.md`

Anti-Patterns

❌ Using TodoWrite for multi-session work
❌ Forgetting to add notes (loses context on compaction)
❌ Not running bd sync before ending session
❌ Creating beads for trivial single-session tasks

maestro-core - Workflow router and skill hierarchy
conductor - Automated beads operations via facade
orchestrator - Multi-agent parallel execution

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.