awesome-repositories.com
Blog
MCP
awesome-repositories.com

Discover the best open-source repositories with AI-powered search.

ExploreCurated searchesOpen-source alternativesSelf-hosted softwareBlogSitemap
ProjectMCP serverAboutHow we rankPress
LegalPrivacyTerms
© 2026 Bringes Technology SRL·VAT RO45896025·hello@awesome-repositories.com
npryce avatar

npryce/adr-tools

0
View on GitHub↗
5,518 stars·632 forks·Shell·16 views

Adr Tools

adr-tools is a command-line utility for automating the creation, indexing, and management of architecture decision records. It generates and maintains a log of technical choices using a series of version-controlled markdown files.

The tool facilitates software architecture governance by tracking the evolution of decisions through git-based versioning and milestone tagging. It allows for the initialization of decision logs and the management of technical debt by marking previous decisions as superseded or obsolete.

The system utilizes template-driven file generation to create standardized records and employs a sequential naming convention for file-system indexing. It tracks the state of decisions through header updates and leverages git commits to maintain an auditable history of architectural changes.

Features

  • Architecture Decision Records - Provides a comprehensive system for documenting and tracking technical design choices and their rationale.
  • Markdown-Based Knowledge Bases - Stores decision logs as version-controlled, platform-agnostic markdown files for maximum portability.
  • Git Versioning Managers - Uses git commits and tags to maintain a permanent, auditable history of architectural changes.
  • Markdown Documentation Systems - Automates the creation and indexing of structured markdown documents for maintaining technical project records.
  • Git-Based - Relies on distributed version control to track the modifications and evolution of architecture records.
  • Architectural Governance - Maintains a formal history of technical decisions to ensure team alignment and provide architectural context.
  • Template-Driven Generators - Generates standardized architectural record files by injecting dynamic data into predefined markdown templates.
  • Architecture Milestone Tagging - Creates signed git tags to track specific release milestones within the architectural decision history.
  • Decision State Transitions - Provides mechanisms to transition architectural decisions between active, superseded, and deprecated states via header updates.
  • Technical Debt Management - Tracks technical debt by documenting the trade-offs of architectural choices and their eventual supersession.
  • Documentation Tools - Command-line utility for creating and managing architectural decision records.

Star history

Star history chart for npryce/adr-toolsStar history chart for npryce/adr-tools

How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.

AI search

Explore more awesome repositories

Describe what you need in plain English — the AI ranks thousands of curated open-source projects by relevance.

Start searching with AI

Frequently asked questions

What does npryce/adr-tools do?

adr-tools is a command-line utility for automating the creation, indexing, and management of architecture decision records. It generates and maintains a log of technical choices using a series of version-controlled markdown files.

What are the main features of npryce/adr-tools?

The main features of npryce/adr-tools are: Architecture Decision Records, Markdown-Based Knowledge Bases, Git Versioning Managers, Markdown Documentation Systems, Git-Based, Architectural Governance, Template-Driven Generators, Architecture Milestone Tagging.

What are some open-source alternatives to npryce/adr-tools?

Open-source alternatives to npryce/adr-tools include: thoughtbot/til — This project is a git-based documentation site and markdown knowledge base designed as a searchable archive of… xwmx/nb — nb is a command-line note manager and personal knowledge management system that organizes plain-text documents and web… microsoft/code-with-engineering-playbook — This project is a software engineering playbook providing a collection of standardized guidelines and processes for… foambubble/foam — Foam is a personal knowledge management system that organizes information into a navigable web of interconnected… artempyanykh/marksman — Marksman is a Language Server Protocol implementation for Markdown that provides advanced editor features including… codimd/server — This project is a self-hosted note-taking platform and collaborative markdown wiki. It functions as a real-time…

Open-source alternatives to Adr Tools

Similar open-source projects, ranked by how many features they share with Adr Tools.
  • thoughtbot/tilthoughtbot avatar

    thoughtbot/til

    3,932View on GitHub↗

    This project is a git-based documentation site and markdown knowledge base designed as a searchable archive of technical cheat sheets and guides. It functions as a repository for short technical tips and code examples to facilitate team knowledge sharing and developer onboarding. The system employs a version control workflow to manage the submission, review, and publishing of technical learnings. It includes utilities for commit management and history consolidation, as well as the ability to retrieve specific files across different branches. Security is handled through the use of system-leve

    View on GitHub↗3,932
  • xwmx/nbxwmx avatar

    xwmx/nb

    8,210View on GitHub↗

    nb is a command-line note manager and personal knowledge management system that organizes plain-text documents and web bookmarks. It functions as a Markdown knowledge base, allowing users to create a structured collection of information through a shell-scripted interface. The system uses Git for versioning and synchronization, tracking full revision history and enabling the sync of notebooks across multiple devices via remote repositories. It provides security for sensitive data through AES-256 or GPG encryption and supports document conversion into various publishing formats using the Pandoc

    Shellarchivingbashbookmark-manager
    View on GitHub↗8,210
  • microsoft/code-with-engineering-playbookmicrosoft avatar

    microsoft/code-with-engineering-playbook

    2,608View on GitHub↗

    This project is a software engineering playbook providing a collection of standardized guidelines and processes for managing the full software development lifecycle and team operations. It serves as a high-level framework for organizing agile project management, API design, containerized development standards, and markdown documentation workflows. The framework establishes a system for language-agnostic API design to automate client library generation and documentation. It also defines standards for providing uniform contributor environments and toolchains through virtualized containers. The

    Dockerfile
    View on GitHub↗2,608
  • foambubble/foamfoambubble avatar

    foambubble/foam

    17,220View on GitHub↗

    Foam is a personal knowledge management system that organizes information into a navigable web of interconnected markdown files. It functions as a knowledge graph tool, utilizing wiki-style bidirectional linking and metadata to track relationships between documents and concepts. By storing data in standard text files, the system ensures long-term portability and compatibility with external tools. The platform distinguishes itself through its integrated visualization and automation capabilities. It generates graphical maps of file connections to help users identify patterns and discover relati

    TypeScriptgraph-visualisationmarkdownmarkdown-editor
    View on GitHub↗17,220
See all 30 alternatives to Adr Tools→