criv

Keep repository documentation connected to the code it describes. criv validates notes, source references, and architectural decisions on your machine. It has no server and needs no network access.

Start with your agent

Tell the agent to initialize the repository first. If past project conversations or documentation are available, the agent can read them before it decides which lasting choices need ADRs.

mise install
criv init

# Agent task:
# Read existing documentation and, if available, past project conversations.
# Use them with the code to identify lasting architectural decisions.
# Create ADRs only for decisions supported by this evidence.

criv watch --once
criv check

Set up criv in a repository or learn how to find ADR candidates. You can also browse the generated documentation.

What criv checks

Docs can point to real files, symbols, structural patterns, and notes.
ADRs can govern the source paths and policy patterns they affect.
criv check reports broken links and invalid decisions before a change lands.