What is Aven?
Aven keeps the rules behind a codebase available when changes are made. It checks every change against those rules and briefs AI coding tools before they edit. It is for developers who want code changes, including AI-assisted edits, to be considered in light of the rules that apply to their code. Aven brings those rules into both change checking and the moment before an AI tool starts work.
Aven Features:
Codebase Rules: Aven keeps the rules associated with a codebase, providing expectations that can be used when changes are made.
Change Checking: Each change is checked against the code's rules, tying the check to the expectations Aven keeps for that code.
Every Change: The checking applies to every change, rather than being limited to a selected change or a one-time review.
AI Briefings: Aven briefs AI coding tools with the rules behind the code before those tools start editing.
Pre-Edit Context: The briefing arrives before an AI coding tool edits, placing the code's rules in the process ahead of its work.
Rules for AI: The rules Aven uses to check changes are also used to brief AI coding tools before they edit.
Aven Benefits:
Consistent Changes: Checking changes against the code's rules can help keep edits aligned with the expectations already set for that code.
Earlier Context: Giving an AI coding tool the rules before it edits can help its work start with relevant code expectations in mind.
Fewer Reminders: A briefing gives the AI tool the rules without relying only on a developer to restate them in each editing request.
Focused Review: When changes are checked against stated rules, developers can focus their attention on whether each edit fits those expectations.
Connected Workflow: Using the rules for both change checks and AI briefings helps carry code expectations through review and assisted editing.
Use Cases:
AI-Assisted Coding: Use Aven when asking an AI coding tool to edit code and you want it briefed on the rules before it begins.
Checking Code Changes: Use Aven when you want each change to be checked against the rules that apply to the codebase.
Applying Code Rules: Use Aven when making code changes and you want the applicable rules considered as part of the change process.
Preparing AI Edits: Use Aven before AI-assisted editing when the coding tool needs the code's rules before it starts making changes.
Reviewing Rule Fit: Use Aven when checking whether a change fits the expectations already established for the code.

