devcodex-labs/devcodex

Intent-driven AI coding workflow runtime for consistent context, skills, approvals, validation, and handoffs across six AI coding hosts.

DevCodex – 의도 기반 AI 코딩 오케스트레이터

무엇인가요 – DevCodex는 기존 AI 코딩 어시스턴트(GitHub Copilot, Claude Code, Gemini CLI, Grok, Cursor 등) 위에 위치하는 Node.js 명령줄 허브입니다. 모델 자체를 대체하지는 않지만, 프로젝트 수준의 엔지니어링 계층을 추가하여 다음과 같은 기능을 제공합니다:

사용자 의도 해석 – 자연어 요청을 구조화된 작업(유형, 범위, 위험도, 필요 기술, 검증 기준)으로 변환합니다.
프로젝트 컨텍스트 관리 – 생성된 Profile(프로젝트 구조, 빌드/테스트 명령어, 아키텍처 제약 등)를 읽고 과거 작업, 체크포인트, 증거를 기억합니다.
적절한 "스킬" 로드 – 80개 이상의 도메인 전문 기능(예: API 설계, 보안 검토, 성능 튜닝)을 내장된 라이브러리에서 필요 시에만 로드합니다.
제어된 워크플로우 실행 – 개발, 수정, 분석, 감사, 재개, 채팅 등 여러 개발된 워크플로우 중 하나를 선택하고 확인 점, 자동 진행, 증거 기반 완료를 강제합니다.
장시간 작업 지원 – 세션 간에 작업 상태를 지속적으로 저장하고 안전하게 재개 가능하며, 다양한 AI 코딩 호스트 간 조율도 가능합니다.
증거 기반 인수 인계 – 작업 완료를 선언하기 전에 변경 사항, 실행된 테스트, 잔여 위험, 그리고 향후 재사용을 위한 "자기 진화" 후보를 보고합니다.

주요 기능 (README에 설명됨)

기능	기능 설명
의도 기반 실행	사용자는 목표만 제시하면 DevCodex가 워크플로우, 범위, 필요 기술, 검증 단계를 결정합니다.
다중 호스트 지원	Codex, Claude Code, Copilot, Gemini CLI, Grok, Cursor 등 6개의 AI 코딩 호스트를 공통 엔지니어링 계층을 통해 지원합니다.
80개 이상의 전문 스킬	프론트엔드, 백엔드, 보안, 테스팅, 성능, SRE 등 사전 패키지된 도메인 지식을 필요 시에만 로드합니다.
프로젝트 프로파일	리포지토리용 구조화된 "엔지니어 핸드북"(스택, 빌드/테스트 명령어, 아키텍처 경계, 계약)을 생성합니다. 증거 기반이며 시간이 지남에 따라 개선 가능합니다.
자동 모드	명시적인 `@devcodex-auto` (또는 별칭)를 실행하면 반복 확인 없이 계속 진행되지만, 원래 의도와 안전 검사를 존중합니다.
세션 간 복구	작업 ID, 체크포인트, 증거, 남은 작업이 `.devcodex/`에 지속 저장되어 새로운 채팅에서도 이전 상태에서 정확히 재개 가능합니다.
증거 기반 완료	작업 완료 전에 변경 사항, 테스트 결과, 빌드 결과, 잔여 위험, 다음 단계를 보고합니다.
제어된 자기 진화	반복적인 문제는 인간 승인 후 재사용 가능한 스킬로 전환 가능하며, 기존 규칙을 자동으로 덮어쓰지 않습니다.
병렬 작업 안전 분석	여러 작업을 실행하기 전에 파일 수준 충돌, 공유 상태, 머지 순서를 확인합니다.
세밀한 권한 모델	읽기 전용 분석, 파일 수정, Git 커밋, 푸시, 태그, 릴리스 등 각 작업에 명시적 승인이 필요합니다.
CLI 유틸리티	`devcodex init`, `status`, `doctor`, `runtime`, `governance ledger` 등 검사, 유지보수, 거버넌스용 명령어 제공.

누가 이득을 볼 수 있나요?

프로젝트 규칙을 존중하고 세션 간 컨텍스트를 잃지 않는 AI 지원을 원하는 개인 개발자.
재현 가능하고 감사 가능한 AI 생성 코드 변경이 필요하며 반복적인 엔지니어링 지식을 재사용 가능한 스킬로 캡처하고 싶은 팀.
여러 AI 코딩 도구를 단일 정책 기반 워크플로우로 통합하고 싶은 조직 (각 도구의 프롬프트를 다시 작성하지 않아도 됨).

성숙도 및 가용성

패키지: npm에 공개 (devcodex), README에 버전 배지 표시.
라이선스: AGPL-3.0.
Node 요구사항: >= 18.17.0.
문서: 전체 문서, 시작 가이드, 예제, API 참조는 https://devcodex-labs.github.io/devcodex/에 호스팅.
상태: 활발히 유지 관리 중 (README에 업데이트 절차, 거버넌스 레저, 스킬 진화 로드맵 기재).

빠른 시작 (README에서)

# 전역 설치
npm install -g devcodex

# 프로젝트 초기화 (.devcodex/, 스타터 프로파일 등 생성)
cd /path/to/your/repo
devcodex init

devcodex status   # 현재 준비 상태 확인

초기화 후 자연어 작업을 발행할 수 있습니다. 예:

현재 프로젝트에서 가장 우선적으로 해결해야 할 세 가지 문제를 분석해 주세요.
범위와 증거를 설명하고, 파일은 수정하지 말고 분석만 수행해 주세요.

DevCodex는 다음과 같이 동작합니다:

의도, 프로젝트, 안전한 읽기 전용 범위 식별.
관련 스킬 로드.
코드를 건드리지 않고 증거 기반 분석 생성.

더 알아보기

문서 사이트: https://devcodex-labs.github.io/devcodex/
시작 가이드: https://devcodex-labs.github.io/devcodex/guide/getting-started
예제 (세션 간 재개): https://devcodex-labs.github.io/devcodex/examples/resume
이슈 트래커: README에서 링크된 GitHub Issues 페이지.

결론

DevCodex는 기존 AI 코딩 어시스턴트에 견고하고 의도 기반의 오케스트레이션 계층을 추가하는 진정한 오픈소스 프로젝트로, 원시적인 코드 생성을 체계적이고 감사 가능한 소프트웨어 엔지니어링 워크플로우로 전환합니다.