docs: roadmap, development process, and ADR scaffolding #1

Merged

icub3d merged 1 commit from docs-development-process into main

2026-08-06 21:51:41 +00:00

icub3d commented

2026-08-06 21:49:23 +00:00

Owner

Adds the development-process scaffolding: a milestone roadmap, the workflow
and definition of done, and the ADR practice.

docs/ROADMAP.md — M1–M7, sequenced vertical-slice-first.
docs/development.md — workflow, done criteria, labels, fj reference
including the two gaps (milestones need the REST API; project boards have
neither API nor CLI).
docs/adr/ — template and ADR 0001 establishing the practice.
CLAUDE.md / README.md — pointers, plus the branch/PR working agreement.

Docs only, no src/ changes. cargo test, cargo clippy --all-targets -- -D warnings, and cargo fmt --check all pass.

Adds the development-process scaffolding: a milestone roadmap, the workflow and definition of done, and the ADR practice. - `docs/ROADMAP.md` — M1–M7, sequenced vertical-slice-first. - `docs/development.md` — workflow, done criteria, labels, `fj` reference including the two gaps (milestones need the REST API; project boards have neither API nor CLI). - `docs/adr/` — template and ADR 0001 establishing the practice. - `CLAUDE.md` / `README.md` — pointers, plus the branch/PR working agreement. Docs only, no `src/` changes. `cargo test`, `cargo clippy --all-targets -- -D warnings`, and `cargo fmt --check` all pass.

icub3d added 1 commit

2026-08-06 21:49:24 +00:00

docs: roadmap, development process, and ADR scaffolding 6ee9fbb5fb

The project had architecture rules in CLAUDE.md but nothing sequencing them
and no recorded place for work items. This adds:

- docs/ROADMAP.md — milestones M1–M7, built around a playable vertical slice
  first so the simulation/presentation split is proved while it is still cheap
  to move.
- docs/development.md — one issue / one branch / one PR, the definition of
  done, the label scheme, and what fj and the Forgejo API can actually do.
  Milestones have no CLI; project boards have no API. Both are noted so nobody
  goes looking for the command.
- docs/adr/ — template plus ADR 0001 establishing the practice.

The wiki stays a thin landing page on purpose: a wiki page cannot be reviewed
alongside the diff that invalidates it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

icub3d merged commit 2d7aa71cdc into main

2026-08-06 21:51:41 +00:00

icub3d referenced this pull request from a commit

2026-08-06 21:51:43 +00:00

Merge pull request 'docs: roadmap, development process, and ADR scaffolding' (#1) from docs-development-process into main

icub3d referenced this pull request

2026-08-06 22:06:54 +00:00

docs: record the fj and Forgejo quirks found while seeding the tracker #14