Skip to content

feat(board): surface AI Agent State field during GSD execution#90

Closed
snipcodeit wants to merge 1 commit intomainfrom
issue/75-surface-ai-agent-state-field-on-bo
Closed

feat(board): surface AI Agent State field during GSD execution#90
snipcodeit wants to merge 1 commit intomainfrom
issue/75-surface-ai-agent-state-field-on-bo

Conversation

@snipcodeit
Copy link
Owner

Summary

  • Add update_board_agent_state utility to board-sync.md — updates the "AI Agent State" TEXT field on board items via GitHub Projects v2 GraphQL API
  • Hook into run.md at planner/executor/verifier spawn points for both quick and plan-phase routes
  • Shows current agent activity in GitHub Projects board (e.g., "Planning phase 14", "Executing phase 14")
  • Non-blocking: API failures never interrupt pipeline execution

Closes #75

Milestone Context

  • Milestone: v2 — GitHub Projects Board Management
  • Phase: 14 — Pipeline State Sync
  • Issue: 5 of 9 in milestone

Changes

  • Updated: .claude/commands/mgw/workflows/board-sync.md — added update_board_agent_state function alongside existing update_board_status
  • Updated: .claude/commands/mgw/run.md — inline update_board_agent_state definition + calls before each GSD agent spawn and clear after PR creation

AI Agent State Update Points

Trigger Value
Before gsd-planner (quick) "Planning"
Before gsd-executor (quick) "Executing"
Before gsd-verifier (quick) "Verifying"
Before gsd-planner (plan-phase, phase N) "Planning phase N"
Before gsd-executor (plan-phase, phase N) "Executing phase N"
Before gsd-verifier (plan-phase, phase N) "Verifying phase N"
After PR created "" (clear)

Test Plan

  • During planning, board shows "Planning phase N"
  • During execution, board shows "Executing phase N"
  • During verification, board shows "Verifying phase N"
  • After PR creation, field is cleared to empty string
  • If board not configured (no node_id), all calls are silent no-ops
  • If issue has no board_item_id, all calls are silent no-ops
  • If ai_agent_state field not in board schema, all calls are silent no-ops
  • GraphQL API errors do not halt pipeline execution

Add update_board_agent_state utility to board-sync.md and hook into
run.md at planner/executor/verifier spawn points for both quick and
plan-phase routes. Field is cleared after PR creation. All calls are
non-blocking — API failures never interrupt pipeline execution.

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
@snipcodeit
Copy link
Owner Author

Work included in main via integration merge from milestone-1 branch.

@snipcodeit snipcodeit closed this Mar 1, 2026
@snipcodeit snipcodeit deleted the issue/75-surface-ai-agent-state-field-on-bo branch March 2, 2026 01:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

slash-commands Changes to slash command files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Surface AI Agent State field on board items during GSD execution

1 participant