DECIDUOUS

Decision graph tooling for AI-assisted development.

Track every goal, decision, and outcome. Survive context loss. Query your reasoning.

Work smarter with careful rigor.

LLMs generate complex code fast. Reviewing it, understanding it, and maintaining it? That's on you. Deciduous gives you a structured record of every decision—what was considered, what was chosen, and why. No more losing institutional knowledge when context windows reset.

Know why things were done — Not just the code, the reasoning behind it
Review LLM output easier — See the decision flow, not just the result
Preserve context — Critical info survives session boundaries
Tighter feedback loops — Query past decisions to inform new ones
Share knowledge — Export decisions across teammates and time

The Problem

Claude (and LLMs generally) lose context. Sessions end, memory compacts, decisions evaporate. Six months later, no one remembers why you chose approach A over approach B.

Deciduous solves this by tracking every decision in a queryable graph that persists forever.

Goal

High-level objectives

Decision

Choice points with options

Option

Approaches considered

Action

What was implemented

Outcome

What happened

Observation

Technical insights

Explore the Development Process

Chains View ... decisions organized by chains and sessions. The project's memory. Timeline Git commits merged with decision nodes. Filter, search, trace. Graph Explorer Force-directed visualization. Zoom, pan, find paths between decisions. DAG View Hierarchical layout showing decision flow from goals to outcomes.

Real PRs Built With Deciduous

Every PR in this repo includes its decision graph. Here are some examples:

#11 Type Unification: TUI + Web with Enforcement Tooling 14 tracked decisions. JSON Schema as canonical source, validation scripts, git hooks, CI enforcement. Full decision tree in PR body. #3 Multi-User Graph Sync jj-inspired diff/patch model for sharing decisions across developers. UUID-based change_ids survive across databases. #9 TEA Architecture Refactor Functional core refactor of TUI using The Elm Architecture. Architectural decisions tracked throughout.

            # Install and set up in any project

            cargo install deciduous

            cd your-project

            deciduous init

            deciduous serve

Browse the Graph Tutorial View on GitHub crates.io

See It In Action

Watch a full session building with deciduous: initialization, decision logging, graph visualization, and context recovery.

The Workflow

The Story

Deciduous was extracted from losselot, an audio forensics tool that grew into an experiment in AI-assisted development.

The core insight: LLM sessions lose context, but the decision graph survives. Every goal, every rejected approach, every "why did we do it this way?" is preserved and queryable.

This isn't documentation written after the fact. It's a real-time record of how software gets built—captured as decisions happen, not reconstructed from memory later.

Deciduous is built exclusively using deciduous. Every feature, every bug fix, every architectural decision is tracked in its own graph.

Browse the live graph to see 340+ decisions from the development process.