What is ADRs4AI?
ADRs4AI is a toolkit and method for recording the reasoning behind human–AI decisions so work can resume with its context intact. People capture rough thoughts in a seed, then use AI to organize them into decision records with options, reasoning, and unresolved questions. It is intended for people working with AI on projects, from first-time builders to experienced practitioners, and can also support groups of AI collaborators.
ADRs4AI Features:
Seed Capture: Start with an informal seed of your thinking, including dictated notes, and have AI organize it into ADRs that preserve your words.
Decision Records: Each ADR captures the options considered, the reasoning behind them, and open questions so decisions retain their context.
Open Questions: Questions are marked with a searchable QST tag and can be found with grep or surfaced in an editor extension, MCP server, or phone.
AI Recommendations: Each question can include options, an AI recommendation, its rationale, stated confidence, and evidence that could disprove it.
Human Rulings: Answer a question by accepting or overriding the recommendation, or by giving a response in another form.
Crew Workflow: An optional crew workflow supports multiple seats and wake-on-brief coordination among AI collaborators.
ADRs4AI Benefits:
Resumable Work: Returning to a project is easier because its decisions and the thinking behind them remain available rather than vanishing with a conversation.
Less Repetition: People can consult earlier reasoning instead of rebuilding context or revisiting questions they have already considered.
Focused Judgment: Recommendations and supporting rationale give people a clearer basis for deciding where to accept, challenge, or redirect AI input.
Shared Context: A durable decision record helps later contributors understand why a project took its current direction.
Reduced Coordination: The optional crew workflow can reduce the need for a person to relay every message between AI collaborators.
Use Cases:
Project Handoffs: Leave a record for someone joining a project later that explains the choices already made and the questions still open.
AI Session Continuity: Capture a working session’s reasoning so you can continue a project after the conversation ends or attention shifts elsewhere.
Rough Idea Capture: Turn an unstructured first pass or dictated thoughts into organized decision records without drafting each one from scratch.
Decision Review: Revisit an AI recommendation alongside its rationale and stated confidence before ruling on a project question.
AI Crew Coordination: Use the crew workflow when several AI collaborators need to work from shared project decisions and briefs.

