This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

Aegis

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add github:GanyuanRan/Aegis

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

• Fewer reworks. Your agent aligns with your project's real baseline —
• Safer changes. Measured on a frozen held-out A/B benchmark: contract
• Proof before "done". Completion claims ship with fresh verification
• No ghost code. Retired fallbacks and old paths are tracked or removed
• Simple tasks stay simple. Trivial requests stay on the fast path;

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Can I use it immediately after installation?

You need to restart the corresponding DSH profile for it to take effect. The installation instructions require first running dsh plugin list and dsh --dump-config to confirm that the aegis-method-pack line appears, then restart the session.

Will every question go through a full process after installation?

No. The routing rules require the Agent to declare a fast path for simple tasks, and only expand the full method for higher-risk tasks involving multi-step implementation, shared modules, or contract changes.

Will it write files to my project?

No by default. Only when the workflow needs to keep baselines, plans, checkpoints, or evidence, it will create records on demand in the docs/aegis/ directory of the target project. Regular Q&A and small changes don't produce files.

Will it force me to write tests by default?

No, TDD mode defaults to off. When needed, you can run aegis-doctor.py tdd-mode auto to enable automatic routing by risk, or simply write strict TDD or test-first in your question.

If I install it in web profile, can I use it in headless profile?

No, DSH plugin dependencies are isolated by profile, so you need to run the installation command separately for each profile you want to use.

How to uninstall?

Run dsh plugin remove aegis for the target profile, then use dsh --dump-config to confirm the output no longer contains the aegis-method-pack line.

— source: plugin_wiki.faq_json

Compatibility

• DSH: 0.1.0-rc.6+（以可选 peerDependencies 形式声明）
• Node: 未声明

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule