NEKOWORK — AI 코드 변경을 위한 검증형 오토파일럿

Fri, 08 May 2026 00:00:00 +0900

개요

Ps-Neko/NEKOWORK는 2026-04-29에 처음 푸시되고 2026-05-08에 0.1.0-alpha.8까지 올라온, 1인 개발자가 만든 npm 패키지다. 이름은 귀엽지만 표방하는 자리는 진지하다 — “Verified Autopilot for AI code changes”. Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode 위에 얹는 한 겹의 런타임으로, AI가 짠 코드가 사람의 레포에 들어가기 전까지 evidence를 만들고 독립 검증을 거치고 사람의 승인을 받는 흐름을 강제한다. 100개짜리 에이전트 카탈로그가 아니라 검증 루프 자체를 제품으로 삼는다는 포지셔닝이 특이하다.

graph TD
 Task["사용자 task <br/> nekowork auto"] --> Build["build <br/> (single executor)"]
 Build --> Verify["verify <br/> (Codex 독립 검증)"]
 Verify --> Repair{"fixable?"}
 Repair -->|yes| Build
 Repair -->|no| Report["report <br/> REPORT.md"]
 Report --> Gate{"Human Gate"}
 Gate -->|approve| Apply["apply <br/> (명시적 명령)"]
 Gate -->|block| Stop["NO_SHIP"]
 Apply --> Done["git apply --3way <br/> commit/push는 사람이"]

1. NEKOWORK가 가장 먼저 거부하는 것

README의 첫 화면이 곧 제품 설명이다.

No auto-commit. No auto-push. No surprise deploy.

Cursor의 Composer 자동 모드, Aider의 auto-commit 기본값, 또는 Devin 같은 풀 오토 에이전트가 모두 “사람이 마우스 한 번도 안 누르고 PR이 올라간다"를 자랑할 때, NEKOWORK는 정확히 그 자리를 거부한다. apply는 항상 별도 명령이고, auto 명령은 --apply 플래그를 명시적으로 거절한다.

대신 NEKOWORK가 만드는 건 evidence다 — work-summary.json, verify-summary.json, ship-summary.json, gate-summary.json, 그리고 사람이 읽는 첫 화면인 REPORT.md.

2. 하나의 매니페스트, 다섯 개의 표면

agent.yaml이 진실 원본이다. 거기엔 에이전트, 스킬, 훅, 프로필, 모듈, MCP 핀이 한 곳에 적혀 있고, 빌더 스크립트가 그것을 다섯 개의 하네스 디렉터리로 투영한다.

타겟	출력 디렉터리	빌더
Claude Code	`.claude/`	`scripts/build-claude.js`
Codex CLI	`.codex/config.toml`	`scripts/build-codex.js`
Cursor	`.cursor/`	`scripts/build-cursor.js`
Gemini CLI	`.gemini/`	`scripts/build-gemini.js`
OpenCode	`.opencode/`	`scripts/build-opencode.js`

이 패턴은 gitagent 스펙 (spec_version: gitagent/0.1.0)을 따른다. 같은 발상은 continue.dev의 hub, Anthropic의 Skill에서도 보이지만, NEKOWORK는 한 단계 더 나아가서 **“카탈로그는 빌드 산출물”**이라는 입장을 분명히 한다. 하네스가 사라져도 매니페스트는 살아남는다.

SOUL.md에 한 줄로 정리돼 있다 — “Claude Code 가 사라져도 Codex · Cursor · Gemini · OpenCode · 사내 LLM 위에서 동일한 카탈로그가 동작해야 한다.”

3. 핵심 invariant — executor 한 명, verifier 한 명

ARCHITECTURE.md에 못박혀 있다.

다중 워커 단계는 기본 read-only
한 work 사이클에 한 명의 executor만 프로젝트 파일을 수정
Codex 리뷰가 기본 독립 검증 경로
민감한 변경은 Codex challenge 또는 Human Gate 필수
프로필은 기능을 추가할 수 있지만 안전 게이트는 못 약화시킨다

team 명령으로 여러 워커가 동시에 생각해도 산출물은 read-only handoff다. 실제 수정은 work 단계에서 단 하나의 executor가 한다. 이게 NEKOWORK가 “100개 에이전트 팩"이 되지 않는 이유다 — 카탈로그 크기가 아니라 mutation 단일화가 제품의 약속이다.

이 발상은 git의 single-writer index, 데이터베이스의 single-leader replication 같은 시스템 디자인 패턴을 AI 에이전트 레이어로 가져온 것이다. 여러 에이전트가 같은 파일을 동시에 만지는 멀티 에이전트 시나리오에서 충돌과 race condition을 보면 이 결정이 이해가 간다.

4. CLI surface — 의도적으로 작다

nekowork --help에서 보이는 공개 명령:

check — 로컬 readiness 검사
ask — provider 없이 목표/범위/위험 명확화
plan — planning handoff
team — 여러 워커의 read-only handoff
work — single executor 구현 + isolated diff
verify — Codex 전용 검증
gate — Human Gate approve/block
ship — ship/no-ship readiness
report — REPORT.md 생성 (프로젝트 mutation 없음)
apply — 검증된 SHIP_READY diff를 명시적으로 적용
run — work -> verify -> ship 묶음
build — 한 명령 빌더 wrapper (fast/safe/team/tdd/release)
auto — apply 경계 전까지 bounded autonomy

Aider나 Claude Code의 명령 표면과 비교하면 흥미롭다. Aider는 인터랙티브 채팅에 가깝고, Claude Code는 슬래시 명령 + 스킬 조합인데, NEKOWORK는 파이프라인의 각 단계가 명시적인 CLI 명령이다. work는 verify를 안 돌리고, verify는 ship을 안 돌리고, ship은 절대 apply를 안 한다. 각 단계가 자기 일만 한다는 Unix 철학을 AI 에이전트 워크플로에 적용한 셈이다.

5. Risk classifier와 mode safety

manifests/build-modes.json에 fast, safe, team, tdd, release 다섯 모드의 안전 순서가 적혀 있고, build 명령은 task를 분류해서 적절한 모드를 자동으로 고른다. 그리고 명시적 downgrade를 거부한다 — README에 박힌 예시:

build "change OAuth token validation" --mode fast
# Blocked: auto routing recommends `safe`

--force-mode로 우회할 수는 있지만, 그건 “내가 이 downgrade를 의도적으로 받아들인다"는 명시 선언이고 evidence에 기록된다. npm semver의 strict mode, Kubernetes admission controller와 같은 발상 — 기본은 안전, 우회는 명시적, 우회는 감사 가능.

6. Provider auth — 장기 API key는 기본 차단

흥미로운 디테일. NEKOWORK는 delegated CLI auth를 기본으로 둔다. claude auth status, codex login, gemini 같은 로컬 CLI 세션을 사용하고, ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY 같은 장기 환경변수는 provider 호출 전에 차단한다.

Risk: provider-auth / long-lived-secret
Codex verdict: request_changes
Human Gate: required

명시 opt-in이 필요하다 — HARNESS_AUTH_ALLOW_ENV_OVERRIDE=1. 이건 Anthropic의 권장 보안 패턴, GitGuardian의 secret hygiene 보고서와 같은 흐름이다. 솔로 개발자가 처음부터 이걸 기본값으로 깔아둔 건 드물다.

7. 1인 개발자의 깊이 — 평가

NEKOWORK는 별 0개, fork 0개의 알파다. 그런데 레포 구조를 보면 1인 사이드 프로젝트치고는 깊이가 비정상적이다.

293 tests / 0 moderate+ npm audit issues — alpha 단계인데 풀 CI
docs/ 35+ 파일 — ARCHITECTURE / SAFETY-GUARANTEES / TRUST-MODEL / WHY-NOT-AUTOPILOT까지
CODE_OF_CONDUCT.md, SECURITY.md, CONTRIBUTING.md — OSS 위생 완비
.mcp.json, bridge/mcp-server.js — MCP gateway 내장
8 case-study flows / 5 starter packs — 실제 외부 run evidence 수집 중

비교군을 보면 위치가 더 또렷해진다.

Cline — 백만 다운로드, 인터랙티브 에이전트 IDE 통합 중심
Aider — 30k stars, git-native AI 페어 프로그래밍
Devin — 풀 오토 에이전트, 클로즈드 소스
continue.dev — IDE 확장 + hub 카탈로그
Block의 Goose — 로컬 에이전트 프레임워크

이 모든 도구가 “AI가 얼마나 빨리/잘 짜는가"를 경쟁하는데, NEKOWORK만 **“AI가 짠 걸 어떻게 검증하고 멈추는가”**를 경쟁한다. 시장 포지셔닝으로는 Chef InSpec이나 Open Policy Agent에 가깝다 — compliance 레이어로서의 AI 에이전트 런타임.

8. 솔로 개발자 사이드 프로젝트의 좋은 형태

NEKOWORK는 별이 0개고 외부 검증이 거의 없는 알파 단계 도구다. 솔직하게 말하면, 이 도구가 6개월 안에 사라질 가능성도 충분히 있다. 그런데도 이 레포가 흥미로운 이유는 1인 개발자가 스스로 정한 invariant를 코드로 강제한 방식 때문이다.

카탈로그를 키우는 유혹을 거부 — “100개 에이전트 팩이 아니다"라고 README 첫 화면에 박았다.
Human Gate를 회피할 수 없게 만듦 — auto 명령이 --apply를 받지 않는 건 코드 레벨의 결정이지 문서 권고가 아니다.
하나의 매니페스트가 다섯 표면을 만든다 — 특정 벤더 도구가 사라지는 시나리오를 처음부터 가정.
장기 API key를 기본 차단 — solo dev가 첫날부터 secret hygiene를 기본값으로.

이건 Linus Torvalds의 “talk is cheap, show me the code”의 작은 버전이다. AI 에이전트 안전성에 대해 글을 쓰는 사람은 많지만, 자기 워크플로의 invariant를 CLI 동작으로 박아넣은 사람은 드물다.

인사이트

NEKOWORK가 시장에서 살아남을지는 모른다. @ps-neko/nekowork@alpha 패키지가 6개월 뒤에도 active일지, 아니면 1인 개발자의 또 다른 archived 레포가 될지는 시간이 답한다. 하지만 이 레포에서 가져갈 수 있는 건 명확하다 — AI 코딩 도구의 다음 경쟁은 “얼마나 빨리 짜는가"가 아니라 “어떻게 멈추고 어떻게 증명하는가"가 될 가능성. Cursor의 Composer, Anthropic의 Claude Code, GitHub Copilot Workspace, Devin이 자동화 폭을 늘리는 동안, NEKOWORK는 정반대 방향으로 evidence/Human Gate/explicit apply에 베팅한다. 이 베팅은 엔터프라이즈/금융/의료 도메인에선 결국 표준이 될 가능성이 높다 — SOC 2, ISO 27001, EU AI Act의 audit 요구가 AI 에이전트 워크플로에도 그대로 내려올 것이기 때문이다. 솔로 개발자 한 명이 이 자리를 먼저 잡았다는 것 자체가 흥미롭고, 한국 개발자 입장에서 가장 빨리 시도해볼 수 있는 건 npx -y @ps-neko/nekowork@alpha check 한 줄로 자기 레포에 한 번 돌려보는 것이다.

참고

Repository

Core docs

Comparable AI coding tools

Related ecosystem

Side Project on ICE-ICE-BEAR-BLOG