Skip to content

Living documentation pipeline with auto-refresh and drift detection #26

@arnaudlh

Description

@arnaudlh

Description

The manifesto lists "living documentation" as a capability modules could never provide. Git-ape generates architecture diagrams but does not maintain them as living artifacts that auto-update with infrastructure changes.

Scope

  1. Auto-regeneration — After any deployment change, re-run the resource visualizer and update architecture.md.
  2. Dependency graph — Generate dependency graphs showing relationships between deployments.
  3. Documentation drift — Detect when architecture.md diverges from actual deployed state.
  4. Changelog — Auto-generate a changelog from deployment history (state.json changes).

Acceptance Criteria

  • Architecture diagrams auto-update on infrastructure changes.
  • Dependency graphs show cross-deployment relationships.
  • Documentation drift is detected and flagged.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions