코딩 에이전트에게 시니어 엔지니어처럼 생각하라는 프롬프트는 구체적인 지침이 되기 어렵습니다. 문제를 정의하거나 실패 가능성을 미리 파악하는 세부 작업이 모호하게 뭉개지기 때문입니다. 이를 해결하기 위해 엔지니어의 판단 과정을 23개의 작고 독립적인 Agent Skill 로 분해한 프로젝트가 등장했습니다.

라우터와 세부 규율로 나눈 스킬 구조

Senior-thinking-skills 프로젝트는 라우터 와 세부 규율(discipline) 로 역할을 분리합니다. senior-engineer-mindset 이 라우터 역할을 맡아서 작업 맥락에 맞는 규율만 선별해 불러옵니다. 요청 뒤에 숨은 본질을 확인하는 clarify-the-real-problem 이나 구현 전 실패 요인을 찾는 premortem 이 대표적입니다. 코드 변경을 최소화하는 surgical-change 와 최적화 전 지표를 측정하는 measure-before-optimizing 도 포함됩니다. 세부 스킬에는 서브에이전트 병렬화나 베이스라인 SHA 기록을 다루는 작업도 정의되어 있습니다.

작은 스킬 설계와 하드 경계의 분리

1,100줄짜리 거대한 프롬프트 하나를 유지하는 것보다 30-70줄 수준의 작은 스킬 여러 개를 필요할 때만 호출하는 편이 유연합니다. 스킬의 설명란에는 사용 시점을 적고 본문에는 수행할 행위만 다룹니다. 스킬 문서만으로 런타임 제약 조건을 강제할 수 없다는 한계도 분명히 정리했습니다. 스킬은 에이전트의 판단 방식을 다듬고, 실패 시 경계를 강제하는 규칙은 Hook 프로젝트로 분리해 검증합니다. 판단과 강제의 역할을 분리하여 에이전트의 동작을 더욱 안정적으로 다스립니다.

거대 지침서를 계속 키우는 방식에서 벗어나 작은 판단 단위로 스킬을 모듈화하는 접근은 실용적인 가치를 제공합니다. 코딩 에이전트를 장기 프로젝트에 도입할 때 체계적인 제어 틀로 참고하기 좋습니다.

요약

  • 단일 프롬프트 형태의 거대 지침보다 30-70줄 크기의 모듈화된 스킬을 라우팅하는 구조가 유지보수에 유리합니다.
  • 에이전트의 사고 방식을 교정하는 ‘Skill’과 실행 실패를 막는 강제 장치인 ‘Hook’의 역할을 명확히 분리해야 합니다.
  • 각 스킬 설명에는 호출 시점을 명시하고 본문에는 구체적인 행동 지침만 담아 프롬프트 낭비를 줄입니다.