ADR Ledger Documentation

Welcome to the adr-ledger documentation. This directory contains detailed guides and technical references for the Architectural Decision Record Ledger system.

Getting Started

• Repository Overview - Project overview and quick start.
• Architecture - High-level system design and principles.
• Platforms - Setup on NixOS, Linux, macOS, and Windows.

Technical Guides

• Agent Integration - How CEREBRO, SPECTRE, and others consume the ledger.
• Nix Guide - Using the NixOS modules and flake components.
• Validation - Detail on the layered validation pipeline.
• Export Guide - Documentation for the JSON/JSONL export system.
• Daemon Integration - NixOS modules and agent-user management.

Reference

• Stack Reference - Detailed technical stack and dependencies.
• Integration Analysis - Deep dive into ecosystem integrations.
• Project Improvements - Roadmap and planned enhancements.
• Release Roadmap - Publication and versioning plan.
• Spectre Architecture Decisions - Patterns and NLP analysis details.