using-aegis
This is the entry point that decides whether Aegis needs to route your request to a specialized skill or just handle it directly.
SKILL.md
Full skill instructions
<SUBAGENT-STOP>Skip for subagents.</SUBAGENT-STOP>
<EXTREMELY-IMPORTANT> You have Aegis. Load explicit/relevant Aegis skill before response/action; otherwise proceed normally. </EXTREMELY-IMPORTANT>Hot Path
- User/project instructions outrank Aegis.
- Active codebase question/"what next": check baselines
(README/ADR/rules/
docs/aegis/baseline), else bounded index-first scan. Create baselines only with evidence. /aegis-goalorAegis goal:loadsgoal-framingbefore routing.- Bug, failure, regression, or unexpected behavior routes to
systematic-debugging; quick bug lane owns Change Necessity before source edits. - Classify before implementation/start/resume/compaction. Low: intent + baseline check + TDD Route + verification. Medium/high: baseline read-set + plan. TDD default off; auto/explicit => strict/light/skipped; off=no auto, verify. Spec Brief or Design Spec only for complexity, ambiguity, contracts, or cross-module impact. Contract/shared/core/cross-module changes are never low without evidence. Source edits/any new source-code path: owner workflow surfaces Change Necessity.
- Aegis Reason Note / Visibility Non-Omission: if Aegis skill is loaded and not tiny fast-path, first substantive user-visible stage gives one natural sentence: why Aegis is shaping the task + quality risk reduced; do not wait for user to ask where Aegis was used. Tiny fast-path may stay implicit. structured trace only for audit/debug/release/long-task review/asked; Trace Digest on-demand. Trace does not route; behavior/owner skill route first.
- Mark ArchitectureReviewRequired: yes for medium/high architecture, contract, cross-module, owner, source-of-truth, fallback/adapter, or project-baseline tasks; carry to verification-before-completion.
- Workspace support is lazy; use configured Aegis workspace support only when records needed. Fast Q&A/status/tiny edits write no files.
- Load smallest needed skill/reference.
- Tool/log/memory/search outputs are evidence candidates, not prompt payloads; summary first; large inputs use bounded index->window->excerpt.
- No historical sessions/transcripts/history.jsonl/.codex/sessions/~/.claude/projects/large logs by default; read requested evidence with scope/time/line bounds.
- Unclear host tool-name mapping: read smallest relevant reference.
Contract: Route: fast-path; Aegis Reason Note.
