scaffold-github-cloud-agent-environment

Make the target repository ready for Copilot cloud agent to build and validate changes. Start with repository and session evidence; consult relevant official GitHub documentation when a platform contract is uncertain, stale, or changing.

Decision Tree

What is the user asking for?

• No .github/workflows/copilot-setup-steps.yml exists yet: Audit the repo, verify unresolved platform assumptions, draft a plan, resolve material blockers, then preview and scaffold the workflow.
• A copilot-setup-steps.yml file already exists but looks thin, stale, or incorrect: Inspect the workflow and failure evidence, then make the smallest justified repair while preserving custom steps. Use regeneration only for a deliberate replacement after previewing the diff and ensuring a recoverable backup.
• 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 only the references needed for the open question, then answer without scaffolding.

Quick Reference