Agent skill

loom-manager-workflow

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/loom-manager-workflow

SKILL.md

Purpose

Manage Loom team tickets as a team manager when you cannot use loom team commands or git merge/push operations.

When To Use

  • You are a team manager for a Loom team
  • You need to create tickets, update status, add notes
  • You cannot execute merges or push code directly
  • Workers are doing implementation in worktrees

Constraints

  • Do NOT use loom team * commands
  • Do NOT use git merge* or git push* commands
  • Only use loom ticket commands for ticket management
  • Use git read commands: git status, git log, git diff, git show, git branch

Core Workflow

1. Create Tickets

  • Use loom ticket create --priority <1|2> --type <feature|task|example> --tag <phase,tags>
  • Tickets created without title/description need notes added immediately
  • Add note with: tasks, dependencies, acceptance criteria, examples

2. Update Ticket Status

  • loom ticket start <id> - move to in_progress
  • loom ticket close <id> - move to closed
  • Note: no "ready" or "blocked" commands exist via CLI, use notes instead

3. Add Notes

  • loom ticket add-note <id> "Your note here"
  • Use notes for: detailed requirements, dependency tracking, urgent requests, review feedback

4. Track Dependencies

  • Add notes starting with "DEPENDENCIES:" or "BLOCKED:"
  • List ticket IDs and explain relationship
  • Example: "DEPENDENCIES: Depends on vp-045b (API Clients) being merged first"

5. Identify Blockages

  • Check implementation complete (git log shows feature commits)
  • If complete but in_progress: add URGENT note requesting merge
  • Include: commit hash, branch name, merge target

6. List and Review

  • loom ticket list - see all tickets
  • loom ticket show <id> - see full details including notes
  • Use --status filter if available

Best Practices

  • Add dependency notes to both parent and child tickets
  • Use phase tags (phase1, phase2, phase3) for organization
  • When creating multiple related tickets, create them all then add notes
  • Inspect branches before declaring ready (git log, git diff)
  • Clear priority guidance: P1 features must complete before P2

Worker Communication

  • Workers update tickets via loom ticket add-note
  • Workers should set status to in_progress when starting
  • Workers should request review before considering complete
  • Workers can escalate via notes when blocked

Verification

  • Run loom ticket list to check overall state
  • Use git branch -a to see all feature branches
  • Check loom ticket show <id> for full context

Manual notes

This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.

Didn't find tool you were looking for?

Be as detailed as possible for better results