baya-monorepo/archive/README.md

Archive

This folder is a historical record of how Balinyaar was built. It is not instruction. Nothing here describes current behaviour, current rules, or current plans. Do not follow a procedure from this folder. Current truth lives in docs/ and product/.

Everything here was written in the imperative, as a prompt for an agent to execute. The work described was executed weeks ago; the code has moved on since. Reading a file in this tree as if it were a live instruction is the exact failure mode this archive exists to prevent.

---

What's here

Folder	Was	Date range	Superseded by
build-chain/phases/	dev/phases/ — 32 executed build prompts (backend 0–15, frontend 0–15) plus _shared/ conventions	2026-06-28 (single day, all executed)	docs/rules/ (conventions), docs/flows/ (§7 "How to test" sections), docs/status/decisions.md (§5 "Critical rules")
build-chain/working-context/	dev/shared-working-context/ — per-phase STATUS files, 50 handoff/report files, the frontend request ledger, the mocks registry	2026-06-28 → 2026-07-20	docs/status/decisions.md, docs/status/implemented.md, docs/status/backlog.md (67 REQs → BL-###)
build-chain/contracts/	dev/contracts/ — the original hand-written API contract layer + the frozen 2026-07-13 OpenAPI snapshot	2026-06-28 → 2026-07-13	docs/integration/ (refreshed against 2026-07-29 code, domain-by-domain)
post-phase/	dev/post-phase/ — hardening (18 items), refinement (10 phases), server follow-up plans, and the 15-phase UI overhaul (plans + design audits)	2026-07-10 → 2026-07-28	docs/status/backlog.md (hardening + server items, re-verified against code, not trusted from checkboxes), docs/status/decisions.md (refinement decisions), docs/flows/testing-setup.md (RUNBOOK.md, manual-testing-plan.md), the frontend-designer skill (UI design reality)
manual-testing/	dev/manual-testing/ — two iterations of human testing notes + screenshots (the only visual record of the pre-overhaul UI)	2026-07-27	docs/status/backlog.md (unfinished items); screenshots are kept as-is, unlinked from any live doc
clarify-chain/	docs/_plan/ — the plan that produced this cleanup: inventory, contradiction log, and the eight phase files (including this move)	2026-07-29 → 2026-08-02	docs/README.md records when it ran; its content is itself now history

dev/README.md's own context (why this history exists at all — the derivation from an open-source starter, the phase-chain-then-post-phase-then-UI-overhaul shape) is folded into this file rather than kept as a separate leaf.

Known-stale content preserved as-is

A few contradictions between this archive and current reality were found and resolved by the chain that produced it, recorded in full in clarify-chain/open-contradictions.md. Two are worth flagging here because they sit in files a reader might otherwise trust:

• post-phase/manual-testing-plan.md and some of post-phase/refinement/RUNBOOK.md still instruct dotnet user-secrets — removed from the codebase in 5885280. Config lives in appsettings.*.json and .env.* files; see docs/README.md.
• post-phase/hardening/issues.md shows 18 of 18 items unticked as of 2026-07-17, but four later work chains ran without updating it. The real state is in docs/status/backlog.md, re-verified against code.

product/ is untouched

Nothing under product/ moved. It was, and remains, business truth, not build history.