// naholo · coding ops, end to end
[ 인가 등급: 오퍼레이터 ]

AI에 떠넘기기는 거기까지,
이젠 직접 지휘하세요.

naholo는 AI 코딩을 브리핑 → 계획 → 구현 → 보고라는 규율잡힌 하나의 사이클로 진행합니다. 에이전트는 부사관으로서 작전 수행을 준비, 각 단계별로 작은 검토 창구를 제공하여, 당신이 지휘관으로서 빈틈없이 그리고 지체없이 작전을 진행할 수 있게 돕습니다.

작전 시작야전 교범 보기 open source · MIT
// 01 · Estimated yield

숫자가 증명합니다.

< 5분

각 체크포인트 별로 검토에 걸리는 시간입니다. 설계부터 코드 작성까지, 결코 과도한 텍스트량에 파묻힐 일이 없습니다.

30–60%*

토큰 소모 절감. 단계마다 계획량을 조절해 낭비되는 컨텍스트가 줄어듭니다.

~3×*

처리량. 어느 오퍼레이터는 5일짜리 작업을 1.5일 만에 끝냈습니다.

* 수치는 일부 사례 기준입니다. 5분 미만 리뷰 창은 설계상 보장됩니다.

// 02 · Workflow

하나의 사이클로 모든 작전을

가공되지 않은 아이디어에서 철저하게 리뷰된 코드 작성까지, 간결하지만 핵심을 잡아주는 체크포인트를 통해, 에이전트는 더 빠르게, 당신은 빈틈없이 작전을 수행할 수 있습니다.

  1. 1
    정보 확보/infil/fob

    유저 피드백이나 가공되지 않은 아이디어를 웹앱이나 코드베이스에서 수집하여 에이전트에게 제공합니다.

  2. 2
    방향성 결정/warno검토 시간 < 5분

    주어진 정보를 토대로 솔루션에 대해 컨샙/아키텍처 레벨의 사양을 결정합니다. 태스크나 코드 내용 없이 간단한 리스트의 형태로 제공합니다.

  3. 3
    계획 수립/opord각 태스크 별 검토 시간 < 5분

    컨샙/아키텍처 레벨의 사양을 커밋 하나 크기의 태스크로 깎아냅니다. 작성된 계획은 세세한 코드가 아닌 모듈 레벨의 사양을 변경을 기술하여, 사람이 여전히 빠르게 리뷰할 수 있게 합니다.

  4. 4
    구현/splash각 태스크 별 검토 시간 < 5분

    에이전트가 위에서 정해진 태스크 하나를 수행합니다. 구현 중에 계획과 벗어난 부분은 사후 보고를 통해, 사람이 빈틈없이 확인할 수 있도록 하며, 필요에 따라 추가 수정을 할 수 있게 돕습니다.

  5. 5
    반복

    다음 태스크 검토 후, 문제가 없다면 /splash, 수정이 필요하다면 /opord로 조정하며 태스크를 계속 진행합니다.

  6. 6
    결산/exfil

    작전 문서와 토큰 사용량을 서버에 기록합니다. 실수가 많을 수록 토큰 사용량이 현저하게 늘어나므로, 이를 통해 에이전트와 사람의 작전 수행 능력을 반성하고 개선할 수 있게 돕습니다.

// 03 · contracts

3가지 체크포인트를 통한 철저한 검토

통제되지 않은 에이전트는 사람이 소화할 수 없을 만큼 텍스트를 찍어냅니다. 이에 사람에겐, 바이브 코딩을 하며 문제를 무시하거나, 억지로 읽으려다 번아웃에 직면하는 선택지만 남게 됩니다. naholo는 에이전트의 출력량을 조절해 하나의 문서로 정리하고, 작은 체크포인트를 만들어내어 사람이 여유롭게 그리고 신속하게 결정을 내릴 수 있게 합니다.

Warning Order(준비명령)
/warno
아키텍처 검토

구현 계획을 쓰기 전에 몇 가지의 아키텍처 결정만 검토합니다. 몇 분이면 되고, 큰 그림만을 그리므로 결정을 번복해도 토큰 소비가 제한됩니다.

Operation Order(작전명령)
/opord
구현 계획 검토

커밋 하나 단위로 태스크를 나누고, 각 태스크는 모듈의 인터페이스와 내부 흐름이 어떻게 바뀌는지에 대해 명세합니다. 구현 계획은 코드가 아니라 인터페이스, 개념적인 작업 흐름 수준에 머무르므로 번복이 되더라도 토큰 소비도 적고, 빠르게 검토할 수 있습니다.

After-Action(사후보고)
/splash
변경 사항 검토

구현은 하나의 태스크, 하나의 커밋 단위로 일어납니다. 구현 계획에 포함되어있지 않은 변경은 이탈 사항으로 강조됩니다.

// 04 · Loadouts

작전 준비는 브라우저에서, 작전 수행은 터미널/IDE에서

두 개의 도구, 하나의 루프. 웹앱은 작전 전후의 모든 컨텍스트를 관리하는 역할을 하고, CLI는 에이전트에 필요한 스킬, 툴, 커맨드를 제공해 작전을 빠르고 효율적으로 진행시킵니다.

웹 앱 · 작전 트래커

모든 작전의 컨텍스트를 한곳에

AI 코딩을 위한 GitHub Issues라고 보면 됩니다. 노트나 짧은 메시지로 정보를 남겨 두면, 에이전트가 /infil을 통해 전체 컨텍스트를 가져오고 /exfil을 통해 생성된 컨텍스트를 서버로 올려보냅니다.

*메시지 기능은 AI Chat이 아닙니다. 짧은 메모나 팀 커뮤니케이션에 쓰세요.

NAHOLO OPERATION LOGS/NOTES

#222 Redact ai transcripts

Junyoung
Users might be afraid to use the app because it uploads full transcripts. Need to remove all messages from both users and agents
Some tool usages are exposing file path. Should be better to redact all string other than we need for calculating stats.
Type a message…
CLI · 스킬

사람과 에이전트, 모두를 위한 스킬/툴/커맨드 제공

설정은 한 단계면 끝. naholo init 커맨드를 통해 간단하게 프로젝트와 연결하고 스킬을 설치할 수 있습니다. CLI는 에이전트에 최적화된 명령어와 MCP 서버를 제공해, 토큰 사용량을 효율적으로 다룹니다.

각 스킬은 실행 후, 다음 절차를 안내하기에, 미리 배울 것 없이 바로 시작해보실 수 있습니다.

웹 앱 · 에이전트 통계

토큰 소모량을 작전 별로 확인

CLI는 작전 중 모든 트랜스크립트를 모아 /exfil에서 업로드합니다. 트랜스크립트는 기본적으로 검열되어 사용량 데이터만 전송합니다, 언제든 이를 끄거나, 반대로 컨텍스트 분석을 위해 검열없이 전체 트랜스크립트를 보낼 수도 있습니다.

사용량은 스킬과 모드별로 나뉘며, 비용은 할인된 요금제가 아니라 Claude API 요금 기준으로 계산됩니다.

NAHOLO OPERATION STATS
Approx. cost$52.98
Transcripts1
Messages708 (298 user / 410 asst)
Transcript time2h 6m
claude-opus-4-710.53M (weighted, in 614 · out 216.4k · c5m 0 · c1h 2.39M · r 46.64M)
$52.65
claude-sonnet-4-6111.9k (weighted, in 12 · out 1.7k · c5m 0 · c1h 39.9k · r 236.4k)
$0.34
Skills
splashclaude-opus-4-7 4.8M
opordclaude-opus-4-7 1.3M
exfilclaude-opus-4-7 812.1k
warnoclaude-opus-4-7 212.9k
infilclaude-sonnet-4-6 111.9k
fobclaude-opus-4-7 108.9k
reconclaude-opus-4-7 81k
(none)claude-opus-4-7 3.21M
weighted tokens attributed to each (skill, model)
Tools
258
Edit 105 · Bash 84 · Read 60 · Write 5 · Skill 2 · Agent 1 · AskUserQuestion 1
장비 점검:Claude Code/macOS + Node 22+Codex와 Linux / Windows는 추후 지원 예정.
// 05 · Deployment

AI 코딩은 원래 이렇게 해야한다고 생각합니다.

바이브 코딩에서 다시 제대로 된 엔지니어링으로. 지금 바로 첫 작전을 시작해보시거나, 포크해서 직접 호스팅하세요. MIT 오픈소스입니다.

작전 시작야전 교범 보기
GitHubGitHub에서 보기