# DEFERRED: GitHub Copilot Coding Agent Setup

## STATUS
- state: blocked
- created: 2026-02-14
- last-checked: 2026-02-14
- priority: P1
- blocked-by: human-action (subscription purchase) + dependency (P0-github-pro-upgrade)
- estimated-effort-once-unblocked: 10 minutes (human subscribes + enables, AI verifies)

## WHAT
Enable GitHub Copilot coding agent so issues can be assigned to `@copilot` for automated branch creation, code writing, and PR opening. This is the GitHub-native AI agent that reads `AGENTS.md` and `copilot-setup-steps.yml`.

## WHY BLOCKED
Copilot coding agent requires Copilot Pro ($10/month), Pro+ ($39/month), Business, or Enterprise subscription. Free Copilot does NOT include the coding agent. Additionally, the account must be unflagged and on GitHub Pro for full functionality.

## UNBLOCK TRIGGER
Human confirms: "Copilot Pro is enabled" OR AI detects:
```bash
# Check Copilot status
gh api user --jq ".copilot"
# Or check settings page programmatically
```

## WHAT HUMAN NEEDS TO DO
1. Ensure P0-github-pro-upgrade is resolved first
2. Go to: https://github.com/settings/copilot
3. Subscribe to Copilot Pro ($10/month) or higher
4. Enable these settings:
   - "Copilot coding agent" = **Enabled**
   - "Allow Copilot to open pull requests" = **ON**
   - "Allow Copilot to push to branches" = **ON**
5. Confirm to AI agent: "Copilot coding agent is enabled"

## WHAT AI DOES ONCE UNBLOCKED
1. Verify Copilot is active on the repo
2. Verify `copilot-setup-steps.yml` exists (already created at `.github/copilot-setup-steps.yml`)
3. Verify `AGENTS.md` exists and is up to date (already created)
4. Test: assign a small issue to `@copilot` to verify end-to-end flow
5. Create `.github/copilot-instructions.md` if not present (repo-wide Copilot instructions)
6. Optionally create `.github/agents/` for custom agents with MCP tools
7. Mark resolved, move to `deferred/resolved/`

## CROSS-REFERENCES
- prompt: God-Mode L1, Phase 1.6 (Copilot Coding Agent Setup)
- files: `.github/copilot-setup-steps.yml` (exists), `AGENTS.md` (exists), `.github/copilot-instructions.md` (to create)
- issues: all issues with label `agent:copilot` become actionable
- depends-on: P0-github-pro-upgrade (Pro plan, though Copilot Pro is separate billing)
- unlocks: issue-to-PR automation, `@copilot` assignments, AI agent triage
