Project Setup

Project Setup

Add a new GitHub repository as a tracked project in the workspace and install workflow automation.

Step 1: Parse the repo

Extract owner/repo from the user's message. If ambiguous, ask. Validate via GitHub API: http(method="GET", url="https://api.github.com/repos/{owner}/{repo}"). If 404 or no access, tell the user.

Step 2: Quick setup (3 questions, no timezone)

1. Who are the maintainers/reviewers? (default: the user's GitHub handle)
2. Do you use a staging branch? What's it called? (default: no staging; use staging if yes)
3. Any AI agents creating PRs? (e.g. Dependabot, Copilot, internal bots) (default: none)

Read main_branch from the API response's default_branch field.

Step 3: Create project in workspace

Write projects/<owner>-<repo>/project.md:

---
type: project
repo: <owner/repo>
added_at: <today YYYY-MM-DD>
maintainers: [<handles>]
main_branch: <branch from API>
staging_branch: <branch or null>
ai_agent_authors: [<bot handles>]
workflow_installed: false
---
# <owner/repo>
<description from API response>

## Workflow missions
(populated after install)

Write projects/<owner>-<repo>/notes.md:

# Notes: <owner/repo>
Developer notes for this project. Searchable via memory_search.

Step 4: Install workflow missions

Follow the github-workflow skill's install procedure. For each of the 6 mission templates in github-workflow/references/workflow-routines.md:

1. Replace {{repository}} with owner/repo
2. Replace {{slug}} with <owner>-<repo>
3. Replace {{maintainers}} with the maintainer list
4. Replace {{main_branch}} and {{staging_branch}} with the configured branches
5. Replace {{batch_interval_hours}} with 8 (default)
6. Call mission_create(name, goal, cadence) for each

If staging_branch is null, skip wf-staging-review-<slug>.

After installing, update the project file:

• Set workflow_installed: true
• List the installed mission names under ## Workflow missions

Step 5: Confirm

Added <owner/repo> as a tracked project:
- Project file: projects/<owner>-<repo>/project.md
- Workflow missions installed: <list>
- Maintainers: <list>
- Main branch: <branch>, Staging: <branch or "none">
- This repo is now included in your morning brief and triage scans

Say "add repo <another/repo>" to add more, or "remove repo <owner/repo>" to uninstall.