PHPackages oxid-esales/adr-tools - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. oxid-esales/adr-tools ActiveLibrary[Utility & Helpers](/categories/utility) oxid-esales/adr-tools ===================== Fork of npryce/adr-tools with madr additions 07Shell Since May 14Pushed 6y agoCompare [ Source](https://github.com/OXID-eSales/adr-tools)[ Packagist](https://packagist.org/packages/oxid-esales/adr-tools)[ RSS](/packages/oxid-esales-adr-tools/feed)WikiDiscussions master Synced today READMEChangelogDependenciesVersions (1)Used By (0) ADR Tools ========= [](#adr-tools) A command-line tool for working with a log of [Architecture Decision Records](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions) (ADRs). [![Build Status](https://camo.githubusercontent.com/89381c6175add55bdf6e2a117c90721b2b9006ab3cf92c07f88d98e7460f7d43/68747470733a2f2f7472617669732d63692e6f72672f6e70727963652f6164722d746f6f6c732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/npryce/adr-tools) Quick Start ----------- [](#quick-start) [Install ADR Tools](INSTALL.md). Use the `adr` command to manage ADRs. Try running `adr help`. ADRs are stored in a subdirectory of your project as Markdown files. The default directory is `doc/adr`, but you can specify the directory when you initialise the ADR log. 1. Create an ADR directory in the root of your project: ``` adr init doc/architecture/decisions ``` This will create a directory named `doc/architecture/decisions`containing the first ADR, which records that you are using ADRs to record architectural decisions and links to [Michael Nygard's article on the subject](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions). 2. Create Architecture Decision Records ``` adr new Implement as Unix shell scripts ``` This will create a new, numbered ADR file and open it in your editor of choice (as specified by the VISUAL or EDITOR environment variable). To create a new ADR that supercedes a previous one (ADR 9, for example), use the -s option. ``` adr new -s 9 Use Rust for performance-critical functionality ``` This will create a new ADR file that is flagged as superceding ADR 9, and changes the status of ADR 9 to indicate that it is superceded by the new ADR. It then opens the new ADR in your editor of choice. 3. For further information, use the built in help: ``` adr help ``` See the [tests](tests/) for detailed examples. The decisions for this tool are recorded as [architecture decision records in the project repository](doc/adr/). ### Health Score 19 — LowBetter than 9% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community16 Small or concentrated contributor base Maturity34 Early-stage or recently created project Bus Factor1 Top contributor holds 86% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1374817?v=4)[oxid](/maintainers/oxid)[@OxID](https://github.com/OxID) --- Top Contributors [![npryce](https://avatars.githubusercontent.com/u/56219?v=4)](https://github.com/npryce "npryce (135 commits)")[![sadraskol](https://avatars.githubusercontent.com/u/2914331?v=4)](https://github.com/sadraskol "sadraskol (4 commits)")[![sephlietz](https://avatars.githubusercontent.com/u/5513?v=4)](https://github.com/sephlietz "sephlietz (4 commits)")[![koppor](https://avatars.githubusercontent.com/u/1366654?v=4)](https://github.com/koppor "koppor (3 commits)")[![mtkoltan](https://avatars.githubusercontent.com/u/7591102?v=4)](https://github.com/mtkoltan "mtkoltan (2 commits)")[![martinklepsch](https://avatars.githubusercontent.com/u/97496?v=4)](https://github.com/martinklepsch "martinklepsch (1 commits)")[![jabley](https://avatars.githubusercontent.com/u/16205?v=4)](https://github.com/jabley "jabley (1 commits)")[![nusco](https://avatars.githubusercontent.com/u/17791?v=4)](https://github.com/nusco "nusco (1 commits)")[![olimart](https://avatars.githubusercontent.com/u/547754?v=4)](https://github.com/olimart "olimart (1 commits)")[![mklinke](https://avatars.githubusercontent.com/u/739522?v=4)](https://github.com/mklinke "mklinke (1 commits)")[![Jaxwood](https://avatars.githubusercontent.com/u/184838?v=4)](https://github.com/Jaxwood "Jaxwood (1 commits)")[![jhulten](https://avatars.githubusercontent.com/u/40279?v=4)](https://github.com/jhulten "jhulten (1 commits)")[![kevinjalbert](https://avatars.githubusercontent.com/u/574871?v=4)](https://github.com/kevinjalbert "kevinjalbert (1 commits)")[![lanzafame](https://avatars.githubusercontent.com/u/5924712?v=4)](https://github.com/lanzafame "lanzafame (1 commits)") ### Embed Badge ![Health badge](/badges/oxid-esales-adr-tools/health.svg) ``` [![Health](https://phpackages.com/badges/oxid-esales-adr-tools/health.svg)](https://phpackages.com/packages/oxid-esales-adr-tools) ``` ### Alternatives [hellonico/acf-country A country field for ACF. 12196.8k](/packages/hellonico-acf-country)[kirschbaum-development/nova-chartjs chart.js Chart Field for Laravel Nova 5147.1k](/packages/kirschbaum-development-nova-chartjs)[xobotyi/basen Text and integers encoding utilities for PHP with no extensions dependencies. Base32, Base58, Base64 and much more! 1220.4k](/packages/xobotyi-basen) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)