https://philipjkim.github.io/tags/agents.md/ Recent content in AGENTS.md on philipjkim Hugo en-US Thu, 28 May 2026 19:03:00 +0900 https://philipjkim.github.io/posts/20260528-repo-bootstrapping-guide-02/ Thu, 28 May 2026 19:03:00 +0900 https://philipjkim.github.io/posts/20260528-repo-bootstrapping-guide-02/ <p><em>이 글은 Claude Opus 4.7 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.</em></p> <hr> <p><a href="../20260528-repo-bootstrapping-guide-01/">Part 1</a> 에서는 2026년 5월 기준 de-facto 가 된 spec 문서들의 지형도와 best practices 를 정리했습니다. 2편에서는 가상의 Go + Templ + HTMX 기반 To-Do 앱 <code>gotodo</code> 를 새로 부트스트래핑한다고 가정하고, 각 문서를 실제로 어떻게 채우는지 발췌 형태로 따라갑니다.</p> <hr> <h2 id="가상-프로젝트-gotodo">가상 프로젝트: <code>gotodo</code></h2> <p>스택은 다음과 같습니다.</p> <ul> <li><strong>Go 1.23</strong> — 표준 라이브러리 중심</li> <li><strong><a href="https://templ.guide">templ</a></strong> — Go 네이티브 SSR 템플릿 (type-safe)</li> <li><strong><a href="https://htmx.org">HTMX 2.0</a></strong> — 클라이언트 JS 최소화</li> <li><strong>SQLite + <code>modernc.org/sqlite</code></strong> — CGO 없는 순수 Go 드라이버</li> </ul> <p>목표는 단순합니다. 할 일 추가/완료/삭제만 되는 SSR 미니멀 앱. 1인 로컬 사용을 가정합니다.</p> https://philipjkim.github.io/posts/20260528-repo-bootstrapping-guide-01/ Thu, 28 May 2026 19:02:00 +0900 https://philipjkim.github.io/posts/20260528-repo-bootstrapping-guide-01/ <p><em>이 글은 Claude Opus 4.7 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.</em></p> <hr> <h2 id="들어가며-readme-한-장으로-안-되는-시대">들어가며: README 한 장으로 안 되는 시대</h2> <p>신규 서비스를 위한 git repo 를 막 만들었다고 합시다. 2년 전이라면 <code>README.md</code> 한 장에 빌드 명령과 디렉터리 구조를 적고, 나머지는 코드와 머릿속에서 합의된 관행으로 굴러갔습니다. 새 팀원이 들어오면 옆 자리 동료가 30분쯤 설명해 주고, 그걸로 충분했습니다.</p> <p>지금은 그 &ldquo;옆 자리 동료&rdquo; 역할의 절반 이상을 Claude Code, Codex CLI, Gemini CLI, Cursor 같은 에이전트가 맡고 있습니다. 그런데 에이전트는 옆 자리에 앉지 않습니다. 매 세션마다 처음 합류한 신입처럼 repo 에 들어와서, 우리가 적어 둔 텍스트만 읽고 일을 시작합니다. <strong>에이전트에게 &ldquo;이 프로젝트는 이런 곳이고, 이런 규칙으로 일한다&rdquo; 를 전달하는 문서가 부실하면, 에이전트가 만드는 결과물의 품질은 운에 좌우됩니다.</strong></p>