How does this skill handle work discovered during implementation?

It mandates recording discovered work in Beans immediately to prevent context loss, followed by an assessment to escalate the task to Linear if it affects scope or requires human approval.

Does this skill automate git commit messages?

It provides specific formatting rules to ensure every commit references the associated Linear ticket and Beans issue, maintaining a clear link between code changes and tasks.

Why use TodoWrite alongside Beans and Linear?

TodoWrite provides immediate, live visibility for the user during a session, while Beans provides a persistent git-synced record and Linear serves as the permanent project record for humans.

What is the 'Beans' system mentioned in this skill?

Beans is a git-tracked, agent-specific memory system used to store implementation details and audit trails that are too granular for human-facing trackers like Linear but necessary for session persistence.

Issue Tracking with Beans & Linear

Name: Issue Tracking with Beans & Linear
Author: czottmann

byczottmann

•

Productivity & Workflow

Coordinates task management across session-level progress, git-tracked agent memory, and external Linear project tracking.

This skill establishes a structured three-tier task-tracking hierarchy to ensure seamless coordination between Claude, the developer, and the broader team. It integrates TodoWrite for live session visibility, Beans for persistent agent memory and audit trails, and Linear for human-level project tracking. By enforcing bidirectional linking, standardized git commit patterns, and clear escalation rules for discovered work, it ensures that implementation details are never lost while keeping project-level documentation clean and actionable.

Key Features

018 GitHub stars

02Standardized Git commit formatting for full traceability

03Three-tier task visibility (Session, Git-tracked, and External)

04Systematic handling and escalation of discovered work

05Automated Beans creation with Linear ticket cross-referencing

06Bidirectional linking between agent memory and human project boards

Use Cases

01Maintaining an audit trail of technical decisions within the codebase

02Managing complex feature implementations across multiple coding sessions

03Synchronizing autonomous agent progress with team-wide Linear boards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add czottmann/claude-code-stuff issue-tracking-with-beans-and-linear

For use in Claude.ai and ChatGPT

Download Skill