Engineering · Skill
Architecture Decision Records
Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.
Open in PhởWhat the skill covers
The sections of its instructions, in order.
- 01 When to Use This Skill
- 02 Core Concepts
- 1. What is an ADR?
- 2. When to Write an ADR
- 3. ADR Lifecycle
- 03 ADR Management
- Directory Structure
- ADR Index (README.md)
- Automation (adr-tools)
- 04 Review Process
- 05 Best Practices
- Do's
- Don'ts
Reference files
2 files Phở can open while it uses the skill.
- references/decision-templates.md
- references/deprecation-rfc-templates.md
More in Code quality and tooling
- Code Review Excellence
Master effective code review practices to provide constructive feedback, catch bugs early, and foster knowledge sharing while maintaining team morale. Use when reviewing pull…
- Debugging Strategies
Master systematic debugging techniques, profiling tools, and root cause analysis to efficiently track down bugs across any codebase or technology stack. Use when investigating…
- E2E Testing Patterns
Master end-to-end testing with Playwright and Cypress to build reliable test suites that catch bugs, improve confidence, and enable fast deployment. Use when implementing E2E…
- Git Advanced Workflows
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing…
- Monorepo Management
Master monorepo management with Turborepo, Nx, and pnpm workspaces to build efficient, scalable multi-package repositories with optimized builds and dependency management. Use…
- Nx Workspace Patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.
- Turborepo Caching
Configure Turborepo for efficient monorepo builds with local and remote caching. Use when setting up Turborepo, optimizing build pipelines, or implementing distributed caching.
- Bazel Build Optimization
Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.
- Changelog Automation
Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing…
- OpenAPI Spec Generation
Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API…
- Angular Migration
Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and dependency injection updates. Use when upgrading AngularJS applications, planning…
- Dependency Upgrade
Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use when upgrading framework versions, updating major…
- React Modernization
Upgrade React applications to latest versions, migrate from class components to hooks, and adopt concurrent features. Use when modernizing React codebases, migrating to React…
- Bash Defensive Patterns
Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance…
- Bats Testing Patterns
Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven…
- ShellCheck Configuration and Static Analysis
Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or ensuring script portability.
- Before You Build
Pre-build product and feature risk review for founders, product managers, and AI-assisted builders. Use this skill when the user is about to build a landing page, MVP, SaaS…
Similar engineering skills
Frequently asked questions
What does Architecture Decision Records do?
Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.
Is Architecture Decision Records free to use?
Yes. Architecture Decision Records is published by Seth Hobson under the MIT licence, and you can use it with a free Phở account.
How do I use Architecture Decision Records in Phở?
Press Open in Phở, then Try to apply it to your next message, or add the Code quality and tooling set so Phở loads it whenever a request matches.
Does Architecture Decision Records need other tools?
No. It works in a normal Phở chat with what you type or upload.
Copied unchanged from wshobson/agents at commit 7e2fb55 and credited to Seth Hobson, who is not affiliated with Phở. The full instructions and licence text ship with the skill inside Phở.