Add guided WORKFLOW bootstrap for GitHub Projects

[BetterAndBetterII]

Context

Issue #13 needs first-run WORKFLOW.md setup to pick or create a GitHub Project instead of leaving ProjectV2 wiring to manual edits.

TL;DR

Add a guided GitHub Project bootstrap for missing WORKFLOW.md files.

Summary

• Add an interactive bootstrap flow that can discover or create ProjectV2 boards and reconcile Symphony status options.
• Wire CLI first-run bootstrap through the guided path while keeping the baseline template fallback for non-interactive runs.
• Update docs and targeted tests for guided setup, auth guidance, and bootstrap failure modes.

Alternatives

• Keep the static template only and continue requiring manual ProjectV2 owner/number edits.
• Split spec and implementation into separate PRs, which would delay the packaged-release follow-up.

Test Plan

• make -C elixir all
• cd elixir && mix test test/symphony_elixir/cli_test.exs test/symphony_elixir/default_workflow_test.exs test/symphony_elixir/github_client_test.exs test/symphony_elixir/workflow_bootstrap_test.exs

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces a detailed specification for an interactive bootstrap process for WORKFLOW.md files, particularly focusing on integration with GitHub Projects. The goal is to provide a guided setup experience for users, streamlining the initial configuration of GitHub-backed workflows and reducing manual editing. It outlines the expected behavior for the command-line interface, defines the steps for interactive project setup, and specifies how authentication and project management should be handled.

Highlights

• CLI Behavior Clarification: The specification now clarifies CLI behavior when the default WORKFLOW.md file is missing, detailing that it should be bootstrapped, potentially interactively, rather than simply erroring.
• Guided GitHub Project Bootstrap: A comprehensive specification for a guided GitHub Project setup flow has been added, covering authentication resolution, project discovery and creation, status field reconciliation, and selection of Codex defaults.
• Expanded Validation Matrix: The recommended validation matrix has been expanded to include interactive and failure-mode checks specifically for the new guided bootstrap path, ensuring robustness and clear error handling.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog

• SPEC.md
  • Revised CLI behavior for handling missing WORKFLOW.md files, introducing interactive bootstrapping.
  • Introduced a new section detailing the guided GitHub Project bootstrap process, covering authentication, project discovery, creation, status reconciliation, and Codex defaults.
  • Specified failure modes and guidance for the interactive bootstrap process.
  • Updated implementation milestones to reflect the new guided bootstrap.
  • Expanded validation matrix to include interactive and failure-mode testing for the guided bootstrap.

Activity

• No human activity has occurred on this pull request yet.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request introduces a detailed specification for an interactive WORKFLOW.md bootstrap process. The changes are concentrated in SPEC.md and clearly define the behavior for a guided GitHub Project setup, including authentication, project discovery, and failure handling. The specification is well-structured and thorough. I have one suggestion to improve clarity regarding the Backlog state, which is created during bootstrap but not used as an active or terminal state.

_{Note: Security Review has been skipped due to the limited scope of the PR.}