Architectural Decision Records

• 001. Core Engine and Rule Framework Architecture
  • Status
  • Context
  • Decision
  • Alternatives
  • Consequences
• 002. Syntax Tree Analysis Technology Selection
  • Status
  • Context
  • Decision
  • Alternatives
  • Consequences
• 003. Configuration Management System
  • Status
  • Context
  • Decision
  • Alternatives
  • Consequences
• 004. Subcommand-Based CLI Architecture
  • Status
  • Context
  • Decision
  • Alternatives
  • Consequences

Current Decisions

001. Core Engine and Rule Framework Architecture

Hybrid modular architecture combining rapid prototyping with extensible plugin system for rule implementation.

002. Syntax Tree Analysis Technology Selection

LibCST adoption for concrete syntax tree analysis with rich metadata support enabling precise error reporting and future auto-fix capabilities.

003. Configuration Management System

TOML-based configuration with pyproject.toml integration, supporting rule parameterization, command-line overrides, and non-destructive user interaction via snippet generation.

004. Subcommand-Based CLI Architecture

Verb-based subcommand structure (check, fix, configure, describe, serve) with isolated option namespaces for different operational modes.

For ADR format and guidance, see the architecture documentation guide.