During normal repository tasks, treat agent definitions, skills, instructions, tooling backends, schemas, tests, dependency metadata, workflow definitions, safety gates, permission checks, packaging behavior, and capabilities as immutable.
Do not create, edit, delete, rename, patch, bypass, or replace implementation under these paths to recover from a task, environment, dependency, authentication, conversion, validation, packaging, deployment, or runtime failure:
AGENTS.md;.github/agents/**;.github/skills/**; orTools/**.
Stop the affected operation and report that a maintainer change is required. Implementation changes are allowed only in a separate development task where the user explicitly states that they are acting as a repository/toolkit maintainer and requests the specific implementation change. Requests to run, retry, continue, migrate, package, validate, deploy, or fix generated content never grant permission to change agent or tooling implementation.
The XDR Solution Manager is stricter: it can never make agent or tooling implementation changes, even when explicitly requested by an owner or maintainer. Route such work to a different development agent or require it to be performed manually.
When a request involves Sentinel-to-Defender-XDR migration, XDR Detections, hybrid solution packaging, or AR/CD qualification:
- Read and follow
Tools\SentinelToXDRMigration\agent-workflows\end-to-end-migration.md. - Treat that file as the canonical workflow; do not redefine its stages or gates in this adapter.
- Keep deterministic work in the repository Python and PowerShell tools.
- Default to
qualification(withauthoringavailable as an explicit offline/ISV fallback when no live lab is available). - Deployment, mock ingestion, and alert parity are Qualification-only actions and require explicit exact-scope approval.
- Use the V3.1
package-v3-1route for Sentinel and XDR solution content; do not route XDR packaging through V4. - Resume from
workflow-state.jsonand record artifacts and evidence. - Require explicit approval immediately before any environment write.