icpg

icpg skill 개요

icpg skill이 하는 일

icpg skill은 코드 이해에 “WHY 레이어”를 더합니다. 단순히 구조를 매핑하는 데서 끝나지 않고, 함수·클래스·모듈이 왜 존재하는지, 누가 책임지는지, 그리고 여전히 원래 의도와 맞는지를 연결해 보여줍니다. Code Review, 리팩터링, 자율 유지보수를 위해 icpg가 필요하다면, 핵심 가치는 코드 변경 전에 추측을 줄이는 데 있습니다.

어떤 사람에게 가장 적합한가

icpg는 동작 방식, 소유권, 설계 의도가 단순한 문법 스캔보다 중요한, 활발히 변경되는 코드베이스에서 일하는 엔지니어와 에이전트에 잘 맞습니다. 특히 저장소에 드리프트가 누적됐거나, 작업 이력이 불분명하거나, “이건 왜 이렇게 썼지?” 같은 질문이 반복되는 경우에 가장 유용합니다.

무엇이 다른가

이 skill은 ReasonNodes, formal contracts, 그리고 여러 차원의 drift detection을 중심으로 구성됩니다. 즉 icpg는 단순한 코드맵이 아니라, 작업 전 분석을 위한 의사결정 지원 레이어입니다. 실제 이점은 변경 안전성이 높아지고, 리뷰 맥락이 더 선명해지며, 원래 의도를 조용히 위반하는 수정이 줄어든다는 점입니다.

icpg skill 사용 방법

설치하고 핵심 파일 찾기

저장소의 skill 설치 흐름을 따라 설치한 뒤, skills/icpg/SKILL.md부터 확인하세요. 이 저장소에는 보조 스크립트나 지원 폴더가 없으므로, skill 파일 자체가 사실상 단일한 기준 문서입니다. 빠르게 설치 여부를 판단하려면 다른 것보다 먼저 frontmatter와 첫 섹션들을 읽는 것이 좋습니다.

막연한 목표를 쓸 수 있는 프롬프트로 바꾸기

icpg usage는 구체적인 작업, 대상 경로, 원하는 출력 형태를 줄 때 가장 잘 동작합니다. 좋은 입력 예시는 다음과 같습니다. “src/payments/charge.ts의 intent drift를 검토한 뒤 retry 로직을 바꾸기 전에 알려줘” 또는 “auth 흐름에 대해 ReasonNodes를 부트스트랩하고 누락된 ownership 링크를 찾아줘” 같은 식입니다. “이 저장소를 분석해줘”처럼 약한 입력은 범위가 너무 넓어서, 이 skill이 가진 의도 추적 강점을 제대로 살리지 못하는 경우가 많습니다.

첫 사용 시 추천 워크플로

먼저 대상 코드의 의도된 목적이 무엇인지 묻고, 그다음 그 코드를 지키는 제약이나 계약이 무엇인지 묻고, 마지막으로 드리프트가 어디에서 생길 가능성이 큰지 묻는 순서로 진행하세요. 이 순서는 skill의 설계와 잘 맞고, 에이전트가 구조에서 의도, 그리고 위험으로 자연스럽게 이동하도록 돕습니다. icpg guide 워크플로에서는 저장소 전체보다 하나의 모듈이나 하나의 변경 집합에 요청을 집중하는 편이 좋습니다.

저장소에서 먼저 읽을 것

우선 SKILL.md를 읽되, 특히 목적 설명, CLI 예시, 핵심 원칙, canonical pre-task queries, ReasonNode, edge types가 설명된 부분을 먼저 보세요. 이런 요소들은 도입 여부 판단과 Code Review용 icpg 출력 품질에 가장 큰 영향을 주는 부분입니다.

icpg skill FAQ

icpg는 자율 에이전트에만 필요한가?

아닙니다. icpg는 사람과 에이전트 모두에게 유용하지만, 반복 가능한 작업 전 추론이 필요한 시스템에서 특히 빛을 발합니다. 한 번만 요약이 필요하다면 일반 프롬프트로도 충분할 수 있지만, 의도까지 반영한 code review나 변경 계획이 필요하다면 icpg가 더 적합합니다.

icpg는 일반적인 코드 프롬프트와 어떻게 다른가?

일반 프롬프트도 코드를 요약할 수는 있지만, icpg는 작업 전반에 걸쳐 의도, ownership, drift 맥락을 유지하도록 설계되었습니다. 그래서 “이 코드를 바꾸기 전에 이 코드가 무엇을 위해 존재하는가?”를 답해야 할 때, 단순히 “이 코드가 무엇을 하는가?”를 묻는 것보다 훨씬 유용합니다.

icpg는 초보자도 쉽게 쓸 수 있나?

초보자도 사용할 수는 있지만, 가장 좋은 결과는 파일명, 기능, 변경 경계를 정확히 짚을 수 있는 사용자에게서 나옵니다. 저장소가 처음이라면 전체 시스템 분석보다 하나의 모듈부터 시작해, 목적·제약·리뷰 위험을 중심으로 질문하는 편이 좋습니다.

언제는 icpg를 쓰지 않는 게 나은가?

작업이 단순하거나, 코드가 고립되어 있거나, 빠른 표면 수준의 설명만 필요하다면 icpg는 생략해도 됩니다. 또한 대상 영역이나 변경 맥락을 전혀 제공할 수 없다면 이 skill은 잘 맞지 않습니다. icpg의 가치는 코드를 특정한 존재 이유와 연결하는 데 있기 때문입니다.

icpg skill 개선 방법

작업 맥락을 더 강하게 주기

가장 좋은 icpg 결과는 변경 목표, 영향 받는 파일, 절대 깨지면 안 되는 조건이 함께 들어간 프롬프트에서 나옵니다. 예를 들어 “새 세금 규칙 적용 이후 src/billing의 drift를 검토해줘”는 “billing 코드를 확인해줘”보다 훨씬 강합니다. 이렇게 해야 skill이 icpg for Code Review에 맞는 ReasonNodes와 제약을 더 정확히 드러낼 수 있습니다.

구현보다 의도를 먼저 묻기

자주 생기는 실패 패턴은 코드가 무엇을 보호하려 했는지 묻지 않은 채 바로 수정으로 넘어가는 것입니다. 먼저 원래 목적, 현재 계약, 의심되는 drift를 요청하고, 그다음 변경 계획을 물으면 출력 품질이 좋아집니다. 이 순서는 불필요한 회귀를 줄이고, 리뷰 결과를 더 신뢰하기 쉽게 만듭니다.

첫 답변을 이용해 두 번째 질문을 더 날카롭게 만들기

첫 번째 결과가 너무 넓다면 모듈, 워크플로 단계, 소유권 경계로 범위를 좁히세요. 답변이 너무 얕다면 누락된 계약, 가능성이 큰 drift 차원, 혹은 작업에 가장 잘 맞는 canonical pre-task query를 다시 요청하세요. 이렇게 반복하는 편이 응답을 길게 받는 것보다 신호를 더 많이 개선하는 경우가 많습니다.

skill의 설계와 질문을 맞추기

icpg skill은 단순한 코드 설명보다 reason tracking, drift detection, pre-task analysis를 요청할 때 가장 강합니다. 더 나은 icpg usage를 원한다면, 무엇이 “완료”인지, 어떤 변경을 고려 중인지, 그리고 코드베이스의 어느 부분이 범위 안에 있는지를 함께 적어 주세요.