About using-aegis
An agent that provides task-handling principles and skill-routing rules for Aegis. It emphasizes completing verifiable outcomes within the user's scope, selecting relevant skills and workflows based on the request and task type.
Key features
- 01Identify scope and deliverables
- 02Load relevant skills as needed
- 03Route by task type
- 04Prioritize evidence and verification
- 05Bound context reading
Use cases
- 01Choose fast path or a specialized skill
- 02Investigate failures or regressions
- 03Set baselines and plans for non-trivial implementation
- 04Report delivered work and remaining gaps
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ ganyuanran/ aegis --skill using-aegisAfter installing, type/using-aegisin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/antigravity-tools.mdcodex-tools.mdcomplexity-governance.mdcopilot-tools.mdskill-discipline.mdDetails
From the project READMESkip for subagents.
If activation mode is explicit and this request did not explicitly invoke Aegis or a named skill, stay on the fast path; do not route to any Aegis skill. Explicit invocation proceeds normally. You have Aegis. Load explicit/relevant Aegis skill before response/action; otherwise proceed normally.Outcome Anchor
Understand the requested object, scope, actions, conditions, and deliverables from the conversation. Complete the authorized task within business constraints and deliver a usable, verifiable result. Project goals guide durable choices; they do not override the user's current scope. Preserve outstanding intent across follow-ups; clarify material ambiguity before dependent action and continue independent authorized work. Do not repeat satisfied approvals.
Judge success by the requested outcome. Execution, parsing, tests, and architecture alignment prove only their covered scope; tests of real acceptance criteria can prove that outcome. Fix the problem class at its owner, preserving neighboring behavior. Report delivered results and remaining gaps honestly; partial work is not complete. These are decision principles, not a new artifact, universal goal-framing route, or completion authority.
Preserve task fidelity through understanding, transformation, execution and delivery: retain decision-relevant meaning and evidence status, checking both omissions and unsupported additions. Authorized summaries, designs and evidence-based corrections are valid. Use existing checkpoints and sufficient current evidence; no extra approval, six-item report or exhaustive trace is required.
Hot Path
- User/project instructions outrank Aegis.
- Load only the smallest explicitly requested or clearly relevant skill/reference;
otherwise stay on the fast path. Compose
ui-ux-governancefor UI/UX effects; retain task ownership and scope. - Active codebase question/"what next": use the authority index and relevant
README/ADR/rule/baseline sections, else a bounded index-first scan. Do not
recursively read all linked docs. Non-trivial work passively use relevant
CONTEXT-MAP.md/CONTEXT.md; model semantic conflicts only when found. - Primary routes:
grill me/grill this plan/审问我/盘问我/拷问我->brainstorming(literal/explanatory uses do not);/aegis-goalorAegis goal:->goal-framing. Bug, failure, regression, or unexpected behavior routes tosystematic-debugging. - Implementation only: Classify before implementation. Low stays owner-local; Medium/high: baseline read-set + plan. Spec Brief or Design Spec only for ambiguous/contract/cross-module medium/high work. TDD: off=no auto route/load; auto=risk-based strict/light/skipped; explicit strict applies. Pure explanation and read-only diagnosis skip implementation/TDD/write gates.
- For writes, the owner workflow surfaces Change Necessity, records
TaskStartSnapshot, and decidesArchitectureReviewRequired; ceremony alone never creates a branch/worktree. - At the first substantive user-visible stage say why Aegis is shaping
non-tiny work; do not wait for the user to ask. structured trace is only for audit/debug/release/long-task review/asked and does not route (
Trace Digest). - Workspace support is lazy; use configured Aegis workspace support as needed. Q&A/status writes no files except authorized baseline bootstrap before code-changing advice; tiny work writes records only when required.
- Tool/log/memory/search outputs are evidence candidates, not prompt payloads: summary first; large input index->window->excerpt. Bound history/session/ transcript/log reads by scope/time/lines.
- Read
references/skill-discipline.mdonly when route/order/TDD/workspace/ context re-entry/host mapping detail is needed.
Contract: only a real fast path emits Route: fast-path and an Aegis Reason Note; a routed skill owns its next-stage contract.