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

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편에서는 무엇이고 왜 만들어졌는지, 어떻게 자동 트리거되는지, 그리고 어떤 환경에 어떻게 설치하는지를 정리합니다.

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

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를 활용한 고급 워크플로우까지 단계별로 성장할 수 있도록 구성되어 있습니다.