ai-roots

executor(메인 세션 vs subagent vs team), 모델(Opus/Sonnet/Haiku), effort 레벨 중 무엇이 작업에 맞는지 정할 때 적용 — 즉 사소하지 않은 작업을 위임하기 전에. 다운그레이드 엄격 조건(plan 정밀도 + 검증 루프), 에스컬레이션 트리거, blast-radius 오버라이드, subagent 브리핑 기준을 다룬다.

Apply when deciding which executor (main session vs subagent vs team), which model (Opus/Sonnet/Haiku), and what effort level fits a task — i.e. before delegating non-trivial work. Covers strict downgrade conditions (plan precision + verification loop), escalation triggers, blast-radius override, and the subagent briefing standard.

장시간 작업이 백그라운드에서 돌고 사용자가 완료나 진행 상황을 봐야 할 때 적용 — 완료 알림만(기본), Monitor를 통한 이벤트 스트림, ScheduleWakeup을 통한 인터벌 폴링 중 선택. 서브프로세스를 tmux split pane, sentinel 문자열, foreground tail/grep 루프로 감시하고 싶어질 때도 적용 — 그 패턴은 실패했고 post-mortem이 여기 있다. 결정 사다리, 안티패턴, tee 기반 사용자 가시 스트리밍을 다룬다.

웹을 둘러보거나, 페이지 내용을 추출하거나, 데이터를 긁거나, 사이트에서 수치를 가져올 때 적용하세요 — agent-browser(기본 lightpanda, 무겁거나 상호작용이 필요한 페이지는 chrome), 발견용 WebSearch, 차단 본문 회수용 insane-search 스킬 중에서 고릅니다. agent-browser가 차단/빈/동적 콘텐츠를 돌려줘서 다른 엔진으로 재시도하거나 형제 URL을 추측하고 싶어지는 순간에도 적용 — 브라우저 에스컬레이션을 멈추고 검색 기반 도구로 전환하세요. Codex --search는 교차검증 전용 GPT 의존 최후 수단입니다.

Apply when a long-running task runs in the background and the user needs visibility into its completion or progress — choosing between completion-notification-only (default), streamed events via Monitor, and interval polling via ScheduleWakeup. Also apply when tempted to monitor a subprocess via tmux split panes, sentinel strings, or a foreground tail/grep loop — that pattern failed and its post-mortem lives here. Covers the decision ladder, anti-patterns, and tee-based user-visible streaming.

Apply when browsing the web, extracting page content, scraping data, or fetching figures from sites — choosing between agent-browser (lightpanda default, chrome for heavy/interactive pages), WebSearch for discovery, and the insane-search skill for retrieving blocked content. Also apply the moment agent-browser returns blocked/empty/dynamic content and you are tempted to retry with another engine or guess sibling URLs — stop escalating the browser and switch to a search-based tool. Codex --search is the GPT-dependent last resort for cross-provider verification only.

OpenAI Codex CLI에 작업을 위임할 때 적용 — Claude가 막힌 뒤의 rescue 디버깅(three-turn 상한), cross-provider/보안 민감 리뷰, 최신 docs 웹 리서치, 또는 범위가 정해진/무인 구현. 모드와 플래그 선택, reasoning effort, rescue protocol, plan-stage review, 실행 메커니즘을 다룬다. Codex CLI가 PATH에 있을 때만 트리거할 것.

작업 결과가 불확실할 때 적용하세요 — 외부 API, 브라우저 자동화, 셸 이스케이프, 익숙지 않은 라이브러리, 데이터 파이프라인. 전체 스크립트를 짜서 대규모로 한 번에 돌리지 말고, 가장 작은 검증 단위로 쪼개 각 단계의 실제 출력을 확인한 뒤 다음 단계를 쌓으세요.

작업을 병렬화할 수 있을 때 적용 — sequential, subagent, team 중 선택; inline vs subagent 결정; foreground vs background 실행. 에이전트를 띄우기 전에, 또는 작업이 파일 3개 이상 또는 독립 서브태스크 2개 이상으로 퍼질 때 사용한다.

문제의 원인이 여러 계층에 걸쳐 그럴듯하게 나뉘어 있거나, 출력이 서로 독립적인 여러 판단 기준을 모두 통과해야 할 때 적용하세요 — 가설을 조사하거나 기준을 평가할 때 순차로 하지 말고 동시에 하라는 겁니다. 특히 뻔한 수정이 이미 실패했거나, 문제가 경계를 넘나들 때(config는 설정돼 있는데 동작은 틀린 경우) 쓰세요.

읽기는 했지만 실행해 보지 않은 코드를 포팅·디버깅·구현할 때 적용한다 — 소스를 읽은 것이 동작을 이해한 것이라고 가정하지 말고, 구체적인 입력으로 코드를 머릿속에서 돌려 실제 런타임 출력·DOM·응답·데이터 모양·부수효과를 예측한다.

Apply when delegating work to the OpenAI Codex CLI — rescue debugging after Claude is stuck (three-turn cap), cross-provider/security-sensitive review, current-docs web research, or bounded/unattended implementation. Covers mode and flag selection, reasoning effort, the rescue protocol, plan-stage review, and execution mechanics. Trigger only when Codex CLI is on PATH.

Apply when editing, writing, or reviewing CSS — stylesheets, scoped styles, inline style attributes, CSS-in-JS, or any framework styling (Tailwind, CSS Modules, Svelte/Vue scoped styles). Covers the closed spacing scale, box-model, cascade/specificity, overflow, flex/grid shrink, color/z-index tokens, and unit discipline. Do not trigger for tasks that do not touch styles.

Apply when a task outcome is uncertain — external APIs, browser automation, shell escaping, unfamiliar libraries, or data pipelines. Break the work into the smallest verifiable steps and confirm each step's actual output before building the next, instead of writing a full script and running it at scale.

Apply when work can be parallelized — choosing between sequential, subagents, and teams; deciding inline vs subagent; and foreground vs background execution. Use before spawning agents, or when a task fans out across three or more files or two or more independent subtasks.

Apply when a problem has multiple plausible causes across system layers, or output must pass multiple independent judgment criteria — to investigate hypotheses or evaluate criteria concurrently rather than sequentially. Use especially when the obvious fix already failed or the problem spans boundaries (config set but behavior wrong).

Apply when porting, debugging, or implementing against code you have read but not executed — to mentally run the code with concrete inputs and predict the actual runtime output, DOM, response, data shape, or side effect, rather than assuming that reading the source equals understanding its behavior.

pull request 본문이나 제목을 만들거나 수정할 때(gh pr create, gh pr edit, gh api PR 업데이트), 또는 PR 설명을 작성할 때 — 다른 스킬이나 워크플로가 PR 설명을 만들어내는 경우도 포함 — 적용한다. 본문은 최대 3줄 — 기본값이 아니라 하드 캡이며, 유일한 예외는 레포의 PR 템플릿이다. GitHub-flavored Markdown을 강제한다: ASCII 대시 불릿, task-list 체크박스, 백틱 코드 참조, 그리고 gh CLI 마크다운 손상을 피하는 안전한 API-PATCH 본문 전달.

Apply when creating or editing a pull request body or title (gh pr create, gh pr edit, gh api PR updates) or composing any PR description, including when another skill or workflow produces one. The body is capped at three lines — a hard ceiling, not a default — with the repo's PR template as the only exception. Enforces GitHub-flavored Markdown: ASCII dash bullets, task-list checkboxes, backtick code refs, and the safe API-PATCH body delivery that avoids gh CLI markdown corruption.

[ai-roots] 무엇이든 리뷰하는 두 평가자 리뷰 — 코드 변경, Claude가 방금 만든 plan·설계, 문서, config, 그 외 리뷰 가능한 무엇이든. 자연어 요청에서 산출물 종류를 판별하고, 두 평가자가 동일하게 접근할 하나의 구체적 산출물(git diff, 파일, 또는 temp 파일로 고정한 인라인 텍스트)로 결정한 뒤, 그 동일한 산출물에 대해 Claude Code subagent와 Codex를 종류별 기준으로 병렬 실행하고 rules/evaluation-integrity.md §Multi-advisor synthesis의 Agreed / Conflicting / Chosen-direction 포맷으로 종합한다. 대기 중인 코드, plan, 문서, 그 외 산출물의 리뷰를 요청하고 Claude와 Codex가 둘 다 있을 때 사용한다.

[ai-roots] Two-evaluator review of any artifact — code changes, a plan or design Claude just produced, a document, a config, or anything reviewable. From a natural-language request it determines the artifact kind, resolves ONE concrete shared artifact (a git diff, a file, or inline text captured to a temp file), then spawns a Claude Code subagent and a Codex run in parallel on that same artifact with kind-appropriate criteria, and synthesizes findings using the Agreed / Conflicting / Chosen-direction format from rules/evaluation-integrity.md §Multi-advisor synthesis. Use whenever the user asks to review pending code, a plan, a document, or any other artifact and both Claude and Codex are available.

CSS를 편집·작성·리뷰할 때 적용 — 스타일시트, scoped 스타일, 인라인 style 속성, CSS-in-JS, 또는 프레임워크 스타일링(Tailwind, CSS Modules, Svelte/Vue scoped 스타일) 전반. 닫힌 spacing scale, 박스 모델, 캐스케이드/specificity, overflow, flex/grid shrink, color/z-index 토큰, 단위 규율을 다룬다. 스타일을 건드리지 않는 작업에서는 트리거하지 말 것.