03
스킬 분할
하나의 거대한 "코딩 잘하기" 문서는 아무것도 활성화하지 못한다. 13개 dev 스킬 패밀리는 변경 표면별 라우터와 필요할 때만 열리는 references로 나뉜다 — 컨텍스트는 예산이고, 규칙은 점진 공개된다.
라우터 다이어트: 각 SKILL.md는 트리거와 최소 규칙만 싣고, 깊은 레시피는 references/로 밀어낸다. 읽지 않은 규칙은 없는 규칙이므로, 분할 기준은 주제가 아니라 "언제 읽히는가"다.
A13-스킬 패밀리
정본(canonical) 패밀리는 pabcd_initiative/skills/의 13개다: 범용
라우터 dev 하나와 표면별 라우터 12개. 2026-07-02 75-grade
업그레이드(라우터 다이어트, 2026 최신성 소싱, freshness 스탬프)에서
cli-jaw로부터 스냅샷했고, 이후 에이전트 중립으로 하드닝됐다. 다운스트림
포트는 개수가 다를 수 있다 — codexclaw 플러그인은 dev 접두 폴더가
15개(dev-diagram-viewer 추가, dev-pabcd는 pabcd/로 이동)인데, 이는
어댑트 포팅이지 정본 로스터가 아니다.
pabcd_initiative/README.md:7-8 · roster: ls pabcd_initiative/skills/
| 스킬 | 한 줄 목적 (SKILL.md 원문) |
|---|---|
| dev | "Universal dev discipline: work classifier, overlays, verification gate, safety rules." |
| dev-architecture | "Module boundaries, circular deps, coupling taxonomy, and boundary defenses." |
| dev-backend | "Framework-agnostic backend guidance for APIs, architecture, data access, and operations." |
| dev-code-reviewer | "Code review router: findings, severity, verdicts, and review workflow." |
| dev-data | "Data pipelines, ETL/ELT design, quality validation, SQL optimization, and analysis." |
| dev-debugging | "5-phase systematic root-cause debugging method for real failures in any language." |
| dev-devops | "Container builds, deploy pipelines, K8s, IaC, SRE, edge/serverless, ML infra." |
| dev-frontend | "Frontend implementation with responsive, accessible, anti-slop UI guidance." |
| dev-pabcd | "PABCD orchestration workflow for interview, phases, attest, and checkpoints." |
| dev-scaffolding | "Project and module scaffolding with repo-first convention reuse and structural audits." |
| dev-security | "Security as a build constraint: OWASP, auth hardening, secrets, supply chain." |
| dev-testing | "Testing and QA router: strategy, harness choice, CI gates, TDD, and coverage." |
| dev-uiux-design | "Design judgment for vague briefs, UX states, typography, layout, logos, and brands." |
각 행: pabcd_initiative/skills/*/SKILL.md:5 (short-description) 원문 인용 — 13개 파일 전수 실존 확인
B라우터 + references — 점진 공개
모놀리스가 실패하는 이유는 컨텍스트가 예산이기 때문이다. 계층형 로딩 규칙: 주입된 스킬의 라우터 SKILL.md는 항상 읽고, references/는 과업이 그 주제를 건드릴 때만 열며, 전체 preload는 금지된다. 캐싱 작업이면 caching.md만 읽는 식이다. 서브에이전트에게도 그 하위 과업에 필요한 것만 주입한다.
pabcd_initiative/skills/dev/SKILL.md:408-413 (§8 Token Budget Awareness, tiered reference loading)
라우터는 얇게 유지된다: 버전 고정이나 시간 민감 주장은 references/에 Sources 행(URL + 확인 날짜)과 함께 살고, 라우터는 frontmatter의 last-verified 스탬프만 진다(FAMILY-FRESH-01).
pabcd_initiative/skills/dev/SKILL.md:176-178
라우팅 자체는 선택이 아니라 의무다: 해당 표면의 코드를 쓰기 전에 그 dev-* 라우터의 SKILL.md를 반드시 읽는다(DEV-ROUTE-01, STRICT). 역할 스킬을 받은 서브에이전트는 라우팅 테이블만 읽고, 테이블이 명시적으로 가리킬 때만 reference를 연다.
codexclaw/plugins/codexclaw/skills/dev/SKILL.md:135-138 · :47
가시성도 2계층이다: 암묵 노출 집합은 {dev, search, interview, pabcd, recall, loop, dev-frontend, dev-uiux-design}뿐이고, 나머지 dev-* 라우터는 전부 on-demand — 명시 멘션, 트리거 매치, 또는 dev 라우팅으로만 로드된다.
codexclaw/plugins/codexclaw/skills/dev/SKILL.md:184
C2026-07-05 하드닝 — 다섯 규칙
de-branding("Jawdev" 제거 — 루틴은 opt-in 스타일이 아니라 익명 규칙)과 함께 다섯 규칙이 추가됐다.
pabcd_initiative/README.md:10-17
| 규칙 | 내용 |
|---|---|
| DIFFLEVEL-ROADMAP-01 | 멀티페이즈 유닛이면 첫 P가 모든 페이즈 문서를 diff-level 정밀도로 작성 — 빈 스캐폴드로 "사이클마다 채우기"는 불만족. |
| PHASE-SPLIT-01 | 페이즈는 의존성/아키텍처 순서로 슬라이스 — effort 버킷팅(quick win vs heavy) 금지. |
| LEXICO-SPLIT-01 | 모든 유닛 문서는 숫자 접두사 — 연구(00 범위)와 구현 설계(decade 범위)는 별도 문서, 혼합은 감사 FAIL. |
| UNIT-RESIDENCE-01 | 모든 작업은 유닛(devlog/_plan/YYMMDD_slug/)에 거주 — C0-C1도 번호 달린 기록 문서는 남긴다. |
| SOT-SYNC-01 | 일반 SoT 문서를 P에서 찾고 같은 유닛의 C에서 패치 — SoT와 코드가 조용히 갈라지지 않게. |
D깊이는 분류가 정한다 — C0-C5
모든 과업은 프로세스 깊이를 고르기 전에 분류된다(DEV-CLASS-01). C0 사소한 텍스트부터 C4 고위험(Full PABCD 의무), C5 연구/모호(인터뷰·연구 먼저, 그 후 재분류)까지 — 최대 프로세스를 기본값으로 적용하지 않는다. 스킬 분할과 같은 원리다: 규율의 비용은 위험에 비례해야 한다.
pabcd_initiative/skills/dev/SKILL.md:14-27 (§0.0 Work Classifier)
E2026-07-12 조율 — 세 축
dev-* 패밀리 전반의 역할, 상속, 탐색 경로를 한 번에 맞췄다. 각 스킬이 자기 전문 영역을 분명히 지키면서도, 범용 규율과 인접 스킬의 책임을 놓치지 않도록 구조를 조율한 작업이다.
E.1 Role Boundary (역할 경계)
13개 dev-* 스킬 모두에 동일한 Role Boundary 블록을 두고 세 계층의 소유권을 명시했다. anti-slop 역시 프로세스 위생, 방향 판단, 렌더링된 구현 tell 탐지로 나뉘어 중복 없이 이어진다.
| 소유자 | 책임 |
|---|---|
dev | 범용 프로세스, 증거, 안전 규칙과 output/process hygiene를 소유한다. |
dev-uiux-design | 디자인 의도, 방향, 콘셉트와 취향 판단을 소유한다. 방향이 generic하거나 domain-wrong인지 판별한다. |
dev-frontend | 구체적 구현과 렌더링된 implementation tell 탐지·제거를 소유한다. |
codexclaw/plugins/codexclaw/skills/dev/SKILL.md — Family Invariants / Role boundary · dev-uiux-design/SKILL.md · dev-frontend/SKILL.md
E.2 dev-is-canonical 상속 (Canonical Inheritance)
모든 dev-* 자식 스킬이 이제 한 줄로 정본 상속을 선언한다:
dev §0.2 Rule Classes, §3 Verification Gate, §5 Safety Rules는
보편 적용된다. 이전에는 13개 중 10개 스킬에 부모 정본 게이트를 가리키는
명시적 포인터가 없었다.
| 체크 | Before | After |
|---|---|---|
dev §0.2/§3/§5 상속 | 3/13 | 13/13 |
| C0/C1 fast-path | 12/13 | 13/13 |
| Agent clarity C-level | 3개 | 0개 |
E.3 양방향 교차참조 (Bidirectional Cross-References)
12개 sibling 스킬의 directed graph를 분석해 A가 B를 참조하지만 B는 A를 참조하지 않는 비대칭 edge 18개를 찾았다. 18개를 모두 해소한 결과 비대칭 edge는 0개, 대칭 pair는 33개가 됐다. 이제 어떤 스킬에서 시작해도 자신을 참조하는 모든 sibling으로 되돌아갈 수 있다.
| 소유권 분할 | 해결된 경계 |
|---|---|
security ↔ devops | supply-chain security policy와 operational scan execution을 분리했다. |
code-reviewer | security review를 canonical security owner가 아니라 pre-scan으로 규정했다. |
scaffolding | cross-cutting section의 책임을 placement-only로 한정했다. |