신규 서비스 git repo 를 만들 때 어떤 spec 문서들을 어떤 분량으로 두어야 할지, 2026년 5월 기준 de-facto 가 된 AGENTS.md 통합 표준을 중심으로 정리합니다. CLAUDE.md / GEMINI.md / DESIGN.md / DEVELOPMENT.md / ADR / SPEC 등 각 문서의 역할 범위와 공통 best practices, 흔한 안티패턴까지 다룹니다.
신규 서비스 git repo 를 만들 때 어떤 spec 문서들을 어떤 분량으로 두어야 할지, 2026년 5월 기준 de-facto 가 된 AGENTS.md 통합 표준을 중심으로 정리합니다. CLAUDE.md / GEMINI.md / DESIGN.md / DEVELOPMENT.md / ADR / SPEC 등 각 문서의 역할 범위와 공통 best practices, 흔한 안티패턴까지 다룹니다.