scaffold-github-cloud-agent-environment

Audit the target repository first, then scaffold or repair GitHub Copilot cloud agent's development environment around the current live GitHub Docs contract.

Decision Tree

What is the user asking for?

• No .github/workflows/copilot-setup-steps.yml exists yet: Verify the live docs, audit the repo, draft a plan, ask only the targeted questions that repo signals cannot answer, then scaffold the workflow.
• A copilot-setup-steps.yml file already exists but looks thin, stale, or incorrect: Audit what is there, compare it to the live docs, choose refresh mode, and regenerate a deterministic workflow that preserves the documented contract.
• Agent runs fail or behave strangely after scaffolding: Run doctor mode first, use session-log evidence and repo facts to identify whether the fix is in-repo or in GitHub settings, then patch only what the evidence supports.
• The user only wants explanation or planning: Read references/live-docs.md, references/project-analysis.md, references/patterns.md, and references/doctor-mode.md, then answer without scaffolding.

Quick Reference