Skip to main content

arch-lens

Static analysis tool that generates Architecture Decision Records from code diffs and PR descriptions

Overview

arch-lens analyses pull requests, commit messages, and code diffs to automatically surface and draft Architecture Decision Records. It reduces the gap between what teams build and what they document.

Quick Start

# .github/workflows/adr.yml
- uses: example/arch-lens@v1
  with:
    output: docs/adr
    format: markdown

Features

  • Extracts architectural signals from PR descriptions and diffs
  • Generates structured ADR drafts in Markdown or JSON
  • GitHub Actions and GitLab CI integration
  • Configurable signal patterns via .arch-lens.yml
  • Links ADRs to the commits that triggered them
Statusactive
LicenseMIT
Last commit3 days ago
Versionv1.2.0
Buildpassing
stars847
forks92
contributors11
Back to Projects