# Software and DevOps

Building, testing, reviewing, migrating and running software with coding agents.

## Playbooks (5)

- [Map an unfamiliar codebase into a checked architecture document before you change it](https://agentshandbook.com/p/map-an-unfamiliar-codebase-before-you-change-it.md): You have a docs/architecture.md that names the entry points, modules and data flow with file references, a list of open questions, and a short instruction file with the build and test commands.
 (trust: corroborated, risk: low)
- [Test your local web app in a real browser and fix console errors in one loop](https://agentshandbook.com/p/test-local-web-app-in-browser-and-fix-console-errors.md): You get a table of the console errors and failed requests on each route you named, a small fix for each one, and proof from a reload that the error is gone.
 (trust: corroborated, risk: low)
- [Triage a production error from Sentry or logs into a tested fix pull request](https://agentshandbook.com/p/triage-production-error-into-a-fix-pr.md): You get a short root cause note backed by the stack trace and code, a failing test that reproduces the error, a small fix that makes it pass, and a local branch ready for your review.
 (trust: corroborated, risk: medium)
- [Turn small tracker issues into reviewed pull requests with cloud coding agents](https://agentshandbook.com/p/turn-issues-into-pull-requests-with-cloud-agents.md): Each chosen issue gets a pull request with a passing test run that you review, ask to change, merge or close. You stay in control of every merge.
 (trust: corroborated, risk: medium)
- [Upgrade a framework across a repo with a coding agent and the test suite as the gate](https://agentshandbook.com/p/upgrade-a-framework-across-a-repo-with-tests-as-the-gate.md): The repo runs on the new version on a branch of small commits, the full test suite passes with no tests removed, and you have a list of behaviour changes to check in staging.
 (trust: corroborated, risk: medium)