# thomvaill/log4brains

✍️ Architecture Decision Records (ADR) management and publication tool

Repository: https://github.com/thomvaill/log4brains
Canonical: https://ross.abutalabs.com/products/log4brains
Homepage: https://thomvaill.github.io/log4brains/
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: architecture-decision-records, architecture, knowledge-base, documentation, docs-as-code, markdown, tooling, static-site-generator, adr, generator, tool, developer-tools, architecture-decision-record
Last push: 2024-12-17T16:51:30+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2178, "days_push": 624, "days_rel": 624, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1569, forks 114 (observed 2026-08-28T04:05:05.095415+00:00)

## What it is
Log4brains is a docs-as-code tool for managing Architecture Decision Records (ADRs) written in Markdown within your git repository. It provides an interactive CLI for creating ADRs, local preview with hot reload, and static site generation to publish a searchable ADR knowledge base.

## Use cases
- manage architecture decision records as markdown files in git
- publish ADRs as a static documentation website
- create ADRs interactively from the command line
- build a searchable knowledge base of technical decisions
- onboard new developers with a timeline of past decisions
- review architecture decisions via pull requests

## When to choose
- your team wants a docs-as-code ADR workflow integrated with git
- you need to publish ADRs to GitHub/GitLab Pages or S3
- you work in a Node.js/TypeScript project and want an npm-based tool
- you want flexible markdown structure without enforced file numbering

## When to avoid
- you need a GUI-first ADR editing experience
- your stack has no Node.js runtime available
- you require features like RSS feeds or decision backlogs that are not yet implemented

## Facets
- artifact type: cli-tool
- maturity: active
- function: documentation, static-site-generator, cli, markdown
- domain: documentation, developer-tools
- platform: cli, cross-platform
- tags: adr, docs-as-code, knowledge-base, architecture-decision-records, static-site, architecture, nodejs

## Member repositories
- thomvaill/log4brains (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:05.095415+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:58:55.007039+00:00, confidence not recorded.
  - readme: https://github.com/thomvaill/log4brains (fetched 2026-08-28T04:05:05.095415+00:00, sha d3afd4f6ea55)
  - registry_npm: https://registry.npmjs.org/log4brains (fetched 2026-08-29T11:28:30.139149+00:00, sha ff71d201a513)
- Data as of 2026-08-30T08:39:29.467469+00:00.