hamidArchive
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/andproduct/.
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.mdand some ofpost-phase/refinement/RUNBOOK.mdstill instructdotnet user-secrets— removed from the codebase in5885280. Config lives inappsettings.*.jsonand.env.*files; seedocs/README.md.post-phase/hardening/issues.mdshows 18 of 18 items unticked as of 2026-07-17, but four later work chains ran without updating it. The real state is indocs/status/backlog.md, re-verified against code.
product/ is untouched
Nothing under product/ moved. It was, and remains, business truth, not build history.