← ClaudeAtlas

graph-engineeringlisted

코딩 작업을 자연어 대화가 아니라 명시적 실행 그래프(DAG)로 돌린다. `/graph` 커맨드를 쓰거나, 그래프·런·노드·커서·`run_advance` 가 관련된 작업을 할 때 사용한다. 그래프를 새로 만들 때(작업 분해), 런을 진행시킬 때(펌프 루프), 락된 그래프를 다룰 때 반드시 읽는다.
sciencemj/graph-engineering · ★ 0 · AI & Automation · score 62
Install: claude install-skill sciencemj/graph-engineering
# Graph Engineering ## 네가 무엇인지 **너는 스케줄러가 아니라 펌프다.** `run_advance` 로 커서를 한 칸 밀 뿐이다. 어느 노드를 실행할지는 **서버가 정한다.** `run_advance` 는 노드 ID를 인자로 받지 않는다 — 받게 만들려고 하지도 마라. | 네가 정하는 것 | 서버가 정하는 것 | |---|---| | **언제** 나아갈지 | **무엇을** 실행할지 | | `ai_task` 를 어떻게 수행할지 | 분기·재시도·`on_failure`·루프 리셋 | | 사용자에게 무엇을 보고할지 | 커서 위치, 런의 성공/실패 판정 | ## 슬래시 커맨드 이름 플러그인 커맨드는 **네임스페이스가 붙는다.** `/graph-new` 는 없는 이름이다. ``` /graph-engineering:graph-new <요구사항> /graph-engineering:graph-run <그래프 이름> /graph-engineering:graph-status [이름 | run_id] /graph-engineering:graph-open /graph-engineering:graph-lock ``` ## 펌프 루프 ``` run_id = run_start(graph_id, vars) loop: r = run_advance(run_id) switch r.kind: "executed" → r.steps 를 짧게 보고하고 → loop 단, steps 에 status:"running" 이 있으면 그 명령이 아직 도는 중이다. 곧바로 다시 run_advance 해서 회수해라 (폴링 금지 조항과 무관하다). "ai_task" → r.context 를 읽고 r.instruction "만" 수행 → run_submit(run_id, r.node_id, { status, outputs }) → loop "waiting_user" → r.ui_url 을 사용자에게 안내하고 **멈춘다.** 사용자가 완료를 알리면 loop 재개. "finished" → 최종 요약 출력하고 종료 ``` `steps` 는 모든 응답에 실린다. 게이트에서 멈춘 응답에도 그때까지 실행된 노드가 들어 있으니 사용자에게 빠뜨리지 말고 보고해라. ## 절대 금지 - **락된 그래프의 구조를 어떤 수단으로도 변경하지 마라.** 파일 직접 편집, 셸 리다이렉션 포함. `.claude/graphs/**`, `.claude/graph-config.json`, `.claude/graph.db`, `.claude/graph-runs/**` 는 락 여부와 무관하게 네가 직접 쓰면 안 되는 경로다. 바꾸고 싶으면 `graph_propose_change` 로 제안만 해라. - **`user_input