Architecture Decision Record
Research options, reason through tradeoffs, and document an ADR
Example Prompt
Write an ADR for choosing between PostgreSQL and DynamoDB for our event store
About
Creates a thorough Architecture Decision Record by researching available technology options via web search, reviewing existing codebase patterns in the repository, and systematically reasoning through tradeoffs for each alternative. The final ADR follows a standard template with context, decision drivers, considered options, outcome, and consequences.
Workflow Steps
Search the web for current best practices and technology comparisons relevant to the decision
🌐 Web SearchRead existing architecture files and patterns from the repository for context
📃 Read Repo FileSystematically reason through each option's tradeoffs considering the project's constraints
🧠 Structured ReasoningWrite the ADR document with context, options considered, decision, and consequences
✏️ Write FileTools Used
Web Search
Search the web using Brave Search and return relevant results with snippets
Write File
Write or overwrite a file at a specified path with the given content
Read Repo File
Read the contents of a file from a GitHub repository at a specific branch or commit
Structured Reasoning
Break down a complex problem into sequential reasoning steps with explicit chain-of-thought
Required MCP Servers
Brave Search
Privacy-first web search powered by Brave's independent search index
Filesystem
Read, search, and manage files on the local filesystem
GitHub
Access GitHub repos, issues, PRs, and code search via the official MCP server
Sequential Thinking
Dynamic problem-solving through structured thought sequences with branching and revision