mcpField
G
gitlab-board-sync

gitlab-board-sync

github.com/nextstage-brasilProductivity047 installsUpdated 5d ago
Repository

About gitlab-board-sync

gitlab-board-sync is a skill for mirroring local SDD planning and execution state to existing GitLab issues. It guides issue reads and carefully staged updates without creating issues.

Key features

  1. 01Read issue descriptions and comments
  2. 02Batch-update milestones, labels, assignees, estimates
  3. 03Sync task start and completion status
  4. 04Record spent time and internal notes

Use cases

  1. 01Review linked issues before implementation
  2. 02Apply planned work details to mapped issues
  3. 03Keep issue status aligned with task execution

MCP support

Requires a GitLab MCP server and directs tool calls through mcp-gitlab-usage. It uses GitLab issue-reading and update tools; it does not create issues.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nextstage-brasil/skills --skill gitlab-board-sync

After installing, type/gitlab-board-syncin Claude Code to confirm it loaded.

Bundled filesevals/evals.jsonreferences/gitlab-sync-config.template.md

Details

From the project README

GitLab Board Sync

Mirror local SDD planning/execution state onto existing GitLab issues. Does not create issues.

Prerequisites

  1. GitLab MCP available — follow mcp-gitlab-usage for all tool calls
  2. If multiple GitLab MCP servers: ask human which to use
  3. {product_root}/docs/context/gitlab-sync-config.md validated
  4. For post-planning batch: gitlab-issue-feature-map.md exists

Configuration

Read references/gitlab-sync-config.template.md for expected fields:

  • project_id, milestone_id, assignee_default
  • status_backlog, status_in_progress, status_done, status_blocked
  • rf_label_format, base_branch, work_branch, mr_target_branch

Discover unknown status labels via list_project_labels — confirm with human.

Flow C — Pre-implementation read

When task lists GitLab issue IIDs:

  1. read_issue for description + recent comments
  2. Non-blocking if inaccessible — log warning, continue
  3. Do not mutate issue in this flow

Flow A — Post-planning batch

Per issue in map (excluding exclude_issues):

  1. Validate milestone (project + group)
  2. update_issue with milestone_id
  3. One set_issue_labels — remove_labels + add_labels atomically (RF, Status, Equipe)
  4. assign_issue
  5. set_issue_estimate from linked task header (seconds)

Flow B — Per-task execution sync

Task start (before coding)
remove: status_backlog
add: status_in_progress

Record start time for add_issue_spent_time.

Task complete (after validation)

Only if already status_in_progress:

remove: status_in_progress
add: status_done, RF: NNN
add_issue_spent_time
add_issue_comment (internal=true)

Never backlog → done in one step.

Anti-patterns

WrongRight
assignee on update_issueassign_issue
Two label calls for one transitionSingle atomic set_issue_labels
Manual Milestone: labelmilestone_id on update_issue
set_issue_estimate for time spentadd_issue_spent_time
Public comment for internal notesinternal: true

References

FileWhen
references/gitlab-sync-config.template.mdBootstrap config
mcp-gitlab-usageTool schemas and gates

Comments

Markdown supported