ADR 0004: Keep the existing documentation tooling

Date: 2026-09-11 · Status: accepted for this repository · Implementation: documentation reset.

Context

The available repository already contains a Docusaurus site. The new product needs a knowledge base and separate Rust and Next.js workspaces. mdBook was suggested during brainstorming but is not a product requirement.

Decision

Keep Docusaurus in aidj-docs, replace the previous product's content, and organize platform specifications, research, ADRs, RFCs, and roadmap here. Use aidj-platform as the Rust workspace and retain the user-supplied Next.js app in aidj-ui. Do not publish to inherited infrastructure by default.

Consequences

The docs remain buildable while software is scaffolded independently. CI validates the site without deploying to the previous product's registry or GitOps repository. Set the real site URL and deployment destination when those are established. Generated API documentation will later come from versioned software contracts.