PHPackages                             bellangelo/phpadr - 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. [CLI & Console](/categories/cli)
4. /
5. bellangelo/phpadr

ActiveLibrary[CLI & Console](/categories/cli)

bellangelo/phpadr
=================

A PHP based command-line interface tool for working with ADR

v1.0.3(1y ago)31.1k↓12.4%[2 issues](https://github.com/Bellangelo/phpadr/issues)MITPHPPHP >=7.2.5 || ^8.0

Since Nov 22Pushed 1y agoCompare

[ Source](https://github.com/Bellangelo/phpadr)[ Packagist](https://packagist.org/packages/bellangelo/phpadr)[ RSS](/packages/bellangelo-phpadr/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (3)Dependencies (5)Versions (4)Used By (0)

ADR Tools in PHP
================

[](#adr-tools-in-php)

[![Build Status](https://camo.githubusercontent.com/268910628bedb83932f7da1a6f50ae1d7a39bfbad1bebd4ef352d029fcc7bdc2/68747470733a2f2f7472617669732d63692e636f6d2f676c6f627465632f7068706164722e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/globtec/phpadr)[![Coverage Status](https://camo.githubusercontent.com/5ed115de60934e4de61374a35aea602613c73e9cd18545a13a607e84d0122037/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f676c6f627465632f7068706164722f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/globtec/phpadr?branch=master)

A PHP based command-line interface tool for working with Architecture Decision Records (ADR).

About ADR
---------

[](#about-adr)

Architecture Decision Records (ADR) is a technique for capturing important architectural decisions, along with their context and consequences as described by [Michael Nygard](https://twitter.com/mtnygard) in his article: [Documenting Architecture Decisions](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions).

Requirements
------------

[](#requirements)

- Requires PHP version 7.1.3 or newer
- Multibyte String extension

Installation
------------

[](#installation)

You can install this tool using the [Composer](https://getcomposer.org/), execute the following command.

```
composer require bellangelo/phpadr --dev

```

Usage
-----

[](#usage)

After of install this project you may execute the binary `phpadr` in your terminal:

```
./vendor/bin/phpadr

```

If to execute the command above, it will be showd a list of all avaliable tool commands.

By default the records will be stored in `docs/arch`, to change this workspace use the option `--config` with the path of the config file.

### Create a new ADR

[](#create-a-new-adr)

You may use the `make:decision` command:

```
./vendor/bin/phpadr make:decision  [] [--config="adr.yml"]

```

### Count the ADRs

[](#count-the-adrs)

You may use the `workspace:count` command:

```
./vendor/bin/phpadr workspace:count [--config="adr.yml"]

```

### List the ADRs

[](#list-the-adrs)

You may use the `workspace:list` command:

```
./vendor/bin/phpadr workspace:list [--config="adr.yml"]

```

### Help

[](#help)

For more help execute the following command:

```
./vendor/bin/phpadr  --help

```

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance25

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75.2% 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.

###  Release Activity

Cadence

Every ~29 days

Total

3

Last Release

530d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/9512427?v=4)[Aggelos Bellos](/maintainers/Bellangelo)[@Bellangelo](https://github.com/Bellangelo)

---

Top Contributors

[![globtec](https://avatars.githubusercontent.com/u/4707535?v=4)](https://github.com/globtec "globtec (91 commits)")[![Bellangelo](https://avatars.githubusercontent.com/u/9512427?v=4)](https://github.com/Bellangelo "Bellangelo (22 commits)")[![abachmann](https://avatars.githubusercontent.com/u/3432758?v=4)](https://github.com/abachmann "abachmann (6 commits)")[![hacfi](https://avatars.githubusercontent.com/u/428841?v=4)](https://github.com/hacfi "hacfi (1 commits)")[![tyx](https://avatars.githubusercontent.com/u/245494?v=4)](https://github.com/tyx "tyx (1 commits)")

---

Tags

documentationadragilityarchitecture-decision-recordsarchitecture-decision

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bellangelo-phpadr/health.svg)

```
[![Health](https://phpackages.com/badges/bellangelo-phpadr/health.svg)](https://phpackages.com/packages/bellangelo-phpadr)
```

###  Alternatives

[behat/behat

Scenario-oriented BDD framework for PHP

4.0k101.8M2.2k](/packages/behat-behat)[globtec/phpadr

A PHP based command-line interface tool for working with ADR

79250.3k2](/packages/globtec-phpadr)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[jolicode/castor

A lightweight and modern task runner. Automate everything. In PHP.

54743.1k4](/packages/jolicode-castor)[whatsdiff/whatsdiff

See what's changed in your project's dependencies

771.2k](/packages/whatsdiff-whatsdiff)[aeliot/todo-registrar

Register TODOs from source code in issue tracker

153.0k](/packages/aeliot-todo-registrar)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)