GanyuanRan/Aegis

Aegis – 신뢰할 수 있는 AI 코드 생성 에이전트를 위한 메서드 팩

무엇인가요 – Aegis는 Codex, Claude Code, DeepSeek Harness, GitHub Copilot 등 다양한 AI 코드 생성 호스트에 추가할 수 있는 메서드 팩 (프롬프트, 설정 파일, 보조 스크립트의 모음)입니다. 새로운 모델이나 데몬을 제공하지 않으며, 호스트가 신중한 소프트웨어 엔지니어처럼 행동하도록 하는 체계적인 워크플로우 계층을 추가합니다.

왜 중요한가요 – AI 코드 에이전트는 강력하지만, 안전하지 않거나 불완전한 변경 사항을 생성할 수 있어 인간의 검토가 필요합니다. Aegis는 다음을 통해 이러한 "감시"를 줄이려 합니다:

• 어떤 편집도 수행하기 전에 실제 프로젝트 기준선에 따라 계획을 수립.
• 작업을 "완료"로 선언하기 전에 최신 검증 증거(테스트, 계약 검사)를 요구.
• 단순한 요청은 빠른 경로로 처리하면서 위험한 작업에만 자동으로 의식을 추가.
• 폐기된 코드 경로를 추적하여 숨겨진 기술적 부채를 방지.

핵심 주장 (리포지토리 자체 벤치마크로 입증됨)

메트릭	Aegis 없음	Aegis 있음
계약 통과율	61.7 %	93.3 %
안전하지 않은 결과	13.3 %	0 %
이 수치는 gpt-5.6-sol / xhigh 설정을 사용한 고정 A/B 벤치마크(120회 실행, 20개 사례)에서 나왔습니다. README는 증거가 참고용이며 보편적인 보장은 아니라고 강조합니다.

사용 방법

1. 설치 – AI 코드 에이전트에게 단일 프롬프트를 제공하여 리포지토리를 읽고 사용 중인 호스트를 감지한 후 호스트별 설치 명령어를 실행하도록 지시합니다 (예: dsh plugin --profile <profile> add "git+https://github.com/GanyuanRan/Aegis.git").
2. 검증 – 제공된 scripts/aegis-doctor.py 스크립트를 실행합니다. 성공적인 JSON 출력에는 "ok": true, "workspaceSupport": "available", "configStatus": "configured"이 포함되어야 합니다.
3. 활성화 – 팩은 기본적으로 자동 활성화 및 TDD 비활성화입니다. 동일한 도ctor 스크립트로 명시적 활성화 또는 자동 TDD로 전환할 수 있습니다.
4. 상호작용 – 설치 후에는 일반적으로 에이전트와 대화할 수 있지만, Aegis 전용 트리거를 추가할 수 있습니다:
   • Aegis goal: … – 범위, 성공 증거, 경계를 정의.
   • Grill me … – 단일 질문 결정 인터뷰 시작.
   • TDD Route: strict / test-first – 테스트 우선 워크플로우 강제.
   • aegis:update – 호스트 인식 경로를 통해 메서드 팩 업데이트.

지원되는 호스트 – 팩은 많은 인기 있는 코드 생성 도구에 대한 설치 가이드를 제공합니다. 일부 호스트는 가이드만 제공(최신 스모크 테스트는 아직 없음), 일부 호스트(Codex, OpenCode)는 이미 벤치마크 증거가 있습니다.

개발 및 테스트 – 리포지토리는 설치, 워크플로우 품질, 호스트별 준수성을 검증하는 엔드투엔드 테스트(tests/e2e/*.sh) 세트를 포함합니다.

커뮤니티 – README에서 디스커션, 이슈 추적, DEV.to 기사 링크를 확인할 수 있습니다. 프로젝트는 MIT 라이선스이며, 이전의 Superpowers 프레임워크를 기반으로 합니다.

결론 – 이미 AI 코드 어시스턴트를 사용 중이고, 계획, 검증, 리스크 인식 라우팅을 추가하여 더 체계적인 엔지니어처럼 행동하게 하고 싶다면, Aegis는 호스트에 의존하지 않는 즉시 사용 가능한 메서드 팩을 제공합니다.