Title: Feature: Get squads to use project boards · Issue #6 · github/squad · GitHub
Open Graph Title: Feature: Get squads to use project boards · Issue #6 · github/squad
X Title: Feature: Get squads to use project boards · Issue #6 · github/squad
Description: Summary Squad currently has no persistent, visual mechanism for agents to track the state of complex tasks. While logs exist, they are opaque and transient. This feature adds the capability for agents to autonomously create GitHub Projec...
Open Graph Description: Summary Squad currently has no persistent, visual mechanism for agents to track the state of complex tasks. While logs exist, they are opaque and transient. This feature adds the capability for age...
X Description: Summary Squad currently has no persistent, visual mechanism for agents to track the state of complex tasks. While logs exist, they are opaque and transient. This feature adds the capability for age...
Opengraph URL: https://github.com/github/squad/issues/6
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Feature: Get squads to use project boards","articleBody":"## Summary\n\nSquad currently has no persistent, visual mechanism for agents to track the state of complex tasks. While logs exist, they are opaque and transient. This feature adds the capability for agents to autonomously create GitHub Project boards (V2) and manage task progress (Todo, In Progress, Done) directly within the GitHub UI.\n\n## Goals\n\n1. **Visualize Agent Workflow** by mapping internal agent state to a GitHub Project Board.\n2. **Autonomously Initialize Boards** so agents can spin up tracking for new initiatives without user intervention.\n3. **Track Item Status** allowing agents to move tasks through columns (e.g., moving a task to \"Done\" upon completion).\n4. **Enhance Visibility** for human users to see exactly what the squad is working on at a glance.\n\n## Proposed Approach\n\n### Layer 1: GraphQL API Integration\n\n* Integrate a GraphQL client (using `https://api.github.com/graphql`) as the REST API has limited support for Projects V2.\n* Implement core mutations: `createProjectV2`, `addProjectV2ItemById`, and `updateProjectV2ItemFieldValue`.\n* Ensure the `GITHUB_TOKEN` or PAT has the required scopes (`project`, `repo`).\n\n### Layer 2: Board Initialization & Configuration\n\n* A tool/skill that allows the Lead agent to check if a specific Project Board exists.\n* If the board is missing, the agent creates it with default fields (Status) and options (Todo, In Progress, Done).\n\n### Layer 3: Task & Status Management\n\n* Logic to convert existing Issues into Project Items.\n* A \"Status Updater\" skill that agents call when completing a step, which updates the specific field value on the board item.\n* Agents can query the board to see pending items in the \"Todo\" column.\n\n## Notes\n\n* This requires using the **GitHub Projects V2 API (GraphQL)**; REST is not sufficient for V2.\n* The PAT used by the agents must have `project` (read/write) and `repo` scopes.\n* Ideally, the board columns should default to standard *Todo / In Progress / Done*, but could be configurable in the future.\n\n/cc @bradygaster","author":{"url":"https://github.com/londospark","@type":"Person","name":"londospark"},"datePublished":"2026-02-10T15:31:17Z","url":"https://github.com/github/squad/issues/6"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:900bd2d7-b90f-219f-9eff-cd8c4282caa6 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | B81E:1352CE:D54FF:119806:6B015EFB |
| html-safe-nonce | 249486690d634b4ef2aa066d265d82abd3d00ec9825fa480fe3b99c57e907fb4 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCODFFOjEzNTJDRTpENTRGRjoxMTk4MDY6NkIwMTVFRkIiLCJ2aXNpdG9yX2lkIjoiNDY4MTU2NzgzMTA3MzA1NDQ1OSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 44622a9193b078a03883db5f99a30a287ff295ab0c35d657ddebf6e96bc6e462 |
| hovercard-subject-tag | issue:3922132725 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/github/squad/6/issue_layout |
| twitter:image | https://opengraph.githubassets.com/75bfca1e2aae3a4af2ec7c4fc281590ed9fdb07b79965f69d73d8b7148e8f622/github/squad/issues/6 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/75bfca1e2aae3a4af2ec7c4fc281590ed9fdb07b79965f69d73d8b7148e8f622/github/squad/issues/6 |
| og:image:alt | Summary Squad currently has no persistent, visual mechanism for agents to track the state of complex tasks. While logs exist, they are opaque and transient. This feature adds the capability for age... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | londospark |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/github/squad git https://github.com/github/squad.git |
| octolytics-dimension-user_id | 9919 |
| octolytics-dimension-user_login | github |
| octolytics-dimension-repository_id | 1151205052 |
| octolytics-dimension-repository_nwo | github/squad |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1151205052 |
| octolytics-dimension-repository_network_root_nwo | github/squad |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | canary-2 |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width