Skip to content

Development Approach

Decisions from the dev meeting (30 June 2026):

DecisionDetailsReference
Yes to AIUnanimous. Start from André’s TDD multi-agent pipeline + shared playbook.
GitLab-firstWrite epics & issues in GitLab now; skip the old d.o queue to avoid a migration.Using GitLab to contribute to Drupal
Minimize dependencies”As much Drupal core as possible.” Discuss before any non-standard library.Using Composer with Drupal
Yes to HTMXIn core since 11.3 (Drupal 11.4 is current); use it for live interactions like comments.HTMX API documentation
Reuse componentsBase the UI on the new d.o / “bluecheese” components; discuss before custom ones.Using Single-Directory Components
Ship fast, review at the endDevs run independently, no mandatory peer review; a larger review gate before hand-off.

Work split: John → Matrix · André → infra/AI + remainder · Nico + Salman → picking areas.

The project records significant technical choices as Architecture Decision Records (ADRs). These are stored in the repository under docs/decisions/ (browse the docs/decisions/ tree in GitLab) rather than published as site pages, so each decision stays a versioned repo record next to the code it affects. We follow the MADR format, a common ADR standard building on Michael Nygard’s original ADR concept.