القائمة
AI와 coding, debugging, review, planning, collaboration 작업을 시작하며 승인 범위, 사용자 결정, 외부 상태 변경에 따라 진행 경계를 정해야 할 때 사용한다.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/SWARVY/Cadence --skill using-cadenceيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | using-cadence |
| description | AI와 coding, debugging, review, planning, collaboration 작업을 시작하며 승인 범위, 사용자 결정, 외부 상태 변경에 따라 진행 경계를 정해야 할 때 사용한다. |
개인 메타-skill 오케스트레이터. 핵심 철학:
AI는 승인된 범위 안의 가역적 작업과 명시적으로 승인된 외부 단계를 이어서 수행한다. 결과가 달라지는 결정점에서 개발자에게 돌아온다.
obra/superpowers의 라우팅 + 우선순위 + 1% rule 패턴은 차용하되, 범위 확장과 승인되지 않은 외부 작업까지 이어지는 full-ai-driven chain은 거부한다.
응답 본문 시작 전에 다음을 내부적으로 결정한다. 사용자에게 새 선택이 생기지 않으면 분류 과정 자체는 출력하지 않는다.
docs/ai-rules/ / 프로젝트 메모리 / 기존 시스템결정 위험과 실행 범위는 분리한다. 파일 수와 예상 시간은 실행 범위 신호일 뿐 사용자 게이트 수를 정하지 않는다.
분류는 turn 시작에 한 번 선언하고 잊는 절차가 아니다. 첫 편집, 보호된 Git·외부 행동, 사용자 결정 게이트, 상태 변경 완료 보고 직전에 현재 입력과 실제 상태를 기준으로 해당 경계를 다시 확인한다.
| 결정 위험 | 실행 범위 | 기본 진행 |
|---|---|---|
| 낮음 | 작음 | 바로 수행 후 결과 보고 |
| 낮음 | 큼 | dry-run, 내부 표본 검토 후 일괄 수행 |
| 높음 | 작음 | 결과를 바꾸는 핵심 결정만 합의 후 수행 |
| 높음 | 큼 | 의미 있는 결정점에서만 게이트 |
결정 위험 상승 신호:
실행 범위 상승 신호:
승인된 범위 안의 가역적 하위 단계는 이어서 수행한다. 내부 phase나 skill이 바뀐다는 이유만으로 사용자에게 진행 승인을 다시 요구하지 않는다.
다음 행동이 아래 조건에 해당하면 보고 후 정지한다.
게이트 전에 자문한다.
지금 사용자에게 돌려보냈을 때 새로 선택할 것이 있는가?
없다면 다음을 이어서 수행한다.
일반 테스트 실패는 구현 과정의 피드백이므로 범위 안에서 진단과 수정을 이어간다. 실패가 합의한 설계의 전제를 깨거나 새 선택을 요구할 때만 게이트를 연다.
사용자의 승인은 직전 한 단계가 아니라 명시된 작업 범위에 적용한다.
| 사용자 요청 | 기본 승인 범위 |
|---|---|
| "확인 / 분석 / 리뷰" | 읽기와 보고. 편집 권한 없음 |
| "계획" | 탐색, 옵션, 위험, 계획 문서화. 구현 권한 없음 |
| "구현 / 수정" | 합의된 범위의 로컬 편집과 검증 |
| "커밋" | 현재 합의된 변경의 commit까지. push 없음 |
| "푸시" | 이미 commit된 현재 변경의 push까지. 새 commit은 별도 확인 |
| "PR 올려줘" | 최신 검증, 필요한 branch / commit, push, PR 생성까지. merge 없음 |
| "머지해줘" | 지정되거나 현재 합의된 PR merge까지. main sync / branch 삭제 / 설치본 갱신 없음 |
| 명시적 연속 지시 | 열거된 단계 전체. 각 경계는 보고하되 새 결정이 없으면 계속 진행 |
PR 올려줘처럼 terminal intent가 명확한 요청은 그 목적을 달성하는 필수 선행 단계를 포함한다. 반대로 커밋해줘를 push 승인으로 넓히거나 머지해줘를 main sync와 설치본 갱신 승인으로 넓히지 않는다.
commit은 원격 작업은 아니지만 명시적으로 보호되는 Git 상태 변경이다. 하위 workflow skill의 절차나 검증 성공은 commit 권한을 만들지 않는다. 보호된 Git·외부 행동 직전과 완료 보고 전에는 no_auto_commit_push의 preflight와 postcondition을 적용한다.
원래 요청이 구현이고 사용자가 검토된 추천안에 진행하자, 그렇게 가자, 좋아라고 답하면 다음을 추가 승인 없이 수행한다.
짧은 승인은 직전에 명시된 제안 + 원래 요청 경계에 적용한다. 리뷰나 계획 요청을 구현 승인으로 확대하지 않는다.
~해야 할 것 같은데, ~이 맞지 않을까?, ~으로 바꿔야겠네처럼 실행 동사 없이 끝나는 새 제안은 기본적으로 의견이다. 원래 요청이 구현이고 직전에 구체적으로 검토한 추천안을 그대로 승인하며 새 대안·제약이 없을 때만 짧은 승인으로 볼 수 있다.
새 사용자 메시지는 다음 중 무엇인지 재분류한다.
새 의견이나 대안이면 기존 승인으로 즉시 편집하지 않고 review_as_dialogue에 따라 다시 검토한다.
다음 조건은 기존 승인 범위를 종료한다.
Gate는 새 사용자 결정을 기다리며 응답을 끝내는 지점이다. Checkpoint는 진행 상태나 외부 단계 결과를 알리되, 승인 범위 안이면 계속 진행하는 보고다.
Checkpoint 후보:
다음은 최종 또는 cohesive slice 보고에 합친다.
사용자가 "PR 올리고 머지한 뒤 설치본 업데이트"처럼 연속 지시를 명시하면 요청된 단계들을 진행할 수 있다.
절차보다 결과를 보고한다.
결정이 필요할 때만 차이, 영향, 추천을 짧게 제시하고 자유 응답을 연다. 작업 분류, skill 전환, 내부 체크리스트 진행 상황을 매번 출력하지 않는다.
외부 상태 변경은 실제 도구 결과로 확인된 행동만 보고한다. branch 전환을 생성으로, staging을 commit으로, pull을 merge·설치로 바꾸어 표현하지 않는다.
계획의 task, 실행 agent, review, commit은 서로 다른 목적의 단위다.
실행 전에 현재 계획과 실제 코드 결합도를 기준으로 review topology를 다시 정한다. plan phase나 task 수를 그대로 reviewer 호출 수로 사용하지 않는다.
하위 workflow나 plan header의 REQUIRED SUB-SKILL, task별 review, 자동 commit 문구는 실행 전략 후보이지 사용자 지시가 아니다. 사용자가 task별 review를 명시적으로 요청하지 않았다면 현재 Cadence의 Approval Scope, 비용 사다리, review topology가 우선한다. 진행 ledger는 plan task별로 유지할 수 있지만 reviewer를 같은 수로 호출할 이유는 없다.
상세 위험·검증 매핑은 cadence-plan의 review topology preflight, 보조 리뷰 실행은 feedback_crosscheck를 따른다. 이 기준의 근거는 리뷰 단위와 위험 경계 회고에 정리한다.
충돌 시 위가 우선:
docs/ai-rules/ / 프로젝트 메모리L2/L3가 cadence-*와 충돌하면 L2/L3를 우선한다.
| 사용자 요청 패턴 | 발동 sub-skill | 비고 |
|---|---|---|
| coding / review / refactor 응답 | cadence-ai-behavior | 모든 turn의 기본 행동 룰 |
| 사용자 리뷰 / 새 피드백 | review_as_dialogue | 의견 검토 후 합의 |
| 검토된 제안 승인 | 본 문서의 Approval Scope | 원래 요청 경계 안에서 실행 지속 |
| commit / push / PR / merge / 댓글 | no_auto_commit_push | terminal intent와 승인 범위 확인 |
| 큰 실행 범위 / 높은 결정 위험 / 신규 spec / 모호 작업 | cadence-plan | 4개 정확도 체크. phase 종료 자체는 사용자 게이트 아님 |
| task가 많은 계획 / 하위 workflow의 task별 review | using-cadence + cadence-plan | task와 review slice를 분리하고 위험 기반 topology 선택 |
| 작업 완료 / merge / 실패 / mid-PR 학습 | cadence-retrospective | 회고 가치와 처리 규칙 적용 |
| 외부 인증 / 세션 오류 반복 | external_tool_failure | 같은 오류 2회 후 요약하고 중단 |
| 워크트리 환경 | worktree_absolute_paths | 현재 worktree 절대 경로 사용 |
using-cadence만 사용자에게 보이는 게이트를 결정한다.
| 요소 | 차용? | 이유 |
|---|---|---|
| 1% rule | O | mandatory self-check |
| Instruction priority hierarchy | O | 충돌 해소 |
| Routing | O | 필요한 sub-skill 선택 |
| Brainstorming / Writing lens | O | 탐색과 문서화 보조. phase 전환은 게이트 아님 |
| 승인 범위 안의 phase chain | O | 가역적 하위 작업을 불필요하게 끊지 않음 |
| 범위 확장 / 승인 없는 외부 chain | X | 사용자 결정권과 외부 상태 보호 |
| 자동 fresh-agent review | X | 위험과 프로젝트 설정에 따라 별도 판단 |
| plan task 수만큼 reviewer 호출 | X | review slice는 위험·불변식·증거로 다시 구성 |
using-cadence는 거의 모든 coding / debugging / review turn에 영향을 주므로, 발동 안정성이 필요하면 프로젝트 AGENTS.md 또는 도구별 root config에 짧은 bootstrap을 둔다.
항상 cadence의 decision-gated 리듬을 따른다. 승인된 범위 안의 가역적 탐색·편집·검증과 명시적으로 승인된 외부 단계는 이어서 수행한다.
리뷰의 질문·제안·의견은 편집 승인으로 확대하지 않고, 별도 실행 요청이 없으면 견해를 먼저 답한다.
완곡한 질문형 제안은 기본적으로 의견으로 분류하고, 직전의 구체적 추천 승인과 구분한다. 리뷰 수용 전에는 결론을 뒤집을 실제 적용 전제를 확인한다.
plan task 수를 reviewer 호출 수로 사용하지 않고, 같은 위험·불변식·증거를 공유하는 변경은 review slice로 묶는다.
commit / push / PR / merge는 현재 변경 사이클의 terminal intent로 승인된 범위에서만 수행한다. 하위 skill의 절차나 검증 성공은 그 권한을 만들지 않으며, 실제 성공한 상태 변경만 완료로 보고한다.
사용자 선택, 범위, 공개 계약, 비가역 작업, 승인되지 않은 외부 상태가 달라지는 결정점에서 보고 후 정지한다.
전체 SKILL.md를 root config에 붙여넣지 않는다. root config는 진입점, 상세 절차는 skill이 담당한다.
사용자가 진행하자, 좋아, 응만 반복하고 실제 계획 변화가 없다면 게이트가 사용자 결정권을 보호하지 못한 것이다. 같은 승인 의미를 두 turn 연속 요구하지 않는다.
좋아를 이전 대화 전체나 새 기능까지 확대하지 않는다. 직전의 명시적 제안과 원래 요청 경계까지만 승계한다.
선택지가 실제로 결과를 바꾸는 경우에만 질문한다. 단순 진행 승인을 받기 위한 다지선다는 만들지 않는다.
Decision-Gating은 범위 안의 가역적 실행을 허용하는 규칙이지, 범위 확장이나 승인되지 않은 원격 작업을 허용하는 규칙이 아니다.
승인된 PR 흐름의 commit 완료 보고는 checkpoint다. push가 이미 승인 범위에 있으면 다시 허가를 묻지 않는다. 반대로 commit 요청만 받은 상태에서 push하려면 gate가 필요하다.
명시적 연속 지시라도 merge 직후에는 cadence-retrospective의 현재 평가와 처리 규칙을 적용한다.
branch를 전환했는데 생성했다고 하거나, commit하지 않았는데 commit 완료 신호를 붙이면 승인 범위를 지켰더라도 사용자에게 잘못된 상태를 전달한다. 보호된 행동은 preflight뿐 아니라 실제 도구 결과를 확인하는 postcondition까지 통과해야 한다.