Nemo12 Harness

Docs và artifact cạnh code ​

Chủ dự án 18.10.2026: tài liệu tách theo từng web app và đặt cạnh code; có khu riêng cho artifact UI. Lý do: sửa app nào thì docs của app ấy đi cùng commit, CI theo đường dẫn tự hiểu, và nếu sau này một app tách repo thì docs đi theo.

Mỗi app có ​

text
apps/<app>/
  CLAUDE.md                 luật riêng của app, Claude Code nạp khi làm trong thư mục này
  docs/                     PRD, SDD, runbook, quyết định UI, ảnh trước và sau
  design/
    prototypes/             bản nháp HTML/React, link claude.ai Artifact, link Figma (không vào build)
    assets.json             danh mục file nguồn và media trên R2: khoá, nguồn, giấy phép, ghi công
  public/  src/assets/      asset app thật sự dùng, nhỏ, đã tối ưu
  src/                      code

Docs dùng chung (platform, API, D1, design system) ở lại docs/ gốc. Site harness này cũng theo luật ấy: nội dung nằm ở apps/harness/docs/.

Luồng nâng cấp UI ​

  1. Làm prototype nhanh: claude.ai Artifact hoặc Figma.
  2. Chủ dự án duyệt.
  3. Phiên của làn app làm vào code.
  4. Ảnh trước và sau, quyết định, ghi vào apps/<app>/docs/.

Mỗi làn làm chủ thư mục design/ của app mình, nên các phiên không đụng nhau. File nặng của artifact (render, .blend, PSD) theo quy tắc lưu trữ: lên R2, không vào git.