Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks.

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

이것이 무엇인가

AI 기반 코딩 어시스턴트(Codex, Claude Code, OpenCode, DeepSeek, Kimi 등)에 엔지니어링 규율을 추가하는 메서드 팩입니다.
런타임이나 데몬을 제공하지 않으며, 호스트 에이전트가 호출할 수 있는 "스킬", 정책, 검증 단계 집합을 제공합니다.

왜 중요할까

에이전트를 계속 지켜봐야 하는 필요성을 줄여줍니다("베이비시팅 중단").
안전성 향상: 저자들의 벤치마크에서 계약 통과율이 약 62%에서 약 93%로 상승했고, 안전하지 않은 결과는 0%로 떨어졌습니다.
"완료" 전에 증거를 제공합니다 – 에이전트는 작업 완료를 선언하기 전에 새로운 증거(예: 테스트 결과, 설계 검토)를 생성해야 합니다.
단순한 요청은 단순하게 유지합니다; 무거운 절차는 작업이 정말로 필요할 때만 추가됩니다.

핵심 개념

개념	역할
기준선 정렬	편집 전에 에이전트가 현재 프로젝트 기준선(소유자, 계약, 경계)을 확인하여 추측을 방지합니다.
증거 기반 완료	에이전트가 검토할 수 있는 검증 산출물(테스트, 설계 검토, 위험 분석)을 첨부해야 합니다.
폐기 트리거	오래되었거나 "유령" 코드 경로를 추적하고 자동으로 폐기하여 조용한 기술 부채를 방지합니다.
UI/UX 거버넌스	UI/UX 설계 규칙을 적용하고 범위가 제한된 경험 증거를 생성하는 선택적 스킬(`ui-ux-governance`).
멀티 호스트 지원	많은 AI 코딩 호스트(Codex, Claude Code, OpenCode, DeepSeek Harness, Kimi 등)에 플러그인으로 설치 가능한 팩입니다.
TDD 모드	`off`, `auto`, `strict`로 설정 가능; 켜면 에이전트가 테스트 우선 워크플로우로 작업을 라우팅합니다.
활성화 모드	`automatic`(기본값) 또는 `explicit`; 호스트 시작 시 팩이 자동 활성화되는지 여부를 제어합니다.

설치(빠른 시작)

AI 코딩 에이전트에게 다음 프롬프트를 보냅니다(필요 시 호스트 이름 변경):

Read https://github.com/GanyuanRan/Aegis, identify my current AI coding host, and install Aegis globally using the correct host guide. …

에이전트가 호스트별 플러그인 명령을 실행합니다(예: dsh plugin --profile <profile> add "git+https://github.com/GanyuanRan/Aegis.git").
설치 후, doctor 스크립트로 검증합니다:
```
cd <aegis-method-pack-root>
python scripts/aegis-doctor.py --write-config --json
```
성공 시 "ok": true, "workspaceSupport": "available", "configStatus": "configured"를 포함한 JSON이 반환됩니다.

(선택 사항) 동일한 doctor 스크립트로 활성화 또는 TDD 모드를 전환합니다, 예:

python scripts/aegis-doctor.py activation-mode explicit
python scripts/aegis-doctor.py tdd-mode auto

지원 호스트 (README 기준 상태)

완전 검증됨: Codex, OpenCode.
가이드 제공, 스모크 테스트 대기 중: Claude Code, CodeBuddy, DeepSeek-TUI, DeepSeek Harness, Trae, GitHub Copilot, Qoder, Kimi Code CLI, ZCode, Grok Build, CC GUI (JetBrains IDEA).
구조적 지원만: Antigravity CLI/IDE/App, Pi CLI, OMP, OpenClaw, Hermes Agent.
폐기됨: Gemini CLI.

측정된 벤치마크

동일 모델(gpt-5.6-sol / xhigh)을 사용한 고정 A/B 벤치마크(120회 실행, 20개 사례).
계약 통과율: 61.67% → 93.33% (+31.67pp).
안전하지 않은 결과: 13.33% → 0%.
결과는 참고용이며 독립적인 감사가 아니며, Aegis 2.7.6(2026-08-11)에만 적용됩니다.
전체 데이터와 방법론은 benchmarks/ 및 docs/current/AEGIS_AGENTIC_BENCHMARK_BASELINE.md에 있습니다.

런타임 경험(선택 사항)

저자들은 또한 Autoloom을 제공합니다. 이는 Aegis 메서드를 코딩 워크플로에 통합하는 Windows 전용 데스크톱 클라이언트입니다. Autoloom은 무료이지만 소스는 공개되지 않았습니다; 변경 필요성 분석, 복잡성 거버넌스, 전달 검토를 위한 UI를 제공합니다.

일상적인 사용 방법

설치 후 평소처럼 에이전트와 대화하면 됩니다. Aegis 동작을 호출하려면 명령에 접두사를 붙이세요, 예:

Aegis 목표: 기존 계약을 깨지 않고 인증 모듈 리팩터링.
호스팅 버전을 먼저 출시할지에 대해 저를 심문하세요.
TDD 경로: strict

팩은 경량 빠른 경로를 실행할지 전체 증거 수집 워크플로를 수행할지 자동으로 결정합니다.

개발 및 테스트

종단 간 테스트 스위트: bash tests/e2e/run-all.sh --full --host-profile fast.
경계 준수, 워크플로 품질, 설치 검증 등에 대한 대상 검사(tests/e2e/ 스크립트 참조).
기여 지침은 CONTRIBUTING.md에 있습니다.

라이선스

MIT 라이선스.

결론: Aegis는 기존 AI 코딩 에이전트에 규율 있는 엔지니어링 관행을 적용하여 출력을 더 안전하고 신뢰할 수 있게 만들면서 개발자 워크플로를 가볍게 유지하는 오픈소스 "메서드 팩"입니다.

요약: Aegis는 AI 코딩 에이전트(Codex, Claude Code, OpenCode, DeepSeek 등)에 규율 있고 증거 기반의 워크플로를 추가하는 오픈소스 메서드 팩입니다. 안전성을 향상시키고(벤치마크에서 계약 통과율 +31pp, 안전하지 않은 결과 0%로 감소), 작업이 완료로 표시되기 전에 증거를 제공하며, 플러그인 설치를 통해 여러 호스트를 지원합니다. 설치는 에이전트에 대한 단일 프롬프트 후 검증 스크립트를 실행하는 것으로 완료됩니다; 선택적 활성화 및 TDD 모드를 전환할 수 있습니다. 이 프로젝트는 MIT 라이선스이며 벤치마크, 광범위한 문서, 그리고 메서드를 보여주는 Windows 데스크톱 클라이언트(Autoloom)를 포함합니다.