# Project Setup

> Add a GitHub repository as a tracked project — creates workspace entity, installs workflow automation missions, and includes in dev brief scope.

- Skill: `suyoumo/project-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add suyoumo/project-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/suyoumo/project-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: suyoumo (https://skillmd.com/u/suyoumo)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/suyoumo/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.
```