HUMAN-INTENT.md

문제

솔직해집시다. 우리는 더 이상 코드를 읽고 싶지 않습니다. 에이전트가 하는 모든 일을 검증하고 싶지도 않고, 프로젝트의 기술적 세부사항을 전부 머릿속에 담아 두고 싶지도 않습니다.

하지만 아무도 에이전트를 통제하지 않으면, 그들은 어떤 프로젝트든 인간도 에이전트도 풀 수 없는 유지 불가능한 혼돈으로 만들어 버립니다. 시간문제일 뿐입니다.

아이디어

HUMAN-INTENT.md는 저장소 루트에 있는 단 하나의 파일입니다. 여기에 당신의 의도가 담깁니다: 프로젝트 아키텍처, 개발 규칙, 제품 의사결정.

이것은 코드의 문서가 아닙니다. 코드가 따라야 할 법입니다.

규칙

• 당신이 씁니다 — 오직 당신만

  에이전트는 절대 이 파일을 수정하지 않습니다. 파일의 모든 줄은 인간이 내린 결정입니다.

• 그 지시는 에이전트에게 법입니다

  HUMAN-INTENT.md에 적힌 내용은 다른 모든 것에 우선합니다. 코드가 파일과 모순된다면, 틀린 것은 코드입니다.

• 아키텍처, 규칙, 제품을 정의합니다

  레시피가 아니라 의도입니다. 에이전트는 이미 모든 패턴을 알고 있습니다. 당신의 일은 무엇이 지켜져야 하는지 — 그리고 왜인지를 정하는 것입니다.

왜 효과가 있는가

에이전트를 따라잡는 건 불가능합니다. 누구도 읽고 싶지 않을 만큼 코드가 쏟아집니다. 모든 줄을 통제하는 건 가망이 없지만, 의도를 통제하는 건 가능합니다.

HUMAN-INTENT.md는 통제를 한 단계 위로 끌어올립니다. 수천 줄의 코드 대신, 당신의 결정이 담긴 파일 하나만 지켜보면 됩니다. 이 파일이 법인 한, 아무도 코드를 읽지 않아도 프로젝트는 당신의 의도대로 나아갑니다.

시작하는 법

1. 저장소 루트에 HUMAN-INTENT.md를 만드세요.
2. 이미 내린 결정들을 적으세요: 아키텍처, 개발 규칙, 제품.
3. 에이전트에게 이 파일을 읽고 법으로 취급하라고 지시하세요 — AGENTS.md나 CLAUDE.md에서 참조하게 하세요.
4. 새로운 결정을 내릴 때마다 파일에 추가하세요. 에이전트가 이 파일에 쓰게 두지 마세요.
5. 코드가 아니라 이 파일을 리뷰하세요.