architecture-decisions

Cuts a new Docusaurus documentation version. Generates OpenAPI docs, runs pre-flight build, executes docusaurus docs:version, verifies versioned docs/sidebars/graph-data generation, and runs post-version build. Use when releasing a new documentation version.

Assists with developing and shipping code. Detects uncommitted changes, creates GitHub issues, manages branches, runs human-in-the-loop browser review, and creates pull requests. Use when shipping work or processing the issue backlog.

Creates a new Architecture Decision Record (ADR) for Factory-X. Interactively gathers type (Network 0xx / Use Case 1xx+), number, title, and metadata, then scaffolds the directory, README.md, and optional OpenAPI spec. Use when adding a new ADR to the documentation.

Reviews and quality-checks an existing Architecture Decision Record. Validates frontmatter, required sections, cross-references, normative language (RFC 2119), OpenAPI registration, and build integrity. Use when reviewing an ADR before merging.