메뉴
Use when creating a new framework (module) in this project — 신규 프레임워크 신설의 엔드투엔드 절차. Tuist 매니페스트·Workspace 등록부터 스킴 하드코딩 동기화, child CLAUDE.md·rules paths 확인까지. Triggers on "프레임워크 추가하자", "새 모듈 만들자", "Scene 프레임워크 신설". Does NOT trigger on 기존 프레임워크에 파일 추가(add-file 스킬).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when writing or modifying code in this project — 구현 착수, 플랜 실행, 버그 수정, 리팩토링 등 코드 diff를 만들기 시작하는 모든 시점. 직접 수정이든 서브에이전트 dispatch 구현이든 무관 — 코드는 서브에이전트가 만지고 메인 세션은 브리프만 쓰는 경우에도 첫 dispatch 전에 invoke한다. 플랜 파일 유무와 무관하게 적용. superpowers 코딩 절차(test-driven-development·executing-plans·subagent-driven-development)를 대체하지 않는 컴패니언 — 프로젝트 종속 절차(변경 경로→테스트 스킴 계산, tuist generate 시점, 짝지어진 두 위치, rules·구조 패턴 확인, 리팩터 게이트, 완료 판정)를 주입한다. Triggers on "구현하자", "플랜 실행하자", "고치자", "리팩토링하자", "서브에이전트 시켜서 구현하자" 등 코드 수정이 시작될 때 — superpowers 코딩 스킬과 함께 invoke. Does NOT trigger on 코드 조회·분석·설계 논의만 할 때.
Use when starting work on a GitHub issue — 이슈 번호/URL을 받아 스펙 파악(이슈·히스토리·코드베이스 탐색, 반문으로 미정사항 확정) 후, 구현 단위면 구현 계획 작성, 범위가 넓은 이슈면 하위 이슈 분해로 연결한다. Triggers on 이슈 번호·URL과 함께하는 모든 작업 착수 요청 — "이슈 N 시작하자/작업하자/진행하자/해보자/고치자", "킥오프", "#N 따서 시작". 이슈 언급 없이 코드 작업을 시작하려 할 때도 대응되는 이슈가 있는지 확인 후 이 스킬로 시작할 것. Does NOT trigger on 이슈 내용 조회·질문("이슈 N 뭐였지?", "N 요약해줘") — 작업 착수 의도가 있을 때만.
Use when writing an implementation plan in this project — 킥오프 A-3 전환, /plan 명시 호출, superpowers:writing-plans invoke 등 플랜 문서를 작성하는 모든 시점. writing-plans를 대체하지 않는 컴패니언 — 산출 플랜이 다른 세션이 플랜만 보고 착수 가능한 인수인계 문서가 되도록 프로젝트 종속 요구(스코프 경계, 커밋 시퀀스 사전 계획, 태스크별 모델 티어, 범위 명확성 전제, 자족성 체크)를 주입한다. Triggers on "플랜 짜자", "계획 작성하자", writing-plans 스킬 사용 시 함께. Does NOT trigger on 플랜 실행·이슈 분해·설계 논의만 할 때.
Use when the user requests an agent code review of an open pull request in this project — 공개된 PR에 대해 code-reviewer subagent를 다관점 병렬 dispatch하고 결과를 합산·검증해 인라인 코멘트로 게시한다. Triggers on "리뷰 돌려보자", "리뷰해줘" (PR이 올라간 상태에서). Does NOT trigger on PR 올리기 전 셀프리뷰(수행하지 않음), PR 공개 시점의 자동 실행(유저 지시가 유일한 트리거), SDD 내부 태스크 리뷰·최종 whole-branch 리뷰(superpowers subagent-driven-development 소관), 리뷰 반영 커밋 구성(commit 스킬), PR 본문 작성(pr 스킬).
Use when running a maintenance cycle on a project skill or subagent — usage-log 레코드를 4분류로 진단해 스킬 md 개정안(diff)을 만들고 유저 승인 후 반영·소비 마킹한다. Triggers on "스킬 정비하자", "improve-skill 돌리자", pr 스킬 머지 단계의 임계 초과 제안을 유저가 수락했을 때. Does NOT trigger on 스킬 신규 작성(superpowers:writing-skills), 코드 리뷰 피드백 반영(feedback-reinforcement-learning), 유저가 지시한 일회성 스킬 문구 수정(직접 수정).
Use when creating or merging a pull request in this project — PR 본문 작성, 브랜치 구성, 머지·머지 후 정리 시점. 본문 서사(문제→접근→남은 과제), rebase 머지 원칙, 머지 후 브랜치 정리(워크트리 제약 우회 포함)를 다룬다. Triggers on "PR 올리자", "PR 만들어", "머지하자", "브랜치 정리해". Does NOT trigger on PR 코드 리뷰 수행(review 스킬 또는 유저 직접), 커밋 메시지 작성(commit 스킬), 이슈 작성(issue 스킬).
| name | add-framework |
| description | Use when creating a new framework (module) in this project — 신규 프레임워크 신설의 엔드투엔드 절차. Tuist 매니페스트·Workspace 등록부터 스킴 하드코딩 동기화, child CLAUDE.md·rules paths 확인까지. Triggers on "프레임워크 추가하자", "새 모듈 만들자", "Scene 프레임워크 신설". Does NOT trigger on 기존 프레임워크에 파일 추가(add-file 스킬). |
타겟·스킴은 tuist가 자동 생성하지만, CI·스크립트의 스킴 목록은 전부 수동 하드코딩이다. §3 체크리스트에서 하나라도 빠지면 신규 모듈 테스트가 CI에서 조용히 실행되지 않는다 (실사례: AIAgentScene 신설 때 run-tests 스킬 목록 누락).
<위치>/<Name>/Project.swift — 팩토리 호출 (Tuist/ProjectDescriptionHelpers/Project+Templates.swift):
Project.frameworkWithTest(name:destinations:iOSTargetVersion:dependencies:) — 본체 + <Name>Tests 타겟 자동 생성, 테스트 의존성(UnitTestHelpKit·TestDoubles·Common3rdParty) 자동 주입 (Project.swift에 손으로 쓰지 않는다)Project.framework(...)<위치>/<Name>/<Name>.h — 모듈 루트에 헤더 파일 필수 (팩토리가 Headers.headers(public:)로 요구).Sources/, Tests/ 디렉토리 생성. 테스트 배치는 testability §8..project(target:path: .relativeToCurrentFile("../../<Layer>/<Module>")) 상대경로. Presentation Scene 표준 세트: Common3rdParty·CommonPresentation·Domain·Extensions·Scenes (선례: Presentations/AIAgentScene/Project.swift).Workspace.swift의 projects 배열에 프로젝트 경로 추가 — 빠지면 tuist가 모듈을 인식하지 못한다. 스킴은 autogeneratedWorkspaceSchemes: .enabled()로 자동 생성 (수동 .xcscheme 정의 불필요).TodoCalendarApp/Project.swift의 dependencies에 기본으로 추가하고 앱 타겟에서 임포트한다 — 앱이 의존해야 모듈이 앱 바이너리에 링크된다. 앱이 직접 안 쓰는 모듈(테스트 지원 등)만 예외.Presentations/Scenes/Sources/Scenes+<Name>.swift에 (presentations-rules §7).새 스킴 이름을 아래 전부에 추가한다 (CLAUDE.md §1 '짝지어진 두 위치' 등재 항목):
.github/workflows/pr_test.yml 3곳 — ① ALL_SCHEMES (+Presentation 모듈이면 ALL_PRESENTATION) ② detect-changes의 경로→스킴 매핑 블록 ③ test job의 Test <Scheme> 실행 stepscripts/run-all-tests.sh — ALL_SCHEMES 배열.claude/skills/implement/scripts/impact-check.sh — ALL_SCHEMES/ALL_PRESENTATION 상수 + 경로→스킴 매핑 블록 + 이 프레임워크에 의존하는 상위 레이어(Domain 등) 블록에 새 스킴 파급 추가 + impact-check.test.sh의 배열·assertion 갱신.claude/skills/run-tests/SKILL.md — 스킴 목록과 개수 문구CLAUDE.md — §2 모듈 구조 (스킴 목록은 run-tests 스킬이 정본 — 위 항목이 커버)<위치>/<Name>/CLAUDE.md 작성 (선례: Domain·Repository·CalendarScenes·EventDetailScene·EventListScenes·MemberScenes·SettingScene).Domain/**·Repository/**·Presentations/**·TodoCalendarApp/**·Supports/**) 밖이면 해당 .claude/rules/*.md frontmatter에 경로를 추가해야 자동 로드된다.mise exec -- tuist generate --no-open 재실행 (tuist install은 SPM 의존성 변경 시에만).bash .claude/skills/implement/scripts/impact-check.sh — 새 모듈 경로가 새 스킴으로 매핑되는지 확인../scripts/run-all-tests.sh <NewScheme>.