Deciduous: AI 협업 개발을 위한 의사결정 그래프 도구

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

AI 코딩 어시스턴트와 협업할 때 발생하는 가장 큰 문제는 세션 종료나 컨텍스트 압축으로 인해 과거의 의사결정 근거가 사라지는 것이다. Deciduous는 이를 해결하기 위해 개발 과정의 목표, 대안, 결정, 실행 결과를 연결하는 영구적인 의사결정 그래프를 구축한다. Claude Code, Windsurf 등 주요 AI 도구와 통합되어 코드를 수정하기 전 결정을 기록하도록 강제하며, 기록된 데이터는 웹 뷰어와 자연어 Q&A 인터페이스를 통해 언제든 조회할 수 있다. 이를 통해 개발자는 수개월 후에도 특정 설계의 이유를 명확히 파악할 수 있으며, AI는 과거의 추론 과정을 바탕으로 더 일관성 있는 코드를 생성한다.

배경

CLI 환경 및 Git 워크플로우에 대한 이해, Claude Code, Windsurf 등 AI 코딩 어시스턴트 사용 경험, Rust 도구 설치를 위한 Cargo 또는 Homebrew 환경

대상 독자

AI 코딩 어시스턴트를 프로덕션 개발에 활용하며 컨텍스트 관리와 지식 보존에 어려움을 겪는 소프트웨어 엔지니어

의미 / 영향

AI가 생성하는 코드의 양이 급증함에 따라 '무엇을 짰는가'보다 '왜 그렇게 짰는가'를 관리하는 것이 소프트웨어 유지보수의 핵심 역량이 될 것이다. Deciduous는 AI와 인간이 공유하는 외부 기억 장치 역할을 수행함으로써 대규모 AI 협업 프로젝트의 안정성을 높이는 데 기여한다.

섹션별 상세

AI 협업 중 발생하는 컨텍스트 손실 문제를 해결하기 위해 영구적이고 쿼리 가능한 의사결정 그래프를 생성한다. LLM은 세션이 바뀌면 과거에 어떤 대안을 검토했고 왜 특정 방식을 거절했는지 잊어버리지만, Deciduous는 이를 CLI 기반으로 기록하여 지식의 연속성을 보장한다.

모든 의사결정은 '목표(Goal) → 옵션(Options) → 결정(Decision) → 실행(Actions) → 결과(Outcomes)'라는 표준화된 데이터 흐름을 따른다. 각 단계는 노드로 생성되며 엣지(Edge)를 통해 인과관계가 연결되어, 결과물로부터 최초의 목표까지 역추적이 가능한 구조를 형성한다.

bash

# 프로젝트 초기화 및 AI 어시스턴트 연동
deciduous init --claude --windsurf

# 의사결정 흐름 기록
deciduous add goal "사용자 인증 추가" -c 90
deciduous add option "JWT 토큰 방식" -c 80
deciduous add option "세션 쿠키 방식" -c 75
deciduous link 1 2 -r "API 중심 접근 방식"
deciduous link 1 3 -r "전통적인 웹 방식"

# 최종 결정 및 실행 기록
deciduous add decision "API는 JWT, 웹은 세션 사용" -c 85
deciduous link 2 4 -r "선택된 접근법"
deciduous link 3 4 -r "함께 통합됨"

Deciduous CLI를 사용하여 프로젝트를 초기화하고 목표부터 결정까지의 과정을 기록하는 기본 워크플로우 예시

주요 AI 코딩 어시스턴트인 Claude Code, OpenCode, Windsurf와 훅(Hook) 시스템을 통해 긴밀하게 통합된다. Pre-edit 훅은 AI가 코드를 수정하기 전 최근 15분 이내에 기록된 노드가 있는지 확인하여 기록 없는 코드 수정을 차단하고, Post-commit 훅은 Git 커밋과 그래프 노드를 자동으로 연결한다.

고급 분석 스킬인 /archaeology와 /decision-graph를 제공한다. /archaeology는 과거의 잘못된 결정을 찾아 '대체됨(superseded)'으로 표시하고 새로운 방향으로의 피벗을 기록하며, /decision-graph는 기존 프로젝트의 커밋 히스토리를 분석하여 과거의 의사결정 맥락을 그래프로 자동 복원한다.

웹 기반 시각화 도구와 Claude 기반의 Q&A 인터페이스를 지원한다. 사용자는 웹 뷰어에서 타임라인, DAG, 계층 구조 등 5가지 뷰로 프로젝트 진화 과정을 살필 수 있으며, 자연어 질문을 통해 '왜 이 시점에서 Redis를 선택했는지'와 같은 복잡한 배경 정보를 즉시 답변받을 수 있다.

bash

# 노드에 문서 및 다이어그램 첨부
deciduous doc attach 1 docs/architecture.png --ai-describe

# 웹 뷰어 실행
deciduous serve --port 3000

의사결정 노드에 아키텍처 다이어그램을 첨부하고 AI로 설명을 생성한 뒤 웹 뷰어를 실행하는 명령

실무 Takeaway

AI 코딩 어시스턴트 사용 시 deciduous add 명령어로 의사결정 단계를 실시간 기록하면 세션 종료 후에도 개발 맥락을 완벽히 유지할 수 있다.
Claude Code나 Windsurf 설정에 Deciduous 훅을 추가하여 코드 수정 전 의사결정 기록을 강제함으로써 팀 전체의 기술 부채와 지식 파편화를 방지할 수 있다.
기존 프로젝트에 도입할 경우 /decision-graph 스킬을 실행하여 과거 커밋 메시지와 PR 데이터를 기반으로 한 의사결정 히스토리를 자동으로 구축할 수 있다.

언급된 리소스

GitHubDeciduous GitHub Repository

DemoDeciduous Live Decision Graph Demo