Deciduous: 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로 설명을 생성한 뒤 웹 뷰어를 실행하는 명령

용어 해설

컨텍스트 압축(Context Compaction): — LLM의 컨텍스트 창 제한으로 인해 오래된 대화 내용이 요약되거나 삭제되는 현상이다. 이 과정에서 과거의 세부적인 의사결정 근거나 시도했던 대안들이 소실되어 AI의 추론 능력이 저하되는 원인이 된다.
방향성 비순환 그래프(DAG): — 노드들이 일정한 방향으로 연결되되 순환하지 않는 구조를 의미한다. Deciduous에서는 목표에서 결과로 이어지는 의사결정의 인과관계를 논리적으로 표현하는 데 사용된다.
전문 검색 엔진 5(FTS5): — SQLite에서 제공하는 텍스트 검색 확장 모듈이다. Deciduous의 Q&A 인터페이스에서 과거의 질문과 답변 히스토리를 빠르게 검색하고 관련 노드를 찾는 데 활용된다.
수정 전 훅(Pre-edit Hook): — 코드가 실제로 수정되기 직전에 실행되는 자동화 스크립트이다. AI가 코드를 변경하기 전에 현재의 목표나 의사결정 노드가 기록되었는지 확인하여 데이터 누락을 방지하는 역할을 한다.

기술

Rust
Claude API
SQLite
Git
Homebrew
Cargo

활용 사례

AI 협업 개발 중 컨텍스트 소실 방지
신규 팀원 온보딩을 위한 아키텍처 결정 히스토리 제공
복잡한 리팩터링 과정에서의 의사결정 추적 및 검증

언급된 리소스

GitHubDeciduous GitHub Repository

DemoDeciduous Live Decision Graph Demo

# 프로젝트 초기화 및 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: AI 협업 개발을 위한 의사결정 그래프 도구

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

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

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

관련 토론

댓글

관련 피드

관련 토론

댓글

관련 피드