issue-tracking

Track beads as git-backed issues with persistent attribution, supporting Gas Town's bead lifecycle and convoy progress monitoring.

509 stars

Best use case

issue-tracking is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Track beads as git-backed issues with persistent attribution, supporting Gas Town's bead lifecycle and convoy progress monitoring.

Teams using issue-tracking should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/issue-tracking/SKILL.md --create-dirs "https://raw.githubusercontent.com/a5c-ai/babysitter/main/library/methodologies/gastown/skills/issue-tracking/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/issue-tracking/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How issue-tracking Compares

Feature / Agentissue-trackingStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Track beads as git-backed issues with persistent attribution, supporting Gas Town's bead lifecycle and convoy progress monitoring.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Issue Tracking

## Overview

Track work through Gas Town's bead system: git-backed atomic work units that carry persistent attribution. Each bead is an issue/task with full lifecycle tracking from creation through completion.

## When to Use

- Creating new beads for a convoy
- Tracking bead progress and status
- Managing bead dependencies
- Collecting attribution data for agent evaluation

## Bead Lifecycle

1. **Created**: Bead defined with scope and acceptance criteria
2. **Assigned**: Bead placed on agent's hook
3. **In Progress**: Agent actively working (GUPP enforced)
4. **Review**: Work complete, awaiting merge review
5. **Done**: Merged and verified (`gt done`)
6. **Destroyed**: Wisps only - cleaned up after landing

## Attribution

All work carries persistent attribution:
- Which agent completed the bead
- Time taken and quality score
- Used for A/B testing agent configurations
- Feeds into agent evaluation and scoring

## Tool Use

Used within convoy management and orchestrator processes.