신규하 블로그

개발 기록 보관소

Claude Code 생태계를 조금만 깊게 파고들면 금방 비슷한 질문에 부딪힌다. GSD, oh-my-claudecode, Superpowers 말고도 쓸 만한 프레임워크가 이렇게 많은데, 도대체 무엇이 무엇을 대신하는지 가 잘 보이지 않는다. 핵심은 “최고의 프레임워크 하나"를 찾는 것이 아니다. 각 시스템은 프로젝트를 어떻게 분해하는지, 실행을 어떻게 오케스트레이션하는지, 부족한 기능을 어떤 스킬과 도구로 메우는지 에서 차이가 난다. 이 글은 그 관점에서 비슷한 계열의 10가지를 한 번에 정리한다. 비교 기준은 GSD, oh-my-claudecode, Superpowers 이고, 이번 글에서 다루는 10개는 그 주변에서 자주 같이 거론되는 선택지들이다. 더보기

temp/agent.md 초안을 블로그 글 형식으로 다시 풀어 쓰면, 핵심 질문은 단순합니다. GSD, oh-my-claudecode, Superpowers 중 무엇이 더 강하냐가 아니라, 각 도구가 개발 파이프라인의 어느 병목을 풀도록 설계되었느냐 입니다. 셋 다 “AI 코딩을 더 잘하게 해 주는 프레임워크"처럼 보이지만 실제로는 결이 다릅니다. GSD는 스펙과 단계 관리, oh-my-claudecode는 멀티 에이전트 오케스트레이션, Superpowers는 스킬 기반 워크플로우와 품질 규율에 더 가깝습니다. 여기에 PM-Skills를 붙이면 기획-실행 연결성이 달라집니다. 더보기

Claude를 사용하다 보면 “성공적으로 완료했습니다"라는 메시지를 자주 보게 됩니다. 하지만 실제로 테스트를 돌려보면 실패하거나 린트 에러가 발생하는 경우가 많습니다. 그러면 또다시 에러 메시지를 복사해서 Claude에 붙여넣고 “이거 에러 고쳐줘"라고 요청해야 합니다. 이 과정을 사람이 계속 붙어서 해야 하는 귀찮은 일이 발생합니다. https://youtu.be/wz7oFfIR7LA?t=0 이 문제를 해결하는 방법이 있습니다. 바로 Ralph Loop입니다. 더보기

ProductTalk의 글은 Claude Code를 이루는 building block을 6개로 나눠 설명합니다. Markdown files, slash commands, agents, skills, hooks, plugins를 각각 언제 써야 하는지 사용자 관점에서 매우 잘 정리한 글입니다. 특히 “무엇을 어떤 상황에서 꺼내 써야 하는가"라는 실전 감각을 잡는 데 도움이 됩니다. 다만 한 가지는 반드시 최신 기준으로 보정해서 읽어야 합니다. ProductTalk 글은 slash commands를 독립 기능처럼 설명하지만, 현재 Anthropic 공식 문서는 “Custom commands have been merged into skills” 라고 명시합니다. 즉 지금은 “슬래시 커맨드 vs 스킬"을 완전히 분리해서 보기보다, 사용자가 / 로 호출하는 표면과 Skill 기반 실행 모델이 점점 하나로 합쳐지는 중 이라고 이해하는 편이 더 정확합니다. 더보기

핵심 요약 스킬 자동 발동은 ‘좋은 skill 설명 + 좋은 시작 프롬프트 + 적절한 프로젝트 메모리 + 필요한 곳만 수동 호출’ 조합일 때 가장 잘 됩니다. Claude Code는 skill의 description 필드를 보고 언제 쓸지 판단합니다. 관련 있을 때 자동으로 로드하거나 /skill-name으로 직접 호출할 수 있습니다. flowchart TD A[사용자 요청] --> B{description 매칭} B -->|키워드 일치| C[스킬 자동 발동] B -->|애매함| D[수동 호출 필요] C --> E[작업 수행] D --> F["/skill-name 직접 호출"] F --> E style A fill:#c5dcef style C fill:#c0ecd3 style D fill:#ffc8c4 style E fill:#fde8c0 더보기

Claude Code를 조금만 깊게 써 보면 금방 부딪히는 문제가 있습니다. 규칙은 CLAUDE.md에 몰아넣고, 자동화는 훅에 넣고, 반복 작업은 스킬로 빼야 한다는 말은 알겠는데, 실제로 레포를 어떻게 나눠야 할지 애매합니다. 특히 프로젝트가 커질수록 “무엇을 항상 읽게 할지”, “무엇을 필요할 때만 불러올지”, “무엇을 문서로 남길지"가 섞이기 시작합니다. 이번 글은 temp/claude-structor.md의 간단한 구조 예시를 출발점으로, 실제로 운영 가능한 Claude Code 프로젝트 디렉터리 구조로 확장한 버전입니다. 단순히 폴더 이름만 나열하지 않고, 각 폴더가 왜 필요한지, 어떤 파일을 넣어야 하는지, 그리고 바로 가져다 쓸 수 있는 샘플 예제까지 같이 정리합니다. 더보기