Coderrr

모든 작업은 편집이 아니라 서면 계획으로 시작한다. Coderrr는 코드를 읽고 관련 스킬을 모은 뒤, 다른 무엇보다 먼저 requirements.md, design.md, tasks.md를 생성한다. 계획이 사용자에게 제시되고 도구는 멈춘다. 이게 중요한 이유는 파일이 바뀌기 전에 평범한 문장으로 방향을 고칠 수 있기 때문이며, 잘못된 패치를 되돌리는 것보다 훨씬 저렴하다. 이 터미널용 코딩 도구를 작업하며 편집하는 에이전트와 갈라놓는 핵심 루프다.

에이전트는 편집을 자제하라는 요구를 받지 않는다. 계획하는 동안 편집 도구가 아예 없다. 쓰기 도구는 모델의 도구 목록에서 완전히 빠져 있고, 승인이 그것을 푸는 사건이다. 정중한 요청이 아니라 구조적 안전장치이며, 실제 저장소에 AI를 겨눌 때 의미 있는 차이다.

Coderrr에는 작업 트리에 명령을 실행하는 도구가 없다. 명령은 샌드박스에서 돌고, 에이전트는 실제 종료 코드와 출력을 읽는다. 기본 scratch 계층은 프로젝트의 일회용 복사본을 쓰므로 잘못된 지시의 피해 범위가 좁아진다. Docker가 있으면 네트워크를 끄고 모든 권한을 제거한 컨테이너로 자동 업그레이드한다. 이 업그레이드가 중요한 이유는, 네트워크에서 격리된 컨테이너가 실행 중 승인하지 않은 의존성을 당겨오거나 엔드포인트를 호출하는 것을 막기 때문이다.

계획은 .coderrr/specs/NNN-slug/에 있고 코드와 함께 커밋하도록 되어 있다. 문서 이상으로 에이전트의 기억 역할도 한다. 나중 세션이 대화 기록을 재생하는 대신 tasks.md를 읽고 상황을 파악한다. 승인 전에 그 파일들을 고쳐 작업을 이끌 수 있다.

Coderrr는 모든 공급자에 순수 HTTP로 접근하므로 공급자 SDK가 설치되지 않는다. Ollama, Anthropic, OpenAI, Google, OpenRouter를 지원한다. 기본값은 Ollama를 통한 gemma4:31b-cloud이며 무료 계정에서 쓸 수 있다. API 키는 먼저 환경 변수에서, 다음으로 OS 키링에서, 마지막으로 제한된 권한으로 쓰인 설정 파일에서 해석된다.

스킬은 어떤 부류의 문제를 어떻게 다룰지 적은 markdown 안내로, 에이전트가 필요하다고 판단할 때 가져오고 쓴 뒤 삭제한다. 실행 가능한 능력을 더하지 않으므로, 형편없는 스킬은 이미 도구가 제한된 에이전트에게 나쁜 조언을 줄 수밖에 없다. 같은 레지스트리를 coderrr skills search로 직접 둘러볼 수 있다.

자체 MCP 서버를 연결할 수 있고, 그 도구들이 Coderrr가 호출할 수 있는 도구가 된다. Figma, Linear, Notion, 혹은 회사 내부의 무언가다. 클라이언트가 이 도구의 다른 연결과 마찬가지로 순수 HTTP라 추가 설치가 필요 없다. 세션 안에서 URL을 붙여 넣으면 설정이 끝난다.