AGENT SKILL

graph

이슈·ADR 그래프 — "지금 뭐부터 잡을 수 있어"(ready 프론티어), "이 키들 레인 어떻게 나눠"(위상정렬 파도 + 파일 겹침 검사), "그래프 정합 검사"(사이클·없는 키·상태 모순), "ADR 타임라인/반전 이력"(마크다운에서 supersedes 추출). 사용자가 "뭐부터 해야 돼", "착수 가능한 이슈", "ready 목록", "레인 나눠줘", "병렬로 돌려도 돼?", "의존성 그래프", "차단 이슈", "그래프 lint", "ADR 타임라인", "이 결정 몇 번 반전됐어", "/caseworker:graph" 라고 하면 이 스킬을 쓴다. 계산은 전부 scripts/graph.mjs 가 한다 — 모델은 결과를 읽고 설명·제안만 한다.

License 许可
MIT
最近更新
2026-11-02
Stars
★ 0
Forks
0

01 前言 Front Matter

name
graph
description
이슈·ADR 그래프 — "지금 뭐부터 잡을 수 있어"(ready 프론티어), "이 키들 레인 어떻게 나눠"(위상정렬 파도 + 파일 겹침 검사), "그래프 정합 검사"(사이클·없는 키·상태 모순), "ADR 타임라인/반전 이력"(마크다운에서 supersedes 추출). 사용자가 "뭐부터 해야 돼", "착수 가능한 이슈", "ready 목록", "레인 나눠줘", "병렬로 돌려도 돼?", "의존성 그래프", "차단 이슈", "그래프 lint", "ADR 타임라인", "이 결정 몇 번 반전됐어", "/caseworker:graph" 라고 하면 이 스킬을 쓴다. 계산은 전부 scripts/graph.mjs 가 한다 — 모델은 결과를 읽고 설명·제안만 한다.

03 SKILL.md 正文

/caseworker:graph — 이슈·ADR 그래프

<P> = 플러그인 루트(이 스킬 디렉터리의 두 단계 위). 모든 명령은 프로젝트 루트에서 node "<P>/scripts/graph.mjs" <명령> --json.

데이터가 어디서 오나

  • 노드 = local 트래커의 case(.caseworker/cases/<KEY>/issue.json) + 엣지에 등장하는 ADR 키(ADR-N)
  • 엣지 = .caseworker/graph.jsonl(append-only, cases.mjs link 와 adr-timeline --write 가 쓴다) + case 의 parent 필드(파생)
  • 엣지 6종: blocks · parent-child · relates-to · duplicates · supersedes · discovered-from
  • 파생 인덱스 .caseworker/index.json 은 재생성 가능(build) — 지문이 다르면 ready 가 index_stale:true 로 알린다. 커밋하지 않는다.

jira 등 router 트래커에서는 case 노드가 없다 — graph.jsonl 의 링크와 ADR 만으로 adr-timeline·lint 가 돈다.

명령 → 언제 쓰나

물음 명령 읽는 법
뭐부터 잡을 수 있나 ready [--by <이름>] ready[] = open ∧ 미차단(blocks 의 from 이 done/abandoned 가 아니면 차단) ∧ 미선점. 비어 있으면 "차단 해제할 것" 을 lint·lanes 로 찾는다
이 키를 내가 잡는다 claim KEY --by <레인/사람> 배타 생성 — 이미 잡혀 있으면 exit 1 ALREADY_CLAIMED(누가·언제). 해제는 --release. implement 의 레인 fan-out 전에 레인마다 claim 한다
레인을 어떻게 나누나 lanes KEY,KEY,… [--touched <json>] waves[] = 같은 wave 안은 서로 의존이 없다(병렬 후보). --touched 에 {KEY:[파일…]}(plan 사이드카의 touched) 를 주면 conflicts[] 로 파일 겹침을 잡는다 — 겹치면 같은 wave 라도 병렬 금지(worktree 머지 충돌). cycle 이 있으면 순서를 정할 수 없다 → 의존을 끊거나 이슈를 합친다
그래프가 성한가 lint 위반: cycle · dangling-key(case 도 ADR 도 아닌 키) · parent-closed-child-open · in-progress-without-branch(issue-start 를 안 거친 착수) · duplicate-edge · self-edge. exit 1 이면 고친 뒤 재실행
결정이 어떻게 뒤집혔나 adr-timeline [--docs docs] [--pattern <헤딩 정규식>] [--write] 마크다운 헤딩의 ADR-N + 날짜 + "대체/반전/supersedes/→" 문장으로 타임라인. superseded_by 가 비어 있지 않으면 현행이 아니다. --write 면 supersedes 엣지를 graph.jsonl 에 남긴다(중복은 안 쓴다)

implement 단계와의 연결(stages.md §implement)

레인 2개 이상이면 fan-out 전에: ① lanes <keys> --touched <plan 사이드카에서 뽑은 {KEY:[files]}> → parallel_ok 가 아니면 레인을 다시 자른다(겹치는 파일을 한 레인에 몰거나 wave 를 나눈다) ② 레인마다 claim KEY --by <lane 이름> ③ 끝나면 --release. 이 순서를 건너뛰면 두 worktree 가 같은 파일을 고쳐 머지에서 터진다.

하지 않는 것

  • 그래프를 손으로 고치지 않는다 — graph.jsonl 은 cases.mjs link / adr-timeline --write 만 쓴다. 잘못 들어간 엣지는 사람이 그 줄을 지우고 lint 로 확인한다.
  • ADR 본문을 해석해 "무엇이 옳은가" 를 판단하지 않는다 — 타임라인은 문서에 적힌 반전 문장을 그대로 옮긴 것이다. 규칙의 정본은 프로젝트의 결정 원장이다.

04 同仓库更多 Skills

bigbulgogiburger
bigbulgogiburger/caseworker

setup

프로젝트에 caseworker 를 설치·점검·업그레이드하는 스킬 — 스택 자동 감지 → 트래커 선택(기본 local, 의존성 0) → harness.json 작성(멱등) → 마켓플레이스/플러그인 등록 → 전제 체크리스트 → 위반 주입 6종으로 게이트가 실제로 작동하는지 실측 확인까지 한 번에 진행한다. 사용자가 "하네스 설치", "하네스 설정", "하네스 셋업", "이 프로젝트에 caseworker 붙여줘", "게이트 설정해줘", "harness.json 만들어줘", "트래커 바꿔줘", "v2 에서 올려줘", "jira-harness 에서 옮겨줘", "업그레이드 해줘", "harness 점검", "harness check" 라고 하면 **반드시** 이 스킬을 쓴다. `.claude/harness.json` 이 없어 `/caseworker:issue` 가 `NO_HARNESS` 를 보고할 때도 이 스킬로 보낸다.

★ 0
bigbulgogiburger
bigbulgogiburger/caseworker

new

이슈 생성 — 자연어 한 줄 또는 문서(계획서·RFC·주차 계획)를 읽어 트래커에 이슈를 만든다. local 트래커면 `cases.mjs` 로 즉시, jira 면 MCP 로. 문서 기반이면 에픽→이슈→하위이슈 계층(parent-child 링크)으로 일괄 등록한다. '이슈 만들어줘', '이슈 등록', '이슈 생성', '에픽 만들어줘', '스토리 추가', '백로그에 추가', '이 문서 보고 이슈 등록해줘', '계획 문서를 이슈로 옮겨줘', '지라 이슈 등록해줘', '/caseworker:new' 등의 요청에 반드시 이 스킬을 사용하세요. 워크플로의 시작점으로, `/caseworker:issue` 착수 이전에 사용합니다.

★ 0
bigbulgogiburger
bigbulgogiburger/caseworker

loop

완성도 루프 엔진 — 임의의 코드 프로젝트에 까는 재사용 loop engineering 프레임워크 (Addy Osmani "Build the loop, stay the engineer"). "잘됨"을 계산 가능한 0~100 score 로 정의하고 score→triage→fix→verify→rescore 사이클을 돌려 숫자를 올리되, 모든 상승은 실환경 신호(DB 불변식·200+실데이터· 비-권한 403·벤치)에 결박한다(anti-gaming). 단일 진입점에서 4모드를 의도 추론으로 분기: init(코드베이스 스캔+인터뷰→.loop/ 생성) · score(재채점) · run N(N=1 attended 1바퀴+게이트, N≥2 무인 드라이버) · status(현황). **반드시 사용**: '루프 셋업', '루프 시작', 'loop init', '재채점', '완성도 몇 점', 're-score', '루프 N라운드 돌려', 'loop engineering N라운드', '다음 deficit', 'STOP 판정', '루프 현황', '다음 뭐 해야 돼' — 완성도 루프를 셋업·측정·전진·조회하려는 모든 맥락. 코드 프로젝트 전용(probe/fix=local 범위만, auto-merge 금지, maker≠verifier). 단순 단일 버그수정·일반 구현 요청엔 쓰지 말 것(그건 일반 작업 흐름).

★ 0
bigbulgogiburger
bigbulgogiburger/caseworker

kb-ingest

kb-ingest — Jira 이슈 KEY 가 없는 소스 (회의록, 클라이언트 회신, Mattermost 스레드, 세션 진단·결정 기록, 외부 문서, 구두 전달 정보) 를 코드 프로젝트의 docs/ 지식 wiki 에 ingest 합니다. 소스를 읽고 핵심을 추출해 docs/wiki/<도메인>.md 현재-상태 종합 페이지에 통합하고, INDEX.md 등재 + LOG.md 기록까지 수행합니다 (issue 스킬의 wiki 단계(scripts/wiki-row.mjs)와 references/_wiki-schema.md SSoT 공유 — 경계는 '소스에 이슈 KEY 가 있느냐' 하나). 사용자가 '이 회의록 ingest 해줘', '클라 회신 wiki 에 반영해줘', '이 문서 wiki 로', '오늘 회의 내용 기록해줘', '이 결정 wiki 에 넣어줘', 'kb ingest', '지식 등록', '세션 기록 wiki 반영' 등을 요청하거나, 회의록·회신·기록 파일을 가리키며 wiki 반영 의도를 보이면 반드시 이 스킬을 사용하세요. 파일 없이 말로만 전달된 결정 사항도 이 스킬로 wiki 에 기록합니다. ⚠ 개인 폴더 (결혼 준비 위키, 회사 업무 폴더 등) 의 파일 배치·정리는 이 스킬이 아니라 anthropic-skills 의 wiki-ingest 담당 — 이 스킬은 docs/INDEX-SCHEMA.md 를 가진 코드 프로젝트 wiki 전용입니다. Jira 이슈의 forecast/closure ingest 는 issue 스킬의 wiki 단계(scripts/wiki-row.mjs) 담당.

★ 0
bigbulgogiburger
bigbulgogiburger/caseworker

issue

이슈 트래커의 키(local 기본 · jira/github 어댑터 — `HX-a3f8` · `ABC-123` 꼴) 한 건 또는 여러 건의 개발 전 주기를 진행하는 라우터 — 브랜치·상태 JSON(start), 결정 인터뷰(grill), 계획 워크플로와 승인(plan), 구현(implement), Codex+워크플로 리뷰(verify), 컴파일·테스트 게이트(gate), 훅이 판정하는 commit/push, 마감(complete: push·wiki·트래커 전이). 사용자가 "/caseworker:issue KEY", "KEY 시작/착수/잡아줘", "이어서 해줘", "계획 세워줘", "리뷰 돌려줘", "게이트/테스트 돌려줘", "커밋해줘", "push 해줘", "마무리/QA 넘겨줘/완료 처리" 라고 하거나, 현재 브랜치가 이슈 브랜치(feat/KEY…)이면 반드시 이 스킬을 쓴다. 명시 호출이 없어도 이슈 키가 언급된 개발 요청이면 이 스킬로 지금 어느 단계인지부터 정한다.

★ 0
bigbulgogiburger
bigbulgogiburger/caseworker

grilling

Grill the user relentlessly about a plan or design until reaching shared understanding. Use when the user wants to stress-test a plan before building, get grilled on their design, or uses any 'grill' trigger phrases ('grill me', '그릴해줘', '계획 점검', '설계 털어줘'). 질문은 한 번에 하나, 선택형은 AskUserQuestion 선택지 UI로 렌더링한다.

★ 0