Add cloud agent instructions for issue-assigned agents

[Copilot]

❔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

• Add tests (E2E, unit tests) — N/A, documentation-only change
• Update RELEASENOTES.md — N/A, internal tooling, not user-facing
• Update documentation (e.g. for new settings or scenarios) — this is the documentation
• Add telemetry — N/A

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a dedicated instruction document for cloud agents assigned to issues, outlining required PR hygiene, repository architecture, and step-by-step guidance for implementing changes in AL-Go for GitHub.

Changes:

• Introduces a new cloud-agent instruction guide under .github/agents/.
• Documents required PR checklist items (release notes, tests, documentation, code quality).
• Summarizes repo architecture and common pitfalls to reduce incorrect PRs.

[mazhelez]

@copilot apply changes based on the comments in this thread

[Copilot]

@copilot apply changes based on the comments in this thread

Applied in 17f0d5d:

• Clarified that $errorActionPreference (camelCase) is this repo's convention, added a note to the snippet so agents don't second-guess it.
• Fixed the pwsh vs powershell contradiction: line 49 now explicitly distinguishes template workflows (powershell) from the repo's own CI workflows (pwsh).

[mazhelez]

@copilot please fix the pre-commit errors

[Copilot]

@copilot please fix the pre-commit errors

Fixed in d4eefe1. The mdformat hook was reformatting numbered lists (e.g., 2. → 1.) and horizontal rules (--- → ______________________________________________________________________). Ran mdformat --end-of-line=keep to apply the expected formatting.