Part 1 에서 정리한 spec 문서 지형도를 가상의 Go + Templ + HTMX To-Do 앱 gotodo 를 부트스트래핑하면서 실제로 채워 봅니다. README, AGENTS.md, ARCHITECTURE.md, ADR, DEVELOPMENT.md, 첫 feature spec 까지 발췌 형태로 살펴보고, 마지막에 Claude Code 로 검증한 뒤 가져다 쓸 수 있는 체크리스트로 마무리합니다.

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

에단 몰릭의 4가지 규칙 재분석 두 번째 글. 2026 상반기에 본격화된 agentic coding, vibe coding 의 보안 리스크, 인지 위축, 컨텍스트 엔지니어링, MCP 등 새로 드러난 트렌드와 문제점을 다룹니다.

약 1년 전에 번역했던 에단 몰릭의 ‘공동 지능 4가지 규칙’을 2026년 상반기 시점에서 재분석합니다. 모델 성능, 사용 방식, 그리고 몰릭 자신의 프레임까지 바뀌었습니다.

Superpowers 의 스킬들은 대부분 자동 트리거되지만, 의도적으로 명시 호출(/superpowers:xxx)해야 더 잘 작동하는 케이스도 있습니다. 4편에서는 두 모드의 비교, 트러블슈팅, CLAUDE.md 로 동작을 조절하는 방법, Java/Go 백엔드 개발 현장의 실용 팁과 한계를 정리합니다.

Superpowers 의 가장 강력한 부분은 “규율을 강제하는” 품질 보증 스킬들입니다. 3편에서는 TDD Iron Law, 4단계 systematic debugging, verification-before-completion, code review 흐름을 Java 프로덕션 버그 시나리오와 함께 분석합니다.

Superpowers 의 핵심은 “기능을 만들자"는 한 마디로 시작되는 자동 워크플로우입니다. 2편에서는 brainstorming → writing-plans → subagent-driven-development 의 흐름을 Go 백엔드 API 추가 시나리오와 함께 따라가 봅니다.

Claude Code, Codex 등 코딩 에이전트에 “바로 쓸 수 있는 개발 방법론"을 주입하는 Superpowers 플러그인. 1편에서는 무엇이고 왜 만들어졌는지, 어떻게 자동 트리거되는지, 그리고 어떤 환경에 어떻게 설치하는지를 정리합니다.

2025년 8월, AI 코딩 시대의 5가지 잠재적 위험을 정리한 글을 썼습니다. 7개월이 지난 지금, AI agent의 코딩 능력은 비약적으로 발전했고 개발자들의 의존도는 비교할 수 없을 만큼 높아졌습니다. 당시 제기했던 우려들을 다시 꺼내 들고, 여전히 유효한 것과 퇴색된 것, 그리고 새롭게 등장한 그림자들을 짚어봅니다.

“코드를 읽지 않는 시대, 엔지니어는 무엇을 읽어야 하는가"에서 다룬 핵심 개념들을 심화하여, 엔터프라이즈급 소프트웨어를 다루는 시니어 엔지니어 관점에서 구체적 액션 플랜을 정리합니다.

생성형 AI의 편리함 뒤에 숨겨진 ‘사고의 외주화’ 문제를 심도 있게 진단합니다. 비판적 사고력 저하와 주체성 상실을 막고, AI를 단순한 자동화 도구가 아닌 지적 확장의 도구로 활용하기 위한 4가지 구체적인 액션 플랜을 제시합니다.

Claude Code를 하루 종일 사용하다 보면 어느 순간 “Compacting our conversation…” 메시지와 함께 작업 흐름이 끊기는 경험을 하게 됩니다. 이 글에서는 Compaction이 무엇인지, 왜 자주 발생하는지, 그리고 어떻게 줄일 수 있는지 실전 전략을 공유합니다.

Hooks를 통한 강제 자동화, Subagents 활용 패턴, MCP 통합, 실전 레이어링 아키텍처, 팀 협업 워크플로우, 문제 해결 방법을 다룹니다.

Plugin 구조와 plugin.json 작성법, Marketplace 구축 및 GitHub 배포, 팀/조직을 위한 Custom Marketplace 운영 방법을 다룹니다.

Claude Code의 Plugin, Command, Subagent, Hook 개념 비교와 Marketplace 활용법, 커뮤니티 플러그인과 나만의 규칙을 조합하는 3-Layer Stacking 전략을 다룹니다.

Claude Code의 Skills 시스템을 통한 Progressive Disclosure 개념, Skills vs Subagents 비교, SKILL.md 작성법, 실전 예제를 다룹니다.

CLAUDE.md가 비대해질 때 발생하는 LLM 지시 따르기 한계, 다이어트 전략, 계층적 구조 활용법, 지시 강조 기법을 다룹니다.

Claude Code의 Agentic Coding 개념과 CLAUDE.md 파일의 역할, 계층적 구조, 작성 방법을 다룹니다. Java/Kotlin, Go 프로젝트용 실전 템플릿도 포함되어 있습니다.

이 가이드는 Claude Code 초보 사용자가 CLAUDE.md 파일 하나 만드는 것에서 시작해서, Skills와 Plugins를 활용한 고급 워크플로우까지 단계별로 성장할 수 있도록 구성되어 있습니다.

이 포스트는 Java 25(LTS)와 Spring Boot 4.0의 최신 기술 스택을 기반으로, AI 에이전트가 이해하기 쉽고, 수정하기 용이하며, 디버깅하기 좋은 애플리케이션 아키텍처를 심층 분석합니다.