GanyuanRan/Aegis
Software-engineering method pack for coding agents, with skills for baseline-first planning, systematic debugging, prompt hygiene, verification before completion, and repair/retirement tracking.
Install
via npm
Resolves a published tarball rather than cloning the repository.
via GitHub · npm package
Due diligence
Aegis is a DeepSeek Harness plugin that gives coding agents a software-engineering method pack for planning, debugging, prompt hygiene, verification, and repair or retirement tracking.
It projects these methods into a skill-aware host rather than adding a separate coding tool. Before editing, the agent is expected to establish the project's real baseline, including owners, contracts, and boundaries. Before declaring completion, it should produce fresh verification evidence, identify the covered scope, and record residual risk. The pack also keeps retired fallbacks and old paths tied to a retirement trigger instead of leaving them as untracked technical debt. Simple tasks can remain on a fast path; the documented method is intended to add ceremony when the task needs it.
Aegis is aimed at coding-agent workflows where changes need explicit planning and evidence. It is less suitable when the host cannot load skills or when its existing workflow already provides the same planning and verification discipline. The README documents host-specific activation requirements, including native plugin installation for DSH and additional discovery checks where a host uses a separate skill directory.
The detected terminal surface matters: the plugin's verification flow runs commands such as python scripts/aegis-doctor.py --write-config --json from the method-pack root and may pass discovery-root and name-prefix options. That gives the agent a terminal-based path to inspect installation and workspace support, with the agent's available permissions.
Aegis is presented as a method pack projected into a skill-aware coding host. Its documented practices cover baseline-first planning, systematic debugging, prompt hygiene, verification before completion, and two-track repair or retirement tracking. The baseline is expected to include project owners, contracts, and boundaries. Completion evidence should be fresh, state the covered scope, and identify residual risk. Trivial requests can remain on the fast path.
The README requires verification from the installed method-pack root, not from the target project directory. Locate <aegis-method-pack-root> first, then run:
cd <aegis-method-pack-root> && python scripts/aegis-doctor.py --write-config --json
The installation is considered complete only when the JSON contains all of the following:
| Field | Required value |
|---|---|
ok |
true |
workspaceSupport |
available |
configStatus |
configured |
The --write-config option writes the configuration used by the doctor flow, while --json requests machine-readable output.
For the official DeepSeek Harness (dsh), the README specifies native profile-plugin installation with dsh plugin --profile <profile> add github:GanyuanRan/Aegis. The direct-child compatibility path should not be substituted unless the plugin manager is unavailable and compatibility mode is explicitly approved. Host activation and automatic-entry checks must also be completed; file discovery or a generic doctor result is not sufficient when the host defines a plugin, hook, or session-start bootstrap contract.
When a host uses a separate skill discovery directory, repeat verification with --discovery-root <path>. If its host guide defines a skill-directory name prefix, also pass --discovery-name-prefix <prefix>. The README names Codex, Claude Code, OpenCode, and Kimi as other skill-aware hosts.
Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub
Same category
superdesigndev
Design skill for UI and marketing graphics on the Superdesign canvas: reads the repo for context, extracts its design system, then generates and iterates branchable design drafts, flow pages, and reusable components through the Superdesign CLI.
Ikalus1988
Failure-recovery memory: search and record failure-recovery lessons from real engineering sessions, with BM25 + semantic RAG retrieval and a lessons knowledge base.
Vladimir-Human
Cleans AI traces from Russian text: finds chatbot copy-paste artefacts (ChatGPT, Gemini, Grok, Perplexity, DeepSeek) and rewrites the text into natural prose on request; 39 regex markers with an evidence registry, offline, text-only bundle.
dhicoc
Complete reverse-skill pack (85 SKILL.md) as a DeepSeek Harness Cordis plugin: reverse engineering, authorized pentesting and security-research skill router.
zhaiyateng
Design-aesthetics skill pack (10 styles: dark SaaS, minimal white, neumorphism, brutalism, glassmorphism, Japanese minimal, bento grid, cyberpunk, vaporwave, art deco) with runnable landing-page demos: tokens, component rules, forbidden lists, and acceptance checklists per style.
creght-dev
Skills for building websites on the Creght platform: CLI pull/push sync, page and component conventions, CMS, forms, auth, SEO, publishing and version rollback.
