Complete AI Training
Sign inGet my AI kit

Your job's AI kit

Get your AI kit

Tell us who you are and what you do. We show you your kit right away and email you the link: skills, prompts, AI agents, MCP servers and courses for your job.

500+ jobs ready, and we make a kit for any other job. No payment needed to look.

Share

AI agent for software architects

Architecture Decision Record Agent

Every significant technical decision has an approved, linked decision record

CreatingWritingIT and developmentProduct development
See how it worksGet access
Architecture Decision Record Agent: what goes in, what the agent does and what you get

What it does

Teams make important technical choices in meetings and pull requests but rarely write down the options and reasons, so new people repeat old debates. This agent watches discussions and pull requests labeled as architecture work. It reads the thread and related documents and drafts an Architecture Decision Record with context, options, trade-offs and consequences. Each option needs at least one pro and one con. It then searches existing records and standards for conflicts, such as a new choice that contradicts an earlier standard. If it finds a conflict or a missing option, it adds it to the draft, asks the authors, and redrafts. Superseded records are linked, never deleted. The architect approves before the record is published and linked from the code. Edge case: a decision mentioned only once in chat stays a candidate until someone confirms it.

How it works

Follow the arrows from top to bottom. The orange dashed arrow is the loop: when a check fails, the agent goes back and tries again.

Start and resultWhat it doesA check on its own workWaits for your OKGoes back and retries
Yes, continueApprovedNo 1 STARTS WHEN Architecture-labeled discussion or pull requestopened 2 USES A TOOL Read the discussion and related documents 3 DOES Draft decision record with options and trade-offs 4 USES A TOOL Search existing records and standards for conflicts 5 CHECKS THE RESULT Is the draft complete and free of unresolvedconflicts? If not: add the conflict or missing option and ask theauthors. Back to step 3. 6 YOU APPROVE Architect approves the record 7 USES A TOOL Publish record and link it from the code anddiscussion 8 RESULT Published decision record
Read the steps as a list
  1. Architecture-labeled discussion or pull request opened
  2. Read the discussion and related documents
  3. Draft decision record with options and trade-offs
  4. Search existing records and standards for conflicts
  5. Is the draft complete and free of unresolved conflicts?If not: add the conflict or missing option and ask the authors. Back to step 3.
  6. Architect approves the recordThe agent waits here for your OK.
  7. Publish record and link it from the code and discussion
  8. Published decision record

How it decides

A draft is ready only when each option has at least one pro and con and no unresolved conflict with existing records.

  • Unconfirmed decisions stay as candidates
  • Superseded records are linked, not deleted
  • Each option needs pros and cons

Make it yours

Every agent is a starting point. You choose these settings for your own situation.

  • Record template
  • Labels that trigger it
  • Where records live
  • Who can approve

What keeps you in control

It always asks you first

  • Publishing or superseding a record

Hard limits

  • Never merges code
  • Never deletes records

It stops when

  • Done: record published
  • Stop: authors cannot agree, schedule a decision meeting

Set it up

We guide you through the set-up, step by step

Members get the full set-up guide for this agent. No technical skills needed: you copy, paste and upload.

10 minto set it up in your AI
5 AIsChatGPT, Claude, Copilot, Gemini, Grok
  • One set of instructions to paste into your AI, with the clicks for ChatGPT, Claude, Microsoft 365 Copilot, Gemini and Grok
  • The agent then walks you through connecting your own data, one source at a time
  • A downloadable copy with the flow chart, the rules and the full guide
Get access to this agent

An example run

What happensOn August 9 a pull request added a new message queue for order events. The agent drafted a record with three options. The conflict check failed: a 2024 record named a different queue as the company standard. The agent added the conflict and asked the authors whether to supersede it. They limited the change to event streams. The architect approved a new record superseding the old one for that case only.

More agents for software architects

Decisions · IT and development

Blockchain Use Case Feasibility Screen Agent

A fair, documented screen of a blockchain proposal with a clear recommendation

10 steps2 checks6 jobs
Decisions · Risk management

Static Analysis Findings Triage Agent

Turn a long findings list into confirmed fixes and justified suppressions

10 steps2 checks3 jobs
Coding · Quality control

Test Coverage Gap Closing Agent

Add tests to the riskiest untested code and prove that they catch real bugs

10 steps2 checks11 jobs
Decisions · IT and development

Model Selection Bake-Off Agent

Choose a model with evidence on quality, cost and speed for the real task

11 steps2 checks7 jobs