# DEMIURGOS: 개발 AI 에이전트를 위한 통합 규칙 시스템
코드 생성 AI 에이전트들은 종종 프로젝트 특성을 무시하며 일관성 없는 결과를 내놓습니다. 해결책은 DEMIURGOS입니다. 이 시스템은 팀의 모든 코딩 에이전트에 대해 자동으로 단일 규칙 세트를 생성하고 유지합니다.
DEMIURGOS 아키텍처: 세 층 제어 구조
DEMIURGOS는 중복 없이 유연성을 보장하는 세 층 아키텍처로 구축되었습니다.
- 핵심 (.rules/): 프로젝트 규칙의 중앙 저장소. 기술 스택, 코딩 표준, 아키텍처 패턴, 제약 조건을 정의합니다.
- 네이티브 어댑터: 특정 AI 에이전트에 맞춘 핵심 규칙의 경량 프로젝션. 예: Cursor용 .cursor/rules/*.mdc, Claude Code용 CLAUDE.md, GitHub Copilot용 .github/copilot-instructions.md. 규칙은 복제되지 않고 핵심을 참조합니다.
- 확장(Extensions): 다중 에이전트 시스템이나 MCP(Model Context Protocol) 통합 같은 복잡한 시나리오를 위한 선택적 층. 정말 필요할 때만 생성합니다.
실제 적용 사례: 다양한 기술 스택 예시
이 시스템은 다양한 기술 환경에서 빛을 발하며, 디버그 모드로 규칙 누락을 발견합니다.
Google AdInline article slot
Godot 4.3와 GDScript를 활용한 게임 개발
체력 컴포넌트를 만들 때 에이전트는 노드 컴포지션과 시그널을 사용한 타입화된 코드를 규칙에 따라 생성합니다. 디버그 모드(/debug full)로 누락된 부분을 발견:
- 입력 액션 이름 규칙 부재 (예: player_dash).
- 쿨다운 시작 시그널을 통해 UI와 능력 연결 규칙 부족.
- 일시정지 지원을 위해 SceneTreeTimer 대신 Timer 노드 사용 제안.
Async SQLAlchemy를 사용한 Python 백엔드
주문 API에서 에이전트는 세 층 아키텍처 규칙, 커스텀 예외, 배치 쿼리를 적용합니다. 디버그 결과:
- 라우터에서 예외-HTTP 상태 매핑 규칙 없음.
- SELECT FOR UPDATE를 사용한 경쟁 조건(race condition) 규칙 부재.
- 서비스의 flush()와 라우터의 commit() 구분 불명확.
Astro와 SolidJS를 활용한 프론트엔드
테마 토글 기능을 만들 때 에이전트는 Islands Architecture와 UnoCSS 규칙을 준수합니다. 누락된 부분:
Google AdInline article slot
- 인라인 <head> 스크립트를 통한 FOUC 방지 전략 부재.
- 브라우저 API용 범용 try/catch 규칙 없음.
- 상태 관리에서 createSignal과 createStore 선택 불확실.
DEMIURGOS 도입의 주요 이점
이 규칙 시스템을 채택하면 개발 팀에 뚜렷한 성과를 가져옵니다.
- 코드 일관성: 모든 AI 에이전트가 동일한 표준을 따르며, 리뷰와 리팩토링 시간을 단축합니다.
- 신속 온보딩: 신입 개발자가 git으로 규칙을 가져오면 에이전트가 즉시 팀 코드에 맞는 코드를 생성합니다.
- 지속적 개선: 디버그 모드(/debug)로 10~20개 프롬프트 후 규칙 누락을 발견하고 우선순위로 수정. 흔한 영역:
- 게임 프로젝트의 게임 디자인 규칙.
- 백엔드의 비즈니스 로직과 트랜잭션.
Google AdInline article slot
- 프론트엔드의 브라우저 API 엣지 케이스와 접근성.
- 22+ 도구 지원: 단일 핵심 규칙 세트를 Cursor, Windsurf, Claude Code, GitHub Copilot, Kiro, JetBrains AI Assistant 등 어댑터로 투영.
- 최소 오버헤드: 규칙이 리포지토리 파일로 존재하므로 추가 인프라나 복잡한 설정 불필요.
주요 요약
- DEMIURGOS는 중앙 규칙으로 AI 에이전트의 프로젝트 맥락 부족을 해결합니다.
- 세 층 아키텍처로 코드 중복 없이 유연성을 유지합니다.
- 디버그 모드로 규칙 누락을 발견해 지속 개선합니다.
- 팀 전체 일관성을 위해 22+ 개발 도구 지원.
- 구현으로 에이전트 관리 시간 단축과 코드 품질 향상.
— Editorial Team
아직 댓글이 없습니다.