Use Case · Version Control

PR and commit docs without the write-up tax.

Summarize what a change does and why — by voice — and Dicty turns it into a reviewer-ready PR description and a clean commit narrative.

The problem

Great code ships with a one-line PR body. Reviewers reverse-engineer intent, and the "why" is lost to git history forever.

With Dicty

Dicty reads your diff, listens to your explanation, and produces a structured PR description plus a summarized changelog entry.

The flow

From spoken thought to filed doc.

01

Point at the diff

Attach the open PR or a range of commits as context.

02

Narrate the change

Describe the intent, the risky bits, and the testing you did.

03

Generate the write-up

Dicty drafts summary, motivation, and reviewer notes sections.

04

Post & link

Push it to the PR and file a matching changelog entry in your hub.

Faster reviews

Reviewers get intent up front instead of guessing from the diff.

Diff-aware

Summaries reference the actual files and functions that changed.

Changelog for free

A user-facing changelog line is generated alongside the PR body.

pr-482-description.md
## Summary
Move refund logic to an event-sourced ledger.

## Why
Support team needs an auditable trail for disputes.

## Reviewer notes
Focus on `ledger/projector.ts` — new read model.

Stop writing docs. Start speaking them.

More use cases