# with — brief

**What:** `with.bowden.works` — the ground-up rebuild of `work.bowden.works` (time
tracking, invoicing, credit-card pass-through billing), growing into multi-agency project
management + bookkeeping. One container: FastAPI + SQLAlchemy 2/Alembic serving a Vite
React SPA, with a Postgres 17 sidecar. BW-account auth (Pattern B, account mode).
**Why:** Replace the aging `work.bowden.works` at feature parity, from a complete,
adversarially-reviewed plan, with minimal owner interaction.
**Who:** Rian (owner); adi has an account. A Bowden Works product (the future `works/` tenant).
**Status:** Under active milestone build (the M0–M9 ladder). The old app
(`work.bowden.works` on Supabase) stays the live source of truth until cutover (M9).
Current milestone, blockers, and next item live in `BUILD-STATE.md`.

## Where everything is
This project predates the `brief.md` convention and is already fully documented in its own
idiom — this brief is just the single entry point into it.

| Role | Lives in |
|---|---|
| Orientation ("where everything is" map) | `README.md` |
| Operating rules for build sessions (the "boss") | `CLAUDE.md` |
| Current milestone, blockers, session log (plans + handoff) | `BUILD-STATE.md` |
| The founding spec — 25 docs; ladder = `09-build-plan.md` | `/srv/apps/work/docs/rebuild/` |
| Project memory: feature docs, ADRs, acceptance checklist | `docs/` |
| Version history | `CHANGELOG.md` |

## Orient fast
Read this brief → `README.md` (the map) → `BUILD-STATE.md` (current milestone + next
unchecked item). Standards: `/srv/projects/standards/` (coding → react → frontend).
`make check` must pass before any deploy; confirm a deploy via the footer at
https://with.bowden.works (or `/api/meta`).