가장 유용한 기능은 당신에게 반대하는 것입니다

Halfcycle은 사용자의 Claude Code 내에서 5단계 빌드 방식을 실행하는 모듈입니다 (npx halfcycle).

Node 20 이상 버전과 Claude Code만 필요합니다. 이것이 모든 전제 조건 목록입니다. 아래의 모든 과정은 한 번에 이루어집니다.

mkdir tally && cd tally
npx halfcycle

이 명령어는 브라우저를 통해 로그인하고 작업 내용을 기록할 프로젝트를 생성합니다. 모든 사람이 사용하는 동일한 주소와 통신하며, CLI에 포함되어 있어 설정할 것이 없고 사용자에게 먼저 제공해야 할 가치도 없습니다. 만약 접속하지 못하면 멈추고 아무것도 쓰지 않는데, 이는 의도된 것입니다. 배경이 없는 폴더는 아예 설정되지 않은 폴더보다 더 나쁩니다.

작업을 마치면 웹에서 프로젝트 페이지로 연결됩니다. 원할 때 언제든지 app.halfcycle.ai에 접속하여 로그인할 수도 있습니다.

하나를 클릭하면 콘솔 화면을 볼 수 있습니다. 설정할 것이 없고 두 번째 계정도 필요하지 않습니다. 설치 시의 로그인과 동일합니다.

첫날 열어볼 만한 부분은 'crew'입니다.

이것이 라이브 상태의 팀입니다. 빌더(builders), 리뷰어(reviewers), 그리고 항상 작동하는 에이전트들로 구성된 21개의 에이전트가 있습니다. 각 에이전트는 용도와 깊이를 보여주며, 현재 바쁜지, 유휴 상태인지, 아니면 대기 중인지를 나타냅니다. 한 시간 전에 실행된 기록 목록이 아닙니다.

20분 정도 지나면 그 페이지에 쓸 내용이 많지 않을 것이고, 이것이 초기에 살펴봐야 하는 이유입니다. 채워지는 것을 지켜볼 수 있습니다. 실제로 작업을 처음 실행할 때, 이 페이지는 단순한 목록(roster)을 넘어 터미널에서 좋은 답이 없는 질문에 대한 답변이 되기 시작합니다. 만약 세 개의 에이전트가 작동한다면, '도대체 뭘 하고 있는 거지?'라는 질문은 스크롤백 세 개와 추측만을 안겨줄 뿐입니다.

첫날 알아야 할 또 다른 페이지는 오버뷰(overview)인데, 이곳에 프로젝트의 윤곽이 담겨 있습니다.

각 게이트(gate)가 어디에 서 있는지, 어떤 단계(phase)가 활성화되어 있는지, 그리고 지금 무엇이 일어나고 있는지를 보여줍니다. 단계란 배포될 수 있고 누군가에게 보여줄 수 있는 제품의 한 조각이며, 상단의 스트립은 당신과 이 단계를 닫는 것 사이의 모든 게이트를 의미합니다.

개인 프로젝트의 경우, 이 모든 것이 아무 의미 없어 보이다가도, 2주 동안 자리를 비웠다가 돌아와 자신이 어디까지 했는지 기억할 수 없을 때까지는 말이죠. 콘솔은 당신 자신의 메모보다 프로젝트를 다시 불러오는 더 빠른 방법입니다. 왜냐하면 그것은 무엇을 할 의도가 있었는지에 대한 기록이 아니라, 무슨 일이 일어났는지에 대한 기록이기 때문입니다. 팀의 경우, 세션에 참여하지 않은 사람에게 작업이 존재하는 유일한 장소입니다.

그런 다음 Claude Code에서 폴더를 엽니다.

이것은 이 글의 마지막 지침이며, 잠시 멈춰서 살펴볼 가치가 있습니다. 왜냐하면 평범하지 않기 때문입니다. 배울 명령어가 없고, 기억할 다음 단계도 없으며, 제대로 해야 할 순서도 없습니다. 단순히 인사하거나, 무엇을 만들고 싶은지 말하면, 그것이 나머지 과정을 맡아 처리합니다.

다음 10분은 질문들로 이루어져 있습니다

사람들이 예상하지 못하는 부분이므로 분명히 말할 가치가 있습니다. 아무것도 당신에게 양식을 작성하도록 요구하지 않습니다. 폴더를 먼저 읽고, 할 수 있는 것을 파악한 후, 진정으로 답할 수 없는 것들만 질문합니다.

질문들은 한 번에 하나씩, 의존하는 것이 먼저 질문되지 않는 순서로 나옵니다. 각 질문에는 추천 답변과 그 근거가 함께 제공되므로, 가장 쉬운 방법은 추천 내용을 읽고 '예'라고 답하는 것입니다. 그리고 답변이 리포지토리(repo)에 대한 사실일 경우, 이미 확인을 마친 상태이며, 확인할 것을 요청하기보다는 찾은 결과를 보여줍니다.

또한 진행 속도를 앞당길 수도 없습니다. 세 단계 떨어진 것을 물어봐도, 어차피 다음 순서였기 때문에 처리하거나, 아니면 왜 안 되는지 그리고 무엇이 빠졌는지 알려줍니다. 실수로 단계를 건너뛸 수 있는 경로는 없다는 뜻이며, 이는 머릿속에 담아둘 것이 없고 다른 탭에서 열어둘 체크리스트도 없다는 의미입니다.

이 도구가 하지 않을 유일한 것은 이유 없이 결정을 기록하게 두지 않는 것입니다. 이유를 단순히 적는 것이 아니라, 실제적인 이유 말입니다. 이곳이야말로 이 도구가 의견을 갖는 첫 번째 지점이며, 왜 그런 의견을 가지는지 이해할 가치가 있습니다. 3개월 후, 다시 검토할 수 있는 결정과 처음부터 재논의해야 하는 결정 사이의 유일한 차이는 누군가 그 이유를 기록했는지 여부입니다. 이 이후의 모든 에이전트(agent) 세션은 여기서 당신이 내린 결정을 읽게 됩니다. 근거 없이 내려진 결정은 다음 세션에서 조용히 재해석될 것입니다.

빠르게 답하기보다는 정직하게 답변하십시오. 이 루프 안에서 무엇을 만들고 있는지 아는 사람은 오직 당신뿐입니다.

그리고 무엇을 만드는지 묻습니다

자신의 말로 설명하세요. 명세서(spec)도, 구조화된 개요서(structured brief)도 아닙니다. 한 단락으로요.

제가 먹은 것을 기록하면 이번 주에 대략적으로 뭘 먹었는지 알려주는 것이 필요합니다. 저만을 위한 것입니다. 주로 웹이나 휴대폰 브라우저에서 사용할 겁니다.

돌아오는 것은 방금 설명한 내용을 바탕으로 작성된 초안입니다. 이는 당신이 말한 것보다 길고 더 구체적이며 약 70% 정도 맞습니다. 이 초안은 제품 자체가 아닙니다. 이것은 '짚인형(strawman)'이며, 짚인형이 존재하는 이유는 빈 페이지에 대한 개방형 질문에 답하는 것보다 특정 잘못된 주장에 반박하는 것이 인간에게 훨씬 쉽기 때문입니다. 비어 있는 '비기능 요구사항 (Non-functional requirements)' 제목을 가진 템플릿을 받은 사람이라면 이 차이를 정확히 느낄 수 있습니다.

그래서 초안을 작성하고, 그 초안에 대해 질문합니다. 설정과 같은 방식의 심문입니다: 한 번에 하나의 질문, 순서대로, 각각 추천 답변이 첨부되어 있습니다.

기다릴 가치가 있는 순간

어딘가에서, 그것은 당신이 아직 결정하지 않은 것을 묻습니다.

식단 기록(food log)의 경우, 보통 이 질문이나 그 변형입니다: 하루에 같은 것을 두 번 기록하면 어떻게 되는가. 사소하게 들립니다. 그렇지 않습니다. 그리고 여기에 솔직한 이유가 있습니다. 만약 동일한 항목이 개수와 함께 한 행으로 되어 있다면, 주간 총합은 개수에 대한 합계이며 당신의 기록은 손실적(lossy)입니다. 만약 그것들이 두 개의 행이라면, 당신의 총합은 행 개수가 되고 사용자에게 실제로 일어났던 날을 정확하게 보여줄 수 있습니다. 둘 다 괜찮습니다. 하지만 하나는 스키마이고, 당신은 그 위에 구축하려 하고 있으며, 아무도 이 질문을 할 사람이 없었습니다.

이것이 바로 개입(intervention)입니다. 그것은 발견된 버그가 아닙니다. 이것은 기본값(default)이 되기 전에 표면화된 결정이며, 결정이 가장 저렴한 유일한 순간입니다.

이것이 작동했다는 신호는 당신이 잠시 타이핑을 멈추는 것입니다.

20분이 지난 후의 결과물

당신의 폴더에 있는 평문 마크다운 파일들. 에이전트 세션이 미래 모든 세션에서 읽게 될 컨텍스트, 당신이 내린 결정과 그 이유들, 그리고 머릿속 생각보다 더 구체적인 제품 설명 초안입니다.

저희 것 중 아무것도 그 안에 남지 않습니다. 과정 자체, 즉 단계, 템플릿, 질문들은 요청하는 세션에 도착하며, 현재 위치한 단계에 맞게 크기가 조정되어 있고, 여러분의 리포지토리에는 정적으로 저장되어 있지 않습니다. 남아있는 것은 오직 여러분이 작성한 내용뿐입니다.

아직 아무것도 구축하지 않았습니다. 또한 다음에 무슨 일이 일어날지 알 필요도 없습니다. 그것이 알려줄 것입니다.

시작하기

npx halfcycle

작업을 원하는 폴더에서 이것을 실행한 다음, Claude Code에서 열고 무엇을 만들고 있는지 말하세요. Node 20 이상이 필요합니다. 먼저 배울 것이 없고 기억해야 할 다음 단계도 없습니다. 다음에 올 때 그것이 알려줍니다.

halfcycle.ai