Skip to content

feat(board): design and scaffold GitHub Projects v2 board schema#86

Merged
snipcodeit merged 1 commit intomainfrom
issue/71-design-and-scaffold-github-projects-v2-b
Mar 1, 2026
Merged

feat(board): design and scaffold GitHub Projects v2 board schema#86
snipcodeit merged 1 commit intomainfrom
issue/71-design-and-scaffold-github-projects-v2-b

Conversation

@snipcodeit
Copy link
Owner

Summary

  • Design GitHub Projects v2 board structure with 5 MGW pipeline custom fields
  • Document complete field schema (Status → pipeline_stage, AI Agent State, Milestone, Phase, GSD Route)
  • Scaffold board configuration reference for use by subsequent mgw:board command (Add mgw:board command — create, show, and configure project board #72)
  • Provide machine-readable field schema in .mgw/board-schema.json and human-readable design in docs/BOARD-SCHEMA.md

Closes #71

Milestone Context

Changes

  • docs/BOARD-SCHEMA.md — 394-line board design documentation covering all 5 custom fields, GraphQL mutation templates, project.json board key schema, and planned board views
  • .mgw/board-schema.json — Machine-readable field definitions for mgw:board consumption (gitignored, local state)

Field Schema Summary

Field Type Options / Format
Status Single Select 13 options — 1:1 mapping to all pipeline_stage values
AI Agent State Text planner:running, executor:running, verifier:running, idle, blocked
Milestone Text Milestone title string from project.json
Phase Text <number> — <name> format
GSD Route Single Select quick, quick --full, plan-phase, new-milestone

Test Plan

  • Board schema captures all 13 pipeline_stage values in Status field options
  • GSD Route options cover all 4 known routes
  • project.json board key schema is documented (for mgw:board to write after creation)
  • GraphQL mutation patterns are present for each field type
  • Design is coherent and implementable in Add mgw:board command — create, show, and configure project board #72 (mgw:board command)
  • .mgw/board-schema.json is valid JSON and contains all field definitions

GSD Artifacts

  • Phase directory: .planning/phases/13-board-foundation-field-schema/
  • Plan: 13-01-PLAN.md
  • Summary: 13-SUMMARY.md
  • Verification: 13-VERIFICATION.md

…ields

Add docs/BOARD-SCHEMA.md documenting the full GitHub Projects v2 board
field schema for MGW pipeline visibility. Defines 5 custom fields:
- Status (single-select, 13 options mapping 1:1 to pipeline_stage values)
- AI Agent State (text, shows active GSD agent)
- Milestone (text, from project.json)
- Phase (text, number + name format)
- GSD Route (single-select, 4 options for all known routes)

Includes GraphQL mutation templates, project.json board key schema,
and board view planning for downstream issues (#72-#79).

Closes #71

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Design and scaffold GitHub Projects v2 board with MGW custom fields

1 participant