maintainability-agent docs

Index

maintainability-agent documentation

Every document in the repository, in one readable place: 76 rendered from markdown, plus 7 standalone pages. The markdown in the repository remains the source of truth.

Project

ACCESSIBILITY.md

Contributor Covenant Code of Conduct

CODE_OF_CONDUCT.md

CONTRIBUTING.md

Maintainability Agent

Maintainability Agent

Maintainability Agent

Maintainability Agent

Maintainability Agent

Maintainability Agent

README.zh-CN.md

Security Policy

Product and standard

Language Support and Detection Accuracy

docs/language-support.md

docs/philosophy.md

docs/product-intent.md

The report contract

docs/report-contract.md

Maintainability Audit Standard

docs/standard.md

Why this exists

docs/why-this-exists.md

Help

Help for the chat workflow

docs/help/README.md

What the analyzer pool runs

docs/help/analyzer-pool.md

First run and questions

docs/help/first-run.md

Reading the report and its history

docs/help/report-and-history.md

Languages

docs/languages/c.md

docs/languages/cobol.md

docs/languages/cpp.md

docs/languages/csharp.md

docs/languages/fortran.md

docs/languages/go.md

docs/languages/java.md

docs/languages/kotlin.md

docs/languages/php.md

docs/languages/ruby.md

docs/languages/rust.md

docs/languages/shell.md

docs/languages/swift.md

Decisions

ADR 001: Separate Maintainability Scoring from Evidence Verification

docs/adr-001-evidence-and-verification.md

ADR 002: Do not couple `verified_grade` to the existing CI gate

docs/adr-002-null-verified-grade-in-ci.md

ADR 003: Add deterministic semantic policy without changing the rubric

docs/adr-003-deterministic-semantic-policy.md

ADR 004: Keep economic context separate from score and grade

docs/adr-004-economic-context.md

ADR 005: Report no score when the population is too small to measure

docs/adr-005-insufficient-population.md

ADR 006: External analyzers produce the evidence; the agent orchestrates and corroborates

docs/adr-006-analyzer-evidence.md

ADR 007: Adopt the five-pillar framework, and separate practice maturity from code condition

docs/adr-007-pillars-and-practice.md

ADR 008: The translation layer, the decision engine, and the two entry points

docs/adr-008-translation-and-decision.md

ADR 009: Scan history — maintainability is a trend, not a snapshot

docs/adr-009-scan-history.md

ADR 010: Discovery — what is in this tree, and whose code is it

docs/adr-010-repository-discovery.md

ADR 011: Three report presentations from one report

docs/adr-011-three-report-presentations.md

ADR 012 — SpotBugs and the build boundary

docs/adr-012-spotbugs-build-boundary.md

ADR 013 — The hostile-audit prompt

docs/adr-013-hostile-audit-prompt.md

ADR 014 — Adversarial-properties detection: the absence-as-evidence half

docs/adr-014-absence-as-evidence.md

Decision register

docs/decisions.md

Audits and registers

Retrospective audit: v0.9.1 → v1.7.0

docs/audit-v091-v170.md

Work-order run, 2026-09-10 — the tool's own backlog, worked to a disposition

docs/audits/2026-09-10-work-order-run.md

Defect register: the chat surface

docs/defect-register-chat-surface.md

Security queue — 2026-08-23

docs/security-queue.md

Maintainability CI Report

docs/self-audit.md

docs/track-record.md

Plan and evidence

Extending the calibration corpus to eight languages

docs/calibration-2.0-study.md

Release plan: what it takes to finish

docs/release-plan.md

docs/roadmap.md

TypeScript semantic-policy prototype

docs/semantic-prototype.md

Studies and measured results

docs/studies.md

Target architecture

docs/target-architecture.md

Reference

Analyzer Adapters

docs/adapters.md

The analyzer pool: inventory, depth and license policy

docs/analyzer-pool.md

docs/architecture.md

Configuration Schema

docs/config-schema.md

Defects found auditing a private application, 2026-09-26

docs/defects-from-a-field-audit-2026-09-26.md

External Quality Tool Readiness

docs/external-quality-tools.md

IDE and Agent Integration

docs/ide-agent-integration.md

docs/machine-setup.md

Migrating from 0.6.x to 0.7

docs/migration-0.7.md

Migrating from 0.7 to 1.0

docs/migration-1.0.md

Migrating from 1.x to 2.0

docs/migration-2.0.md

PR and Baseline Workflows

docs/pr-and-baseline-workflows.md

FOSS code-quality tool inventory

docs/tool-inventory.md

Standalone documents

Bob and the Verification Gap v4.5.0

docs/Bob_and_the_Verification_Gap_v4.5.0.html

Bob and the Verification Gap v4.5.1

docs/Bob_and_the_Verification_Gap_v4.5.1.html

Bob and the Verification Gap v4.5.1 1

docs/Bob_and_the_Verification_Gap_v4.5.1_1.html

maintainability-report-3.7.13

docs/audits/maintainability-report-3.7.13.html

maintainability-report-3.7.16

docs/audits/maintainability-report-3.7.16.html

docs/example-report.html

docs/index.html

Rendered by tools/render_docs.py. The markdown is the source of truth.