alt-adr-writer

What problem does it solve?

Prevents informal or undocumented architectural decisions by producing a standardized, Japanese-language Architecture Decision Record tied to the exact working implementation and optionally performing a Pact-gated production deploy to ensure the recorded state is reproducible.

Core Features & Use Cases

• Automated verification: Runs minimum tests and rebuilds only affected services to confirm the implementation is green before documenting.
• ADR creation: Creates a new docs/ADR/NNNNNN.md using the project's template, enforces frontmatter fields and Obsidian-style wikilinks, and writes the content in Japanese following the template sections.
• Gated deployment: Commits ADR alongside code and executes the repository deploy workflow (./scripts/deploy.sh production) with Pact checks and healthchecks; supports skip flags for ADR-only or docs-only flows.
• Use case: After finishing a feature in the Alt monorepo, produce a discoverable ADR, validate the runtime behavior, and carry out the controlled production deploy.

Quick Start

Say ADR書いて to generate a Japanese ADR for the recent change, run the minimum tests and rebuild affected services, create docs/ADR/NNNNNN.md and commit it with the code, then execute ./scripts/deploy.sh production unless you explicitly request ADR-only.