ganyuanran avatar

Brainstorming

This is the skill you reach for before writing any code on non-trivial work. It enforces a hard gate: if you're building a new feature, changing architecture, or tackling anything medium-to-high complexity, you stop and design first. The workflow walks you through project context, asks clarifying questions one at a time, proposes multiple approaches with trade-offs, and builds up working artifacts like TaskIntentDraft and BaselineUsageDraft. It includes complexity budget checks and multiple review lenses to catch product risk and architecture drift before they become code. Once you've got approval on the design, it hands off to writing-plans. The discipline here is refusing to scaffold or implement until the spec is actually ready.

GitHub stars
492
last updated
Jun 11, 2026

Install

$ npx -y skills add ganyuanran/aegis --skill brainstorming --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

Choose the route before reading references:

Sponsors

Details

Repository
github.com/ganyuanran/aegis
Category
Documentation
License
MIT
First seen
Jun 11, 2026

More from ganyuanran/aegis

All 22
1golbin avatarreview-implementationgolbin/agent-skillsReview implementation against provided markdown requirements, specs, PRDs, or phase docs; optionally apply focused fixes. Use when a user supplies .md file path0skills.sh installs
2hoangnguyen0403 avatardev-fixhoangnguyen0403/agent-skills-standardUnified developer workflow for fixing bugs. Analyzes issue-tracker context, cross-checks docs/code, proposes a solution, implements the fix, verifies locally, a0skills.sh installs
3hoodini avatarvideo-edithoodini/ai-agents-skillsEdit any video into a captioned showcase — transcribe (any language, defaults to large-v3), present a transcript_review.txt for the user to fix mishears BEFORE 0skills.sh installs
4huangjia2019 avatarapi-conventionshuangjia2019/claude-code-engineeringAPI design patterns and conventions for this project. Covers RESTful URL naming, response format standards, error handling, and authentication requirements. Use0skills.sh installs
5intertwine avatardspy-evaluation-harnessintertwine/dspy-agent-skillsBuild DSPy evaluation harnesses with rich-feedback metrics that are essential for GEPA optimization. Use when writing a metric function, calling dspy.Evaluate, 0skills.sh installs
6intertwine avatardspy-rlm-moduleintertwine/dspy-agent-skillsUse dspy.RLM (Recursive Language Model) for reasoning over contexts too large to fit in an LLM's working window — entire codebases, long logs, massive documents0skills.sh installs