Back to list
salmanrrana

brain-dump-tickets

by salmanrrana

A local-first kanban board designed from the ground up for AI-assisted development

0🍴 0📅 Jan 25, 2026

SKILL.md


name: brain-dump-tickets description: Manage Brain Dump tickets - create, update, track progress, and complete work items. Use when working with Brain Dump task management or when asked to create/update tickets.

Brain Dump Ticket Management Skill

This skill provides the knowledge and workflows for managing Brain Dump tickets.

When to Use This Skill

  • Creating new tickets or epics
  • Updating ticket status
  • Adding work summaries or progress updates
  • Starting or completing work on a ticket
  • Linking commits or files to tickets

Available MCP Tools

Brain Dump provides these MCP tools (prefix with brain-dump/ if needed):

Project Management

ToolDescription
list_projectsList all registered projects
find_project_by_pathFind project by directory path
create_projectRegister a new project

Ticket Operations

ToolDescription
list_ticketsList tickets (optionally filtered)
create_ticketCreate a new ticket
update_ticket_statusUpdate ticket status
start_ticket_workStart working (creates git branch)
complete_ticket_workComplete and move to review

Epic Management

ToolDescription
list_epicsList epics for a project
create_epicCreate a new epic

Progress Tracking

ToolDescription
add_ticket_commentAdd comment/work summary
get_ticket_commentsGet comments for a ticket
link_commit_to_ticketLink a git commit
link_files_to_ticketLink files to a ticket

Ticket Status Flow

backlog → ready → in_progress → review → done
                              ↘ ai_review → human_review → done

Creating Good Tickets

Required Fields

  • projectId: Get from find_project_by_path or list_projects
  • title: Clear, action-oriented title

Optional Fields

  • description: Detailed description (markdown supported)
  • priority: "low", "medium", or "high"
  • epicId: Group with related tickets
  • tags: Array of categorization tags

Example

create_ticket({
  projectId: "abc-123",
  title: "Add user authentication",
  description: "Implement login/logout functionality with JWT tokens",
  priority: "high",
  tags: ["backend", "auth", "security"]
})

Work Summary Format

When completing a ticket, add a work summary:

add_ticket_comment({
  ticketId: "ticket-id",
  content: `## Work Summary
**Changes Made:**
- Added LoginForm component
- Integrated with auth API
- Added validation

**Tests:**
- Unit tests passing
- E2E login flow tested

**Notes:**
- Consider adding rate limiting later`,
  author: "claude",
  type: "work_summary"
})

Progress Updates

Keep users informed during work:

add_ticket_comment({
  ticketId: "ticket-id",
  content: "Starting implementation of login form. Will add validation and error handling.",
  author: "claude",
  type: "comment"
})

Linking Work

link_commit_to_ticket({
  ticketId: "ticket-id",
  commitHash: "abc123",
  message: "feat: add login form component"
})
link_files_to_ticket({
  ticketId: "ticket-id",
  files: ["src/components/LoginForm.tsx", "src/api/auth.ts"]
})

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon