Awesome_claude awesome-claude
Multi-session ticket-based task coordination for Claude Code. Use when working on any coding task to claim tickets, track progress, and coordinate with other sessions. ALWAYS check for available tickets before starting work.
install
source · Clone the upstream repo
git clone https://github.com/ParkHwichan/awesome_claude
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ParkHwichan/awesome_claude "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/awesome-claude" ~/.claude/skills/parkhwichan-awesome-claude-awesome-claude && rm -rf "$T"
manifest:
.claude/skills/awesome-claude/SKILL.mdsource content
Awesome Claude - Multi-Session Task Coordination
Ticket-based coordination system for multiple Claude Code sessions working on the same project. Prevents duplicate work and ensures proper task sequencing through dependencies.
When to Apply
Use this system when:
- Starting any coding task (check for existing tickets first)
- Creating work items for a project
- Coordinating work across multiple Claude Code sessions
- Tracking progress on implementation tasks
Required Workflow
ALWAYS follow this sequence:
- Check claimable tickets (blocked tickets are auto-filtered)ticket_list_available
- Claim a ticket (fails if blocked or already claimed)ticket_claim
- Mark as in progressticket_start- Do the work
- Complete with summaryticket_complete
Critical: Dependency Rules
When creating tickets with dependencies, you MUST use the
parameter.blockedBy
Why This Matters
- Tickets with
cannot be claimed until blocking tickets completeblockedBy - System enforces work order automatically
- Multiple sessions can work safely without conflicts
Correct Pattern
# Step 1: Create base ticket ticket_create: title: "Design database schema" description: "Define user and session tables with proper indexes..." priority: high # Returns ID: abc12345 # Step 2: Create dependent ticket with blockedBy ticket_create: title: "Implement user API" description: "Create CRUD endpoints for user management..." priority: high blockedBy: ["abc12345"] # REQUIRED - references base ticket # Returns ID: def67890 # Step 3: Chain dependencies ticket_create: title: "Build user management UI" description: "React components for user CRUD operations..." priority: medium blockedBy: ["def67890"] # Cannot start until API is complete
Anti-Pattern (DO NOT DO THIS)
# WRONG: Dependency only in description - system cannot enforce order ticket_create: title: "Implement user API" description: "After DB schema is done, create CRUD endpoints..." # Missing blockedBy! Other sessions may work on this prematurely
Tool Reference
Ticket Management
| Tool | Description |
|---|---|
| Create ticket (use for dependencies) |
| List claimable tickets (unblocked only) |
| List all tickets with status filter |
| Get ticket details by ID |
| Claim ticket (fails if blocked) |
| Mark as in_progress |
| Complete with summary |
| Mark as failed with error |
| Release back to pool |
Session Management
| Tool | Description |
|---|---|
| List active sessions |
| Current session info |
Best Practices
- Always claim before working - Prevents conflicts with other sessions
- Use
for dependencies - Text in description is not enforcedblockedBy - Release if blocked - Let other sessions take over
- Write meaningful summaries - Helps other sessions understand completed work
- Analyze dependencies first - When creating multiple tickets, map the dependency chain before creating