Copilot: AEGIS agents or slash commands do not appear in Copilot Chat.
Open the repository root as the VS Code workspace, not a subfolder. Switch Copilot Chat to Agent mode. Update VS Code and Copilot Chat if the agent picker is missing.
No module named artifact_tools
In a clone, run pip install -e . in the active environment, or set PYTHONPATH=src. Anywhere else, including with the plugin, run pip install aegis-sdlc.
python is not found on Windows.
Use py -3 or install Python from python.org with "Add to PATH" selected.
Hooks do not run.
Hooks are configured in .github/hooks/validate-artifacts.json (Copilot), .claude/settings.json (Claude Code clone) and the plugin's hooks/hooks.json, and call python. Make sure python on your PATH has PyYAML installed.
Agents say "Enterprise Standards MCP unavailable".
implementation readiness lists every blocking finding with a code. The common ones:
Code
Fix
artifact-not-approved
Review the artifact and set status: approved once it is agreed.
artifact-missing
Finish the phase that produces it: ideation for business artifacts, architecture for technical ones.
artifact-tbd
Resolve the remaining TBD content.
open-decision
Resolve the open decision that the artifact marks as blocking implementation.
contracts-missing
Add native contract files under interfaces/ for every active IF-*.
adr-proposed / adr-unaccepted
Accept, reject or supersede the proposed ADRs.
standards-review
Verify current Enterprise Standards, then pass --standards-review verified. Without a library, a person must do this review. See Running without a library.
target-missing / target-conventions
Pass the correct absolute path to the target repository. It needs repository instructions or a build manifest that the agents can follow.
The guard runs before file edits and shell commands from every agent. Implementation
agents get the strictest rules; everyone else is kept out of the target repository.
Reason
Fix
"No single active work package authorizes implementation changes."
Approve a work package and move it to in-progress.
"Target writes require an in-progress work package; review packages are read-only."
Move the package back to in-progress to make changes.
"No initialized implementation state resolves this target operation."
Run /start-implementation so the implementation state exists.
"Destructive commands require explicit human approval..."
Expected. Approve the command yourself if it is intended.
"Deployment requires an explicitly approved release gate."
Expected. Deployment needs the release gate and a person's approval.