graph-engineeringlisted
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