Claude MarketplacesSubmit
ganyuanran avatar

Writing Plans

ganyuanran/aegis

This is the planning stage before you write any code. It takes approved specs or requirements and produces a detailed implementation plan saved to your docs folder, breaking work into bite-sized tasks with exact file paths, complete code snippets, and verification steps. The skill assumes the engineer executing the plan has zero context about your codebase, so it documents everything: which files to touch, what patterns to follow, how to test. It includes scope checks, compatibility boundaries, complexity budgets, and architecture integrity reviews before task decomposition. There's also a lightweight "planless slice" mode for tiny changes that already have a parent plan. Use this when you have multi-step work ahead and want executable tasks instead of vague directions.

GitHub stars
492
last updated
Jun 11, 2026
View on GitHub

Install

$ npx -y skills add ganyuanran/aegis --skill writing-plans --agent claude-code

Installs into .claude/skills of the current project.

Files

If activation mode is explicit (`~/.config/aegis/config.toml` has `activation_mode = "explicit"`, or `AEGIS_ACTIVATION_MODE=explicit` is visible in the environment) and the current user request did not explicitly invoke Aegis or this skill by name, exit back to the fast path: answer concisely without this workflow's checklist, ceremony, or document requirements. If the user explicitly named Aegis or this skill, proceed normally.

Execute

→ Existing parent plan/spec and a tiny execution slice? → Use Planless Slice Lane. → Mechanical or bounded change with no durable boundary (no new owner, contract, schema, public API, migration, or compat surface)? → Use Planless Slice Lane without a parent document. → Approved spec/requirements for a new workstream or an escalation trigger? → Write an implementation plan for an engineer with no prior task context.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/ganyuanran/aegis
Categories
Documentation, Productivity & Planning
License
MIT
First seen
Jun 11, 2026

More from ganyuanran/aegis

All 22

Recommended

More Documentation
1kaelio avatarwiki_capturekaelio/ktxktx's knowledge base - wiki pages for durable, reusable business knowledge. Covers capture workflow for user preferences, metric definitions, organizational con0skills.sh installs
2sunflowermm avatarxrk-docssunflowermm/XRK-AGT需要快速定位「该看哪份文档/哪段代码/哪份配置」时使用；提供文档导航与权威路径。0skills.sh installs
3syahiidkamil avatarhuman-writingsyahiidkamil/software-engineer-ai-agent-atlasWrite content in any language indistinguishable from a skilled human writer. Avoids AI-sounding phrases, varies sentence structure, creates natural prose. Detec0skills.sh installs
4tomcoolpxl avatarWriting Phaser 3 Gamestomcoolpxl/sugar-splatProvides battle-tested patterns, best practices, and code examples for building Phaser 3 games. Use when writing game code, implementing game mechanics, setting0skills.sh installs
5mattpocock avatarwriting-for-agentsmattpocock/skillsWriting documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.539.3Kskills.sh installs
6mattpocock avatarwriting-beatsmattpocock/skillsWriting, exploit — assemble raw material into a journey of beats, grounding each term before a beat leans on it.531Kskills.sh installs