GanyuanRan/Aegis
AI 코딩 에이전트를 위한 기준-우선, 증거-기반의 워크플로우 방법론 팩
579+24이번 주0 찜
30포크0이슈
중간맛 분석
스택: Shell 기반 method pack, Python 스크립트 (doctor, update), 다중 호스트 지원 (Claude Code, Codex, OpenCode, CodeBuddy, DeepSeek-TUI, GitHub Copilot 등). 난이도: AI 에이전트 사용자가 자연언어로 명령하면 자동으로 트리거되므로 진입 장벽 낮음. 바로 쓸 수 있나: 설치 후 즉시 에이전트와 대화할 때 Aegis 방법론이 자동 또는 명시적으로 작동. 데모/검증: / 파이프라인(ci.yml), E2E 테스트 스크립트, 호스트별 검증 정책 제공.
이런 레포예요
이럴 때 쓰면 좋아요
- AI 에이전트가 아키텍처를 무시하고 코드를 마구 작성하는 것을 방지할 때
- 복잡한 버그 수정 전에 체계적인 디버깅 절차가 필요할 때
- 코드 완료 전에 검증 증거를 강제하여 품질을 보장하려고 할 때
핵심 기능
기준-우선 워크플로우(변경 전 현재 상태 파악)증거 기반 완료 선언(검증 없이 완료 불가)복잡도별 자동 라우팅(간단한 작업은 경량, 위험할수록 상세함)다중 호스트 이식성(Codex, Claude Code, OpenCode, GitHub Copilot 등 지원)
대안 대비 차별점
Superpowers의 composable skills 기반을 유지하면서 소프트웨어 아키텍처 이해 및 실증적 검증을 method-pack 수준에서 의무화하는 체계화된 엔지니어링 규율을 제공합니다.
준비물
- AI 코딩 에이전트 호스트(Claude Code, Codex, OpenCode, CodeBuddy 등)
- Python 3.x
바로 시작하기
- AI 에이전트에게 아래 지시문을 복사해 전달합니다.
요청: 'https://github.com/GanyuanRan/Aegis'를 읽고, 내가 현재 사용하는 AI 코딩 호스트를 파악한 후 해당 호스트의 설명에 따라 Aegis를 전역 설치하세요. 필요하면 호스트 재시작 여부를 명확히 알려주세요. 그 후 설치된 Aegis method-pack 루트 디렉토리에서 검증을 실행하세요. `<aegis-method-pack-root>` 위치를 먼저 찾고 다음을 실행합니다: `cd <aegis-method-pack-root> && python scripts/aegis-doctor.py --write-config --json`. JSON 출력에 `"ok": true`, `"workspaceSupport": "available"`, `"configStatus": "configured"`가 포함되어야만 설치 완료입니다.
- 설치 후 호스트를 재시작합니다 (필요시).
- 자연언어로 개발 작업을 설명하면 Aegis 방법이 자동으로 트리거됩니다.
예: "로그인 후 로그인 페이지로 돌아가는 버그를 수정하되, 인증 시스템은 다시 쓰지 말아줘"
- 명시적으로 특정 skill을 지정하려면:
aegis:systematic-debugging
aegis:first-principles-review
aegis:verification-before-completion
- 향후 업데이트는 "Aegis 업데이트" 또는
aegis:update명령으로 수행합니다.
별 추이 · 7일
579+24 / 7일
활용성 · 따라 만들기 좋은가
베스트 샘플샘플 점수 64/100
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
이 레포에 깃밥 배지 달기
[](https://www.gitbap.com/r/GanyuanRan/Aegis)🔌 클로드에서 바로 써보기
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
방법 ① 커넥터 URL
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp방법 ② 플러그인 (체험까지)
플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기