10

사용 예시

평이한 말로 클라이언트에게 — 자주 쓰는 표현과 그 표현이 호출하는 도구.

내 ground 둘러보기

당신: “내 Umtri ground들을 보여줘.”

클라이언트: list_projects를 호출하고, slug 목록과 마지막 활동 시각을 답합니다.

트리와 열린 버그 확인

당신: “myProject 그래프를 가져와서 아직 열려 있는 버그가 뭐 있는지 알려줘.”

클라이언트: get_graph(slug: "myProject")list_bugs(slug: "myProject", status: "open")을 호출한 뒤 산문으로 요약합니다.

버그 등록 (write 토큰 필요)

당신: “myProject에 버그 남겨줘: 예약 흐름이 환불 시 포인트를 잃음 — 꽤 위험.”

클라이언트: create_bug을 다음과 함께 호출:

{
  "slug": "myProject",
  "title": "예약 흐름이 환불 시 포인트를 잃음",
  "target": { "kind": "ground" },
  "score": 6
}

score는 0–8 변경 위험도(영향도 × 수정 난이도)이며, 생략 시 기본 4입니다.

plan으로 만들기 (대표 루프)

당신: payments limb 아래에 plan을 그려놨어 — 실현해줘.”

클라이언트:

  1. get_graph를 호출해 plan: true 노드를 브리프로 읽고,
  2. 자기 도구로 repo에 실제 코드를 작성하고,
  3. update_node로 파일을 기록(metadata.implements)하고,
  4. 실현된 노드를 commit_plan으로 승격 — implements가 없으면 거부됩니다.

머지 시 CI가 record_commit을 호출해 커밋이 영향을 준 노드에 표시됩니다. umtri://rules/plan 참고.

기존 프로젝트 옮겨심기

당신: “작년 구조를 이 새 ground에 재구성해줘.”

클라이언트: 새로 만든 ground는 옮겨심는 중이라, 에이전트가 어떤 시즌(과거 포함)에든 노드를 추가·수정하고 실수는 hard-delete할 수 있습니다. 구조가 자리잡으면 UI에서 Root this ground를 눌러 정상 모드로 잠급니다. umtri://rules/transplant 참고.

팁. 클라이언트가 도구가 없다고 하거나 403을 반환하면 토큰 스코프를 확인하세요. read 토큰으로는 어떤 write 도구도 호출할 수 없습니다.