code-abyss
무엇인가
code-abyss는 코딩 에이전트의 성격·문체·판단 규율을 하나의 런타임으로 묶어 주입하는 프롬프트 팩이다. 규율 대상은 세 가지로 나뉜다. 답변의 어조, 결정을 내리는 방식, 그리고 보안·설계·운영 같은 도메인 판단이다. 페르소나가 목소리를 정하고, 문체 파일이 출력 형식을 정하며, 커널이 언제 반대하고 언제 범위를 자르는지를 정한다.
어떻게 동작하나
설치하면 세 층이 에이전트에 들어간다. config/personas/*.json이 목소리를, output-styles/*.md가 문체를, skills/_kernel/*이 판단을 담당한다. 커널은 상시 로드되지 않고 라우터가 필요할 때 호출하는 지연 로딩 방식이라, 항상 켜져 있는 부분은 철칙·스킬 라우팅·우선순위 기준·안전 하한으로 작게 유지된다. 개별 스킬은 SKILL.md로 두고 본문을 짧게 가져가며 무거운 내용은 references/로 분리한다. v5에서는 캐릭터 유지 Stop 훅이 기본 켜짐이다.
무엇과 다른가
프롬프트를 직접 쓰거나 단일 CLAUDE.md에 규칙을 몰아넣는 방식과 구조가 다르다. 성격과 판단을 분리해 두고 조합으로 적용하며, 판단 규칙은 프롬프트에 상시 박아 넣지 않고 라우터를 통해 호출 시점에만 불러온다. 규칙을 늘려도 컨텍스트 예산이 같이 늘지 않는 구조다. cultivating-skills·cultivating-personas는 반복 작업을 스킬로 증류해 로컬→프로젝트→커뮤니티 순으로 배포하는 자기 진화 경로를 둔다.
어떻게 쓰나
설치는 npx [email protected] -t claude -y 한 줄로 끝난다. -t 값을 codex·gemini·openclaw로 바꾸면 대상 에이전트가 바뀐다. Claude Code 플러그인으로 넣으려면 claude plugin install code-abyss를 쓴다. 재설치 없이 페르소나와 문체만 교체하려면 npx code-abyss compose -t claude --persona <slug> --style <slug>를 쓰고, 상태 점검은 npx code-abyss doctor로 한다.
전제와 한계
Claude Code를 기본 대상으로 하고 Codex CLI·Gemini CLI·OpenClaw도 지원한다. v5부터 code-abyss는 abyss 바이너리를 내려받지 않고 claude/codex/gemini용 그래프 훅도 직접 심지 않는다. 코드 그래프가 필요하면 별도 제품인 abyss Rust CLI를 설치한 뒤 abyss attach claude로 붙인다. openclaw·pi·hermes처럼 훅 표면을 abyss CLI가 소유하지 않는 대상은 --with-hooks로 번들 훅 스크립트를 실행해야 한다. npm 패키지에는 abyss 페르소나만 들어 있고 나머지 페르소나는 첫 사용 시 GitHub에서 받아 캐시한다.