r/ClaudeCode•3개월 전•31•11

Claude Code가 SOLID 원칙과 디자인 패턴을 과도한 엔지니어링 없이 적용하도록 돕는 스킬을 만들었습니다

I built a skill that teaches Claude Code how to apply SOLID principles and design patterns — without over-engineering the result

핵심 요약

Claude Code의 과도한 추상화를 방지하고 SOLID 원칙을 적절히 적용하도록 돕는 'solidifier' 스킬 개발 및 공유.

SOLID 원칙 적용 — Claude Code가 코드 작성 시 SOLID 원칙과 디자인 패턴을 적절히 활용하도록 유도함.
과도한 엔지니어링 방지 — 추상화가 필요한 구체적인 이유를 요구하여 불필요한 복잡성을 줄임.
구성 가능한 엄격도 — 프로젝트 성격에 맞춰 조언 모드부터 철저한 적용 모드까지 4단계로 설정 가능함.
다양한 도구 지원 — Claude Code, OpenCode, Copilot, Codex 등 주요 AI 코딩 도구와 호환됨.

백엔드 코드를 작업하다 보니 Claude가 멀쩡한 코드를 기술적으로는 맞지만 수정하기는 더 어려운 코드로 리팩토링하는 걸 계속 목격했습니다.

구현체가 하나뿐인 인터페이스를 사용하거나, 생성자 하나를 감싸는 팩토리를 만드는 등 과도하게 엔지니어링된 것들이었죠.

그래서 'solidifier'를 만들었습니다. 이 스킬은 Claude에게 SOLID 원칙과 디자인 패턴을 가르치되, 과도한 엔지니어링을 결함으로 취급하게 합니다. 모든 추상화에는 구체적인 정당성이 필요합니다. 프로젝트별로 설정 가능한 4단계의 엄격도(조언 전용부터 철저한 적용까지)를 제공합니다.

Claude Code, OpenCode, Copilot, Codex에서 작동합니다. 자세한 내용은 레포에서 확인하세요.

http://github.com/FernandoJRR/solidifier

원문

커뮤니티 목록

r/ClaudeCode•3개월 전•31•11

Claude Code가 SOLID 원칙과 디자인 패턴을 과도한 엔지니어링 없이 적용하도록 돕는 스킬을 만들었습니다

I built a skill that teaches Claude Code how to apply SOLID principles and design patterns — without over-engineering the result

핵심 요약

Claude Code의 과도한 추상화를 방지하고 SOLID 원칙을 적절히 적용하도록 돕는 'solidifier' 스킬 개발 및 공유.

SOLID 원칙 적용 — Claude Code가 코드 작성 시 SOLID 원칙과 디자인 패턴을 적절히 활용하도록 유도함.
과도한 엔지니어링 방지 — 추상화가 필요한 구체적인 이유를 요구하여 불필요한 복잡성을 줄임.
구성 가능한 엄격도 — 프로젝트 성격에 맞춰 조언 모드부터 철저한 적용 모드까지 4단계로 설정 가능함.
다양한 도구 지원 — Claude Code, OpenCode, Copilot, Codex 등 주요 AI 코딩 도구와 호환됨.

백엔드 코드를 작업하다 보니 Claude가 멀쩡한 코드를 기술적으로는 맞지만 수정하기는 더 어려운 코드로 리팩토링하는 걸 계속 목격했습니다.

구현체가 하나뿐인 인터페이스를 사용하거나, 생성자 하나를 감싸는 팩토리를 만드는 등 과도하게 엔지니어링된 것들이었죠.

Claude Code, OpenCode, Copilot, Codex에서 작동합니다. 자세한 내용은 레포에서 확인하세요.

http://github.com/FernandoJRR/solidifier

주요 댓글

r/claudecode

개발자들은 AI의 과도한 추상화 문제를 공감하며, SOLID 원칙 적용 시 정당성 확보와 인간의 판단이 중요하다는 의견을 나누고 있습니다.

방금 한 말은 부분적으로 자기 모순적임. SOLID 원칙을 사용하면서 과도한 엔지니어링을 안 하는 건 서로 상충함. Claude가 그 순간에 어떻게 해석할지 모르기 때문에 위험할 수 있음. 추상화로 과도하게 엔지니어링하는 예시를 들고는, 다시 추상화를 사용하라고 지시했잖아.

무슨 말인지 알겠고 그게 구현하기 가장 어려운 부분이었음. 에이전트는 실제로 무엇이 적절한 추상화 균형인지 모르니까. 안전을 위해 이 스킬의 주요 지침은 '억제'임. (엄격도 레벨에 따라) 가능한 한 최소한으로 추상화하고, 각 변경 사항을 정당화하려고 노력하며, 이미 추상화가 되어 있다면 “변경 불필요”라고 말함. 결국 이 스킬은 사용자의 지도를 구해서 이런 결정 중 일부를 내리고 해석에만 맡기지 않으려 함...

유용한 테스트는 패턴 이름을 댈 수 있느냐가 아니라, 두 번째 구현체가 끝내 안 나타날 때 스스로 추상화를 삭제하느냐임. 필수 종료 단계를 추가하겠음: 새로 만든 인터페이스/팩토리/어댑터마다 그게 가져오는 구체적인 변경 사항과 더 저렴한 버전을 나열하게 하는 거임. 만약 정당성이 “나중을 위한 유연성”이라면 바로 감옥행임 😅

맞음, 사실 그 문제를 위해 “requireJustification”이라는 설정이 내장되어 있음. 스킬이 변경 사항, 해결된 문제, 비용을 설명하도록 강제함. 언급한 내용은 조언자나 엄격도 레벨 설정으로 추가하면 좋을 듯, 메모해둠.

나도 비슷한 자가 적응형 도구를 만들었음 https://github.com/BaseInfinity/claude-sdlc-wizard , 다른 사람들이 자기 하네스 공유할 때만 용기 내서 공유함 :X 아마 맥주 몇 잔 마셨을 때일지도.

내 “sdlc-wizard”의 목표는 언젠가 내가 이걸 쓸 필요가 없어지는 것임. 더 낫다는 게 증명되지 않으면 업데이트할 때마다 내가 가진 걸 다 깎아내는 거임.

사람들이 이런 도구의 불안정성을 줄이기 위해 하네스가 필요하다는 걸 깨닫는 걸 보니 기쁨.

SOLID 원칙과 좋은 디자인 패턴을 적용하는 건 당신의 일임. 결국 이런 디자인 패턴은 딱딱한 규칙이 아니라 인간이 구현할지 말지 결정해야 하는 것임.

-1

맞음, 그게 이 스킬의 철학임. 패턴이나 원칙이 위반되었을 때 그걸 인식해서 사용자에게 알림. 그래서 “조언자” 모드가 있는 거임. 아무것도 바꾸지 않고 원칙을 적용할 수 있는 코드만 확인하니까. 예를 들어 switch case를 많이 쓰는 대신 Strategy를 쓰라는 식임. 이런 패턴이 어렵지 않은 건 사실이지만, 훈련된 엔지니어가 아니거나 경험이 적은 엔지니어에게는, 특히 에이전트를 사용해 코드를 작성할 때는 더 어려움...

기본 엄격도 레벨을 조언 모드로 하고, 추상화를 추가하기 전에 구체적인 변경 압력을 인용하도록 요구하겠음. “나중에 필요할지도 몰라”는 절대 통과되면 안 됨. 유용한 아티팩트는 아마 도입을 거부한 내용을 보여주는 짧은 전/후 diff일 것임.

대부분의 모델은 이미 그런 패턴으로 훈련되어 있음. 도메인 주도 설계, 포트 어댑터, 클린 아키텍처에 TDD 루프를 참조하고, 요청-응답 패턴을 추가하면 스킬을 단순화할 수 있을 거임. 그러면 간단하고 강력한 스킬이 될 것임.

오 이거 진짜 고맙네. 바로 별 눌렀음

나도 특정 역할에만 이런 스킬을 위임하는 커스텀 멀티 에이전트 프레임워크를 쓰고 있는데, 문제는 Claude가 읽기 작업을 너무 최적화해서 재사용성을 제대로 활용하지 못한다는 거야. 그리고 레포가 커지면 에이전트가 로직을 중복해서 짜기 시작함. 그런 면에서 graphify보다 Skills가 더 신뢰할 만한데, 훅(hook)들이 문맥적 지식을 제공해주거든. 결국 다 케바케고 앱이 어떻게 설계됐느냐에 달려 있음.

원문r/ClaudeCode