codestable/CodeStable

해결하는 문제

CodeStable은 장기적인 프로젝트에서 AI 지원 소프트웨어 개발을 위한 가벼운 '스킬 계약' 세트를 제공합니다. AI 에이전트가 시간이 지남에 따라 맥락이나 경계를 잃는 것을 방지하여, AI의 행동이 근거에 기반하고 프로젝트 경계를 존중하며 기존 프로젝트 문서에 지식을 통합하도록 보장합니다. 중복된 병렬 시스템을 생성하는 것을 피합니다.

작동 방식

복잡한 에이전트 오케스트레이션이나 고정된 스크립트 대신, CodeStable은 '얇은 하네스, 두꺼운 컨텍스트' 접근법을 사용합니다. 특정 스킬(예: cs-feat는 기능 구현용, cs-issue는 버그 수정용)을 정의하여 목표와 경계를 제약하면서도, AI 모델이 리포지토리의 사실에 기반해 실행 경로를 자유롭게 선택할 수 있도록 합니다.

핵심 메커니즘:

• 근거 기반 제공: 버그 수정의 경우 '레드에서 그린'과 같은 검증을 완료한 후에만 작업을 종료하도록 요구합니다.
• 프로젝트 메모리: 최소한의 스켈레톤(.codestable/)을 사용하여 핵심 프로젝트 사실(attention.md), 검증된 교훈(lessons/), 활성 작업 커서(work/)를 추적합니다.
• 공식 소유권: 문서 중복을 피하고, 안정적인 결론을 프로젝트의 원본 진실(ADRs, 코드, 기존 문서)로 되돌려 보냅니다.

대상 사용자

• 수개월에서 수년에 걸쳐 반복되는 소프트웨어 프로젝트를 수행하는 팀.
• AI가 효율적으로 실행되기를 원하지만, 인간이 제품 경계와 최종 승인을 유지하고 싶은 개발자.
• 검증 가능한 결과, 독립적인 리뷰, 다양한 AI 세션 또는 모델 간 지식 재사용을 우선시하는 팀.

주요 특징

• 스킬 기반 라우팅: 액션 라우팅, 온보딩, 기능 구현, 이슈 진단, 리팩터링, 에픽 관리, 리뷰, 메모리 관리에 특화된 8가지 전문 스킬 제공.
• 미니멀리스트 메모리: 프로젝트를 부풀리지 않는 구조화된 작은 디렉터리로 고가치 프로젝트 사실과 교훈을 저장.
• 에픽 이중 레이어 모델: 장기적 계약(목표/결정)과 일시적 실행 상태(진행 상황/근거)를 분리.
• 플러그인 생태계: Codex 및 Claude 플러그인 마켓플레이스와 통합 가능.