Brownfield onboarding

Goal

Reach a state where /spec works on the next feature, the harness runs green (or with documented baseline drift), and the team is not blocked by years of accumulated lint/coverage debt.

Steps

1. Detect the stack. Run .github/scripts/detect-stack.sh > .specs/_stack.json. Record:

   • Java version, Spring Boot version
   • DB engine (Postgres/MySQL/H2/…)
   • Migration tool (Flyway/Liquibase/none/both)
   • Test stack (JUnit 4 vs 5, Testcontainers presence)
   • Build tool (Maven only for now)
   • OpenAPI spec presence

2. Run the harness once, capture baselines.