Add cloud agent instructions for issue-assigned agents (#2248)
### ❔What, Why & How Adds `.github/agents/issue.instructions.md` — instructions for cloud agents that get assigned to issues and create PRs. **Basic PR requirements:** - When to update `RELEASENOTES.md` (action/template/workflow changes, bug fixes) - Test expectations: Pester naming conventions, cross-platform (PS5/PS7), mocking - Documentation: settings in `Scenarios/settings.md` + `settings.schema.json`, scenario docs - Code quality: standard header, secret masking, encoding, JSON handling **Repository architecture reference:** - Action anatomy: `action.yaml` → `Invoke-AlGoAction.ps1` → `<Action>.ps1` → `AL-Go-Helper.ps1` - Template layout: PTE vs AppSource variants, which workflows are shared - Module structure under `Actions/.Modules/` - Test organization and CI matrix **Step-by-step guides for adding features:** - Adding/modifying settings (code → schema → docs → tests) - Adding a new action (folder, action.yaml, script, tests, workflow integration) - Adding/modifying workflows (dual-template consistency, YAML conventions) - Modifying shared helpers (caller analysis, backward compat) **Common pitfalls section** covering dual-template sync, path separators, PS5/PS7 differences, schema drift. **Clarifications added from review feedback:** - Explicitly notes that `$errorActionPreference` (camelCase) is this repo's convention, so agents don't confuse it with canonical PowerShell casing. - Clarifies the shell convention distinction: template workflows use `powershell`, the repo's own CI workflows use `pwsh`. ### ✅ Checklist - [x] Add tests (E2E, unit tests) — N/A, documentation-only change - [x] Update RELEASENOTES.md — N/A, internal tooling, not user-facing - [x] Update documentation (e.g. for new settings or scenarios) — this *is* the documentation - [x] Add telemetry — N/A --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: mazhelez <43066499+mazhelez@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
C
Copilot committed
8be9109b08703ea8d37b04ad3149fd801ed34bf0
Parent: 6ce99a8
Committed by GitHub <noreply@github.com>
on 6/8/2026, 3:45:30 PM