WoJiSama/skill-based-architecture

해결하는 문제

코딩 에이전트는 분산된 프로젝트 규칙, 여러 파일(CLAUDE.md 또는 .cursorrules 등)에 중복된 지침, 그리고 명확한 "완료 정의"의 부재로 어려움을 겪는 경우가 많습니다. Skill-Based Architecture (SBA)는 이러한 흩어진 지침을 단일의 루트 가능하고 검증 가능한 프로젝트 "스킬"로 통합하여, 에이전트가 구현 범위를 추측하지 않고 프로젝트의 실제 비즈니스 로직과 아키텍처 규칙을 정확히 따를 수 있도록 보장합니다.

작동 방식

SBA는 에이전트가 리포지토리를 탐색하는 데 사용하는 프로젝트 수준의 운영 계약을 제공합니다. 하나의 거대한 지침 파일을 로드하는 대신, 에이전트는 다음과 같은 단계를 수행합니다:

1. 재산 목록화: 리포지토리를 조사하여 기존 규칙을 식별합니다.
2. 선택: 사용자 요청에 따라 특정 워크플로우를 선택합니다.
3. 로드: 현재 결정에 필요한 증거와 지식만을 로드합니다.
4. 바인딩: 현재 코드 소유자에게 비즈니스 의미를 연결합니다.
5. 검증: 명령어나 커밋을 단순히 "완료"로 보는 대신, 요청된 최종 상태와 결과를 비교하여 검증합니다.
6. 기록: 실패에서 재사용 가능한 학습을 기록하여 반복되는 오류를 방지합니다.

대상 사용자

프로젝트 지침이 너무 커서 탐색이 어려워졌거나, 다양한 에이전트 진입 파일 간에 모순이 발생하거나, 반복 작업에 엄격한 절차와 신뢰할 수 있는 완료 검증이 필요한 개발자 및 팀입니다.

주요 특징

• 중앙 집중식 지식: AGENTS.md, CLAUDE.md, Cursor 규칙 간의 중복을 제거합니다.
• 에이전트 독립성: Claude Code, Cursor, Windsurf, Gemini CLI 및 기타 파일 인식 에이전트와 호환됩니다.
• 증거 기반 실행: 결과 중심의 라이프사이클을 사용하며, 증거가 현재 전제를 무효화하면 로컬라이제이션 또는 분해로 돌아갑니다.
• 자동 마이그레이션: 기존 규칙을 SBA 구조로 마이그레이션하는 미리보기 및 적용 기능을 포함하는 스caffolding 도구 제공.
• 엄격한 완료 기준: 단순한 활동(예: 푸시 또는 커밋)이 아니라, 바인딩된 납품물과 최종 상태에 기반하여 "완료"를 정의합니다.