프로젝트 나무 키우기

노드의 다섯 계열

• Trunk — 도메인(앱·서비스)
• Limb — 기능 / 작업 분기
• Twig — 모듈 또는 관련 정보 묶음
• Leaf — 객체(클래스·파일·컴포넌트)
• Vein — 객체 내부 동작(메서드·함수)

위 계열은 순서대로 나무의 중심부터 가장 얇은 가지까지로 자랍니다. 위의 설명은 참조사항이며, 노드 위계는 배치를 안내할 뿐 엄격한 규칙은 아닙니다. 프로젝트 성격에 따라 그라운드 내부 규칙을 새롭게 정할 수 있습니다.

Trunk 추가 하기

Trunks 패널 또는 빈 배지의 안내를 통해 Trunk를 추가하세요. Trunk는 나무의 밑둥으로, 프로젝트의 주요 갈래나 도메인에 해당하며 나무 전반과 버그 배지 등에 쓰이는 색상을 정의합니다. Umtri에게 자동으로 색을 매칭하도록 하거나, 원하는 색상을 직접 골라보세요.

계획 모드 (Plan Mode)

계획 모드에서는 프로젝트의 성장 계획을 제시할 수 있습니다. 계획 모드에서 추가된 노드는 Plan Node로 표시되며, 아직까지는 실제 프로젝트 구조가 아닌 가상의 계획 구조로 기록이 남지 않고, 자유로운 수정이 가능합니다.

하위 노드 추가하기

부모 노드를 선택하여 Add Plan Node로 자식 노드를 추가할 수 있습니다. 즉, Trunk를 클릭하면 해당 Trunk에 하위 Limb를, Limb를 클릭하면 해당 Limb에 하위 Twig를 추가할 수 있습니다. 프로젝트의 형태에 맞춰 노드를 추가하세요.

성장 확정하기 (Commit)

Plan Node가 실제로 구현되면 커밋(commit)을 통해 확정할 수 있습니다. 커밋된 노드는 성장으로 반영되어 프로젝트가 자랍니다.

AI 에이전트와 연동하여 노드 편집 요청하기

AI 에이전트와 코드 베이스를 연동한 상태라면, 노드를 추가하거나 편집하는 일을 AI 에이전트를 통해 진행할 수 있습니다.

AI 에이전트와 계획 모드를 통해 소통하기

• 계획 모드에서 사용자가 직접 계획을 작성한 뒤 AI에이전트에게 읽도록 요청할 수 있습니다. Plan Node 작성은 전체 계획 수립 후 에이전트에게 전달해 프롬프트를 통한 명령에 비해 전반적인 프로젝트 계획을 이해시키고 보다 통합적인 개발을 가능하도록 도와줍니다.
• AI 에이전트에게 구현할 내용을 먼저 Plan Node로 작성하게 하여 개발 계획을 확인하는 용도로도 사용될 수 있습니다. AI 에이전트가 명령을 잘 이해하고 있는지 수립된 계획을 통해 소통의 간극을 확인할 수 있습니다.

종속성 (Edge) 및 API 추가하기

노드 사이의 관계는 두 종류로 기록합니다. 둘 다 노드를 선택하면 나오는 메뉴에서 추가하고, 방향이 있어 어느 쪽에서 어느 쪽으로 향하는지가 의미를 가집니다.

• 종속성(Edge) — 한 노드가 다른 노드에 기대어 만들어진 관계입니다. Add Dependency로 추가하며 두 가지 유형이 있습니다.
  • dependency — Source가 Target 위에 세워집니다. Target이 깨지면 Source가 영향을 받습니다.
  • data_flow — 데이터가 Source에서 Target으로 흐릅니다.
• API — 노드 사이의 호출 흐름입니다. 외부 연동이나 서비스 간 호출처럼 한 노드가 다른 노드를 부르는 관계를 From → To로 그립니다. Add API Connection으로 추가합니다.

영향 범위 확인하기 (Show impact)

노드를 선택하고 Show impact를 누르면 그 노드가 깨졌을 때 영향을 받는 노드만 남기고 나머지를 흐리게 표시합니다. 영향은 기록된 연결을 따라 전파됩니다 — 종속성은 Target에서 Source로, 데이터 흐름은 흐르는 방향으로, API는 호출받는 쪽에서 호출하는 쪽으로 번집니다.

연결이 기록되지 않은 노드는 영향 범위에 나타나지 않습니다. 영향 범위가 비어 있다면 영향이 없다는 뜻이 아니라, 아직 기록된 연결이 없다는 뜻입니다. 버그의 영향 범위도 같은 연결로 계산되므로, 주요 노드 사이의 연결을 기록해 두세요.