create-wakii-stack 0.0.0-stage → 0.1.1

package/stack-template/docs/superpowers/contexts/experience-design.md

@@ -0,0 +1,85 @@
+# EXPERIENCE-DESIGN — hợp đồng thiết kế Templates/Cinematic Experience (v1.0 — SF-1)
+
+> Nguồn: REF-SPEC (`docs/team/ref/REF-SPEC.md`, PO đo live 1280×800) + mindmap VU-53-CIN SF-1.
+> **Mọi SF code theo file này.** Sửa contract = PR riêng + lead duyệt. IP: số đo/cấu trúc tham
+> khảo ref — copy/ảnh/nội dung là Orca/Wakii (VN-flavored).
+
+## 1. Typography scale (REF-SPEC — đo computed, dùng đúng số)
+
+| Vai trò | Spec | Utility |
+|---|---|---|
+| Display / brand / CTA | **12px / 700 UPPERCASE / tracking 2.4px** | `text-[12px] font-bold uppercase tracking-[2.4px]` |
+| Label mono (kicker, CHƯƠNG 0X) | **11px / 700 UPPERCASE / tracking 2.64px / font-mono** | `font-mono text-[11px] font-bold uppercase tracking-[2.64px]` |
+| H1 hero | **18px / 300 LIGHT / uppercase / tracking 0.14em / line-height 1.6 / line-break chủ động** | `Typography.Title level={1}` + style |
+| H2 chapter | **~29px / 300 light / leading-snug / tracking 0.02em** | `text-[29px] font-light leading-snug tracking-[0.02em]` |
+| Hero editorial đoạn | **17px / 400 / leading 1.5** (cụm trái, KHÔNG caps) | `text-[17px] leading-[1.5]` |
+| Body | **12px / 400 / tracking 0.3px / leading 1.7** | `text-[12px] leading-[1.7] tracking-[0.3px]` |
+| Meta số (stats) | tabular-nums, 30px bold band / 3xl cards | `text-3xl font-bold tabular-nums` |
+
+Quy tắc: KHÔNG bold to (editorial LIGHT); heading lớn chỉ ≥3:1, body ≥4.5:1 (WCAG luminance — verify script trong story mood-engine).
+
+## 2. Palette 5 mood + hero/end (token + gradient stops từng chương)
+
+Token nền tự chủ (không theo theme — thêm 1 lần vào `styles/tokens.css`, đã có):
+`--hero-sky-a: #ffffff` · `--hero-sky-b: #e8edf4` · `--navy-ink: rgb(16,36,52)` ·
+`--hero-ink: rgb(16,36,52)` (cố định, KHÔNG flip dark) · `--chapter-bg-a: rgb(10,12,22)` ·
+`--chapter-bg-b: rgb(16,36,52)`.
+
+| # | Mood id | Chương | Gradient stops (background) | Ink | Dot/nhấn |
+|---|---|---|---|---|---|
+| 0 | `atlas` | Hero | `165deg, #cdd8f6 0% → var(--hero-sky-a) 55% → #dfe4fb 100%` (light-cố định) | `--navy-ink` (light) / trắng (dark) | `#ff5c39` ◆ |
+| 1 | `focus` | Ch1 Deep focus | `180deg, var(--chapter-bg-a) → var(--chapter-bg-b)` | `white/92` body · `white` heading | `--st-done` |
+| 2 | `docs` | Ch2 Living docs | `180deg, var(--chapter-bg-b) → rgb(10,20,38)` | `white/85` | `--accent` (duotone ảnh accent→done multiply) |
+| 3 | `velocity` | Ch3 Velocity | `180deg, var(--chapter-bg-a) → color-mix(in srgb, var(--accent) 14%, rgb(10,12,22))` | `white/92` | mood accent LIVE (`#5e6ad2/#0d9488/#ea580c` — text dùng `accent-hi` ≥4.5:1) |
+| 4 | `ship` | Ch4 Ship 3D | `180deg, rgb(10,12,22) → var(--scrim-4)` + ảnh `opacity-60` + `from-black/85 via-black/55` | `white` | `--accent` |
+| 5 | `future` | Ch5 + End CTA | `180deg, var(--c-s1) → var(--c-canvas)` (sáng trở lại) | `--ink` (theme-flip — nền sáng cả dark) | `--st-done` |
+
+Crossfade: `MoodBackdrop` (lib/scroll-mood) render 1 layer absolute/mood, opacity
+`clamp(0, 1 − |p×(N−1) − i|, 1)` với `p` = progress scroll toàn trang (rAF) — chạy mượt
+liên tục, không re-render content.
+
+## 3. Spacing scale
+
+| Khoảng | Giá trị |
+|---|---|
+| Section programmatic padding | `py-16` (chapter) · hero/end `min-h-screen` + `p-6` |
+| Content rail | `mx-auto max-w-5xl px-10` (max-md px-6) |
+| Grid chapter | `md:grid-cols-2 gap-8 items-center` |
+| Card gap | `gap-4` grid · `gap-2` list feature · `gap-10` KPI |
+| Pinned | section `h-[200vh]` + con `sticky top-0 h-screen overflow-hidden` |
+| Side-nav | `fixed left-6` w-44, offsetTop 0, ẩn < md |
+
+## 4. Motion vocabulary (duy nhất các hiệu ứng này)
+
+| Hiệu ứng | Thông số | Dùng ở |
+|---|---|---|
+| Parallax nền-gần-fixed | `speed 0.08 / strength 280` | hero BG · chapter BG · ch4 |
+| Parallax lớp giữa | `speed 0.3 / strength 240` | gate checklist · quote |
+| Parallax chữ dẫn đầu | `speed 0.5 / strength 280` | hero content · ch4 chữ |
+| Reveal | direction up/left/right · `delay 80–320ms, stagger +90ms` | sections/cards/features |
+| CountUp | `duration 1.2s` default · format vi-VN | KPI/CTA/ch1 |
+| Mask-reveal ảnh | `clip-path inset(0 X% 0 0)` theo `useSectionProgress` | ch2/ch3 ảnh |
+| Split-text reveal | từng chữ stagger CSS (template-local) | ch1 |
+| Mood crossfade | `MoodBackdrop` rAF — opacity nội suy tuyến tính | toàn trang |
+| Sun journey | cung sin x10→90% · y 20→8→20% · 4 pha | section riêng |
+| UI micro | 150–250ms + `--ease-enter/exit` · infinite CHỈ trạng thái (pulse WIP) | — |
+
+`prefers-reduced-motion`: Parallax/Reveal/CountUp/Scene3D tự tắt (frame tĩnh) — không chapter nào tự viết motion ngoài vocabulary.
+
+## 5. Ảnh-grade chuẩn (Avatar/Getty graded — mọi ảnh trong chapters)
+
+1. Ảnh gốc `grayscale` (Tailwind filter).
+2. Overlay duotone: `bg-gradient-to-tr from-accent/25 via-transparent to-st-done/20 mix-blend-multiply` (accent theo mood chương).
+3. Vignette mép: `[box-shadow:inset_0_0_90px_var(--scrim-2)]`.
+4. Mask-reveal clip-path khi muốn lộ dần (xem motion). Overlay nằm TRONG wrapper bị clip.
+
+## 6. A11y & quality gate
+
+- Chapter container: `<section id="chN" data-mood="<mood-id>" className="relative min-h-screen">`.
+- CTA là `button`/`a` thật; heading h2/chương; Icon trang trí aria-hidden (default).
+- Contrast: body ≥4.5:1, heading ≥3:1 — verify bằng script luminance (story mood-engine log số).
+- Chỉnh màu chapter KHÔNG dùng token flip (--ink/--ink2) — dùng white-alpha cố định (nền tự chủ tối).
+
+## 7. Đổi contract
+
+PR riêng sửa file này + đánh版本 v1.x. Chapter không theo contract = gate fail (lead check bằng số đo trong verify paste).

package/stack-template/docs/superpowers/contexts/sf-1.md

@@ -0,0 +1,39 @@
+# SF-1 Context Pack — Kafka foundation + async contracts
+> Đọc file này THAY VÌ tự tổng hợp. Epic spec: `docs/superpowers/specs/2026-10-13-kafka-outbox-saga.md` (rev 3). Mindmap: `docs/superpowers/mindmaps/kafka-outbox-saga.wakii`.
+> Story trước FI-62 đã merge (main @0785930) — repo CÓ code thật.
+
+## Spec slice (chỉ phần SF-1 chịu trách nhiệm)
+1. `platform/docker-compose.yml` thêm entry `kafka`: image `apache/kafka` (KRaft native, KHÔNG zookeeper), `KAFKA_HEAP_OPTS` ~512MB, healthcheck dùng **full path** `/opt/kafka/bin/kafka-broker-api-versions.sh --bootstrap-server localhost:9092` (image không có script trên PATH), KHÔNG service nào `depends_on` kafka, KHÔNG expose 9092 ra host. Cập nhật **header ownership** compose (SF-1 story này sở hữu).
+2. **PRE-ADD env cho downstream (P0 plan-critic — 1 lần sửa compose duy nhất)**: entry `node-svc` thêm `KAFKA_BROKERS: ${KAFKA_BROKERS:-kafka:9092}`; entry `go-svc` thêm `KAFKA_BROKERS` + `AUTH_MOCK_URL: http://auth-mock:8090` + `SVC_ACTIVITY_PASSWORD: ${SVC_ACTIVITY_PASSWORD:?set in .env}`. Đồng bộ `.env.example` (KAFKA_BROKERS, SVC_ACTIVITY_PASSWORD + các kafka env nếu cần). SF-2/3 KHÔNG đụng compose.
+3. `contracts/events/task-events.md`: envelope `{schemaVersion:1, id: UUID, type, occurredAt: RFC3339, payload}`; payload shape THEO EVENT TYPE (task.created/updated/assigned/deleted/assignment_failed — liệt kê fields chính xác: taskId, userId, assigneeId?, title?, status?); **filter-by-type convention**: group `go-svc-activity` xử lý mọi type TRỪ `task.assignment_failed`, group `node-svc-compensation` CHỈ nhận `task.assignment_failed`; topics `task-events` (1 partition) + `task-events.dlq`; retry ×3 in-memory rồi DLQ; manual commit sau DB tx; auto.offset.reset earliest.
+4. **Golden fixtures `contracts/events/fixtures/*.json`** — mỗi event type 1 file mẫu đúng envelope (P0 plan-critic: SF-2 relay test + SF-3 consumer test + CI console-producer ĐỀU load đây — contract machine-checkable 2 đầu).
+5. `platform/conventions/09-async-messaging.md`: quy tắc producer/consumer/retry/DLQ/idempotency (envelope id do producer sinh, consumer ON CONFLICT), lazy-connect rule (Kafka không vào readyz/depends_on).
+6. Fixture users: thêm `svc-fail` (email `fail@demo.local`) + `svc-activity` (service user) vào `contracts/auth/users.json` — roles `["user"]` khớp enum users.yaml (spring `SeedMatchIntegrationTest` so seed↔fixture runtime); auth-mock + spring V2 seed đọc tự nhiên (mount runtime, không cần migration mới vì CI volume fresh).
+7. `docs/adr/0008-*.md` supersede ADR-0006: vì sao Kafka KRaft, outbox tự viết (không Debezium), simplifications có chủ đích (presence-based trigger, in-memory retry count, PLAINTEXT, segmentio/kafka-go — franz-go là path production), saga choreography.
+8. README section compose: 10 services, kafka lazy-connect note.
+
+## Touch map (files SF-1 tạo/sở hữu)
+```
+platform/docker-compose.yml            [SỬA — SỞ HỮU story này; pre-add env đúng 1 lần]
+platform/.env.example                  [SỬA — SỞ HỮU]
+contracts/events/task-events.md        [TẠO — SỞ HỮU]
+contracts/events/fixtures/*.json       [TẠO — SỞ HỮU, golden cho SF-2/3]
+contracts/auth/users.json              [SỬA — thêm 2 fixture users]
+platform/conventions/09-async-messaging.md [TẠO — SỞ HỮU]
+docs/adr/0008-*.md                     [TẠO — SỞ HỮU]
+README.md                              [SỬA section compose]
+services/node-svc|go-svc/**, contracts/openapi/*, contracts/db/*   [KHÔNG ĐỤNG — SF-2/3 sở hữu]
+```
+
+## ACCEPTANCE (user-visible)
+- `docker compose config -q` validate với entry kafka + env mới (CI-verified — dev machine không Docker).
+- CI: convergence không đỏ vì kafka entry (không service depend kafka — chain 9 service nguyên vẹn).
+- Golden fixtures parse được JSON, envelope đủ field theo task-events.md, mỗi event type 1 file.
+- users.json có 2 user mới, roles hợp lệ, spring SeedMatch test (chạy ở SF-4 branch) vẫn pass khi merge.
+- ADR-0008 + conventions/09 tồn tại, narrative khớp ADR-0006 (supersede rõ ràng).
+
+## Boundary (KHÔNG làm)
+- KHÔNG đụng `contracts/db/tasks-schema.sql`, `contracts/openapi/tasks.yaml`, `activity.yaml`, `services/node-svc/**`, `services/go-svc/**`, FE — SF-2/3 sở hữu.
+- KHÔNG đưa kafka vào readyz/depends_on bất kỳ service nào.
+- KHÔNG expose 9092 ra host. KHÔNG SASL/SSL.
+- Compose chỉ sửa ĐÚNG 1 lần (pre-add env trọn vẹn) — SF-2+ đụng compose = flag.

package/stack-template/docs/superpowers/contexts/sf-2.md

@@ -0,0 +1,42 @@
+# SF-2 Context Pack — node-svc Outbox + Producer + compensation consumer
+> Đọc file này THAY VÌ tự tổng hợp. Epic spec: `docs/superpowers/specs/2026-10-13-kafka-outbox-saga.md` (rev 3). Mindmap: `docs/superpowers/mindmaps/kafka-outbox-saga.wakii`.
+> Depends: SF-1 (KAFKA_BROKERS env đã pre-add trong compose, golden fixtures, conventions/09).
+
+## Spec slice (chỉ phần SF-2 chịu trách nhiệm)
+1. **Cụm nguyên tử node-side cascade** (1 cụm — sửa cùng lúc để schema-diff.test không đỏ giữa chừng): canonical DDL `contracts/db/tasks-schema.sql` CHECK status thêm `'assignment_failed'` (varchar(20) đủ — 17 ký tự) + `src/db/schema.ts` mirror + migration CHECK + `contracts/openapi/tasks.yaml` **TaskStatus split**: `TaskStatus` 3 giá trị (query param + PATCH body — WRITABLE) / `TaskStatusExtended` 4 giá trị (chỉ `Task.status` response — READ-ONLY). PATCH KHÔNG nhận `assignment_failed` (system-owned); route hard-code 3 giá trị giữ cho query/body, response nới. Typegen drift job sẽ ép commit api.d.ts.
+2. **Pin schema-diff.test scope (P0)**: `src/db/schema-diff.test.ts` hiện assert `migrated.tables === canonical.tables` + `canonical.indexes.length === 3` — sửa test WHITELIST outbox table với expected-def riêng (không đếm vào canonical), canonical + index-3 GIỮ NGUYÊN (hướng ngược làm đỏ copy-dir standalone).
+3. Outbox table migration (schema `tasks`: id UUID **do node sinh**, type, payload jsonb, created_at, published_at nullable) + drizzle schema. Outbox KHÔNG vào canonical DDL (node-internal infra).
+4. **Transactional repo API** (drizzle có `.transaction()` gốc): đổi interface `TaskRepo` (`repo.ts:38-45`) + impl `repo.drizzle.ts` + fake — repo method nhận outbox op, **envelope id sinh trong repo**; event matrix PRESENCE-BASED: POST→`task.created`; PATCH có assigneeId→`task.assigned` (+`task.updated` nếu body còn field khác); PATCH không assigneeId→`task.updated`; DELETE→`task.deleted`; KHÔNG có unassign/null. Fake repo có seam tiêm lỗi giữa 2 step.
+5. Relay worker: poll 500ms, publish **đúng golden fixture format** (`contracts/events/fixtures/*.json` — test load chung), mark `published_at`, purge note (published cũ > N ngày).
+6. Xóa `clients/activity.ts` + 5 refs (`app.ts:24`, `app.test.ts`, `routes/tasks.ts:30`, `server.ts:5,22`) — thay bằng relay + consumer wiring.
+7. Compensation consumer (group `node-svc-compensation`, CHỈ type `task.assignment_failed`): `UPDATE task SET status='assignment_failed' WHERE id AND assignee_id=<payload.assigneeId> AND status NOT IN ('assignment_failed')` — **CONDITIONAL guard chống stale compensation** (bắt buộc — dạy saga đúng).
+8. **Task `services-node-svc.yml` kafka boot-smoke (P0)**: `up -d postgres kafka node-svc` + assert outbox row `published_at IS NOT NULL` sau publish (relay THẬT trên CI, không fake).
+9. Tests: tx rollback (seam fail giữa 2 step → task VÀ outbox cùng biến mất), relay unit (fake producer), consumer unit. `KAFKA_BROKERS` lazy-connect (env đã có từ SF-1 — KHÔNG sửa compose).
+10. README node-svc: standalone ghi dependency contracts/db (FLAG sẵn convergence.yml:62) + outbox/kafka section.
+
+## Touch map (files SF-2 tạo/sở hữu)
+```
+services/node-svc/**                  [SỞ HỮU — kể cả xóa clients/activity.ts]
+contracts/db/tasks-schema.sql         [SỬA — SF-2 sở hữu cụm node-side]
+contracts/openapi/tasks.yaml          [SỬA — TaskStatus split]
+platform/docker-compose.yml           [READ-ONLY — env đã pre-add SF-1; đụng = FLAG]
+contracts/events/fixtures/*.json      [READ-ONLY — test load, KHÔNG sửa]
+platform/conventions/09, contracts/events/task-events.md [READ-ONLY]
+.github/workflows/services-node-svc.yml [SỞ HỮU — kafka boot-smoke task]
+pnpm-lock.yaml                        [kafkajs + commit bình thường; conflict SF-3 = coordinator resolve]
+```
+
+## ACCEPTANCE (user-visible)
+- Tạo task → outbox row xuất hiện TRONG cùng tx (seam-fail test: task + outbox cùng biến mất khi fail giữa 2 step).
+- Relay publish format KHỚP golden fixture (test 2 đầu load chung file).
+- CI node workflow xanh gồm boot-smoke kafka: outbox row `published_at IS NOT NULL` trên broker thật.
+- PATCH `status: assignment_failed` bị từ chối (schema PATCH 3 giá trị); GET task `assignment_failed` hợp lệ (extended).
+- Compensation consumer: event task.assignment_failed → task status đổi; stale event (assignee khác) KHÔNG đổi (conditional guard test).
+- 23/23 tests cũ không vỡ (hoặc cập nhật chính đáng theo matrix).
+
+## Boundary (KHÔNG làm)
+- KHÔNG sửa compose/.env.example (SF-1 pre-add rồi — đụng = FLAG).
+- KHÔNG sửa contracts/events/**, conventions/09, users.json, activity.yaml, go-svc, FE.
+- KHÔNG đụng services-go-svc.yml (SF-3).
+- KHÔNG value-compare trigger (presence-based là chủ đích — ADR-0008).
+- KHÔNG thử docker/kafka local — CI verify (dev machine không Docker).

package/stack-template/docs/superpowers/contexts/sf-3.md

@@ -0,0 +1,42 @@
+# SF-3 Context Pack — go-svc Consumer + Saga + thanh lý ingest
+> Đọc file này THAY VÌ tự tổng hợp. Epic spec: `docs/superpowers/specs/2026-10-13-kafka-outbox-saga.md` (rev 3). Mindmap: `docs/superpowers/mindmaps/kafka-outbox-saga.wakii`.
+> Depends: SF-1 (env pre-add: KAFKA_BROKERS, AUTH_MOCK_URL, SVC_ACTIVITY_PASSWORD; golden fixtures; conventions/09).
+
+## Spec slice (chỉ phần SF-3 chịu trách nhiệm)
+1. **Cụm nguyên tử activity-side cascade**: migration `internal/store/migrations/0002_*.sql` — **`ALTER COLUMN action TYPE varchar(40)`** (`task.assignment_failed` = 22 ký tự > varchar(20) — chỉ sửa CHECK quên width = InsertEvent chết runtime, retry ×3 → DLQ sai nguyên nhân) + CHECK drop/recreate thêm `task.assigned`/`task.assignment_failed`.
+2. **activity.yaml ×2 FILE** (P0 — sửa 1 bỏ 1 = docs endpoint lệch im lặng): canonical `contracts/openapi/activity.yaml` + snapshot nhúng `services/go-svc/internal/api/openapi/activity.yaml` — TRỌN GÓI: xóa `/events` path + `ActivityEventInput` + `EventAccepted`; enum action thêm `task.assigned`/`task.assignment_failed`; description bỏ "fire-and-forget"; stats keys thêm assignment_failed. **Thêm diff-guard 2 file vào `services-go-svc.yml`** (precedent: services-spring-svc.yml diff users.yaml).
+3. `store/tasks.go` byStatus map thêm key `assignment_failed` (stats hiện hard-code 3 keys).
+4. Consumer package `internal/consumer/`: `segmentio/kafka-go` (ADR ghi franz-go = path production), group `go-svc-activity`, manual commit SAU DB tx, **ON CONFLICT DO NOTHING bằng envelope id** (id do node sinh — đổi `store/events.go` InsertEvent nhận id từ envelope, bỏ `uuid.New()`), filter-by-type (bỏ qua `task.assignment_failed`), auto.offset.reset earliest. Test load golden fixture.
+5. Retry ×3 (in-memory) → publish `task.assignment_failed` (envelope id MỚI do go sinh — go là producer lúc này) vào `task-events` → đẩy event gốc vào `task-events.dlq`.
+6. Resolver service-token: boot login `svc-activity` (AUTH_MOCK_URL + SVC_ACTIVITY_PASSWORD env từ SF-1) — **retry backoff, KHÔNG crash nếu auth-mock chưa lên** (go chỉ depends_on postgres); lazy re-login khi 401/expiry; cache JWT cho resolver enrich userName.
+7. Xóa `internal/api/events.go` ingest + route wiring + `events_test.go` cập nhật + integration test cập nhật (không còn POST /events — schemathesis step trong workflow cũng theo).
+8. **`services-go-svc.yml` 3 điểm chạm + diff-guard (P0)**: (a) step event→feed→stats POST /events → thay bằng **kafka console producer publish golden fixture** (script trong image apache/kafka) + kafka vào subset boot + **tạo topic tường minh** (`kafka-topics.sh --create` task-events + dlq, 1 partition — không dựa auto-create); (b) stats assert exact-equality 3 keys → nới thêm assignment_failed; (c) giữ ≥1 proof event→feed (chống thoái hóa).
+9. Simulate fail hook: assigneeId = svc-fail → consumer cố tình fail (deterministic cho e2e saga SF-5).
+10. `internal/config/config.go` +KAFKA_BROKERS/group/DLQ/AUTH_MOCK_URL/SVC_ACTIVITY_PASSWORD; `model` +action constants; go.mod +segmentio.
+
+## Touch map (files SF-3 tạo/sở hữu)
+```
+services/go-svc/**                    [SỞ HỮU — kể cả xóa ingest, thêm consumer]
+contracts/openapi/activity.yaml       [SỬA — SF-3 sở hữu trọn gói]
+services/go-svc/internal/api/openapi/activity.yaml [SỬA — snapshot ×2]
+frontend/remotes/tasks/** (type + statusLabel + tests)  [SỞ HỮU — badge assignment_failed, P0 plan-critic gán đích danh]
+frontend/remotes/activity/** (action labels + tests)    [SỞ HỮU]
+.github/workflows/services-go-svc.yml [SỞ HỮU — 3 điểm chạm + diff-guard]
+contracts/events/fixtures/*.json      [READ-ONLY — test load, KHÔNG sửa]
+platform/docker-compose.yml           [READ-ONLY — env đã pre-add; kafka đã có; đụng = FLAG]
+```
+
+## ACCEPTANCE (user-visible)
+- CI go-svc xanh: boot-smoke subset có kafka, publish golden fixture qua console producer → feed có row (proof event→feed), stats nới pass, diff-guard pass.
+- Consumer unit: golden fixture → activity row đúng; duplicate envelope id → vẫn 1 row (idempotency).
+- Retry/DLQ: simulate svc-fail → 3 retry → `task.assignment_failed` publish + event gốc vào DLQ (test assert).
+- Resolver: enrich userName bằng service-token; auth-mock down lúc boot → không crash, retry; 401 → lazy re-login.
+- GET /api/activity/events → 404 (ingest đã xóa); docs endpoint khớp contract (diff-guard).
+- FE remote-tasks: task `assignment_failed` render badge đúng; remote-activity action label mới có.
+
+## Boundary (KHÔNG làm)
+- KHÔNG sửa compose/.env.example, contracts/events/**, conventions/09, contracts/db, tasks.yaml, node-svc, spring-svc (đụng = FLAG).
+- KHÔNG đụng services-node-svc.yml (SF-2).
+- KHÔNG dùng franz-go (segmentio theo spec; franz-go ghi ADR).
+- KHÔNG SASL/SSL — PLAINTEXT compose-internal.
+- KHÔNG thử docker/kafka local — CI verify.

package/stack-template/docs/superpowers/contexts/sf-4.md

@@ -0,0 +1,26 @@
+# SF-4 Context Pack — spring-svc @Transactional demo
+> Đọc file này THAY VÌ tự tổng hợp. Epic spec: `docs/superpowers/specs/2026-10-13-kafka-outbox-saga.md` (rev 3). Mindmap: `docs/superpowers/mindmaps/kafka-outbox-saga.wakii`.
+> KHÔNG depends-on SF-1 — chạy song song từ tier 0 (false dep đã cắt: rollback trigger dùng alice@demo.local có sẵn; không đụng kafka/compose/file SF-1 sửa).
+
+## Spec slice (chỉ phần SF-4 chịu trách nhiệm)
+1. `service/TeamService.java` (MỚI — service layer, hiện TeamController gọi thẳng TeamRepository): method tạo team + members qua **N step** (≥2 lệnh ghi: teams.save + members từng dòng qua repository), có step GIỮA chừng có thể fail — annotate `@Transactional`.
+2. Endpoint (delegate từ TeamController sang TeamService): tạo team kèm members; **trigger rollback deterministic: member email trùng `alice@demo.local`** (fixture CÓ SẮN trong users.json — không cần SF-1) → bước insert member đó throw → **rollback toàn bộ** (team + members trước đó cùng biến mất) → error envelope 409/422 theo conventions.
+3. `TeamController.java` sửa: delegate sang TeamService (giữ contract yaml — không đổi API path/shape).
+4. Tests: (a) happy path — team + members tạo đủ; (b) **rollback assert** — fail giữa chừng → team KHÔNG tồn tại trong DB sau request (verify qua repository, không chỉ response); (c) chạy trên postgres service container trong CI (`mvnw verify` — CI-verifiable, dev machine không JDK/Docker không sao).
+5. README spring-svc: section @Transactional demo + giải thích Situation A (nhiều step 1 DB = 1 tx là đủ, so sánh Situation B cross-service → trỏ sang saga node/go).
+
+## Touch map (files SF-4 tạo/sở hữu)
+```
+services/spring-svc/**                [SỞ HỮU — service/ mới, web/TeamController sửa, tests]
+```
+
+## ACCEPTANCE (user-visible)
+- POST team với members hợp lệ → 201, team + members trong DB.
+- POST team với member trùng alice@demo.local ở vị trí giữa → error envelope, **DB không có team lẫn members** (rollback assert qua repository).
+- CI spring workflow xanh (mvnw verify + tests + boot-smoke hiện có không vỡ).
+
+## Boundary (KHÔNG làm)
+- KHÔNG dính Kafka/outbox/topic — SF-4 độc lập hoàn toàn.
+- KHÔNG sửa users.json, compose, contracts, CI của service khác.
+- KHÔNG đổi API contract teams (path/shape giữ nguyên).
+- KHÔNG thử docker local — CI verify (mvnw wrapper có sẵn; JDK qua CI toolchain).

package/stack-template/docs/superpowers/contexts/sf-5.md

@@ -0,0 +1,36 @@
+# SF-5 Context Pack — Convergence + ADR sync + docs
+> Đọc file này THAY VÌ tự tổng hợp. Epic spec: `docs/superpowers/specs/2026-10-13-kafka-outbox-saga.md` (rev 3). Mindmap: `docs/superpowers/mindmaps/kafka-outbox-saga.wakii`.
+> Depends: SF-2, SF-3, SF-4 (SF-1 transitively). Dest khi bạn fork đã đủ SF-1..4.
+
+## Spec slice (chỉ phần SF-5 chịu trách nhiệm)
+1. `.github/workflows/convergence.yml`: boot **10 services** (kafka thêm vào), KAFKA_HEAP_OPTS nếu cần, **poll budget nới** (outbox 500ms + Kafka latency — e2e poll hiện RETRIES×1s còn dư nhưng kiểm chứng), copy-dir giữ contracts/db (outbox KHÔNG vào canonical — chỉ schema tasks là cross-service contract).
+2. `scripts/smoke/e2e.sh` **2 chiều**:
+   - Happy path (có sẵn): login → tạo task → poll feed (qua outbox+Kafka — nới window).
+   - **Saga path (mới)**: PATCH task assigneeId = svc-fail → poll GET task status = `assignment_failed` → **assert DLQ: `kafka-console-consumer` (trong container kafka) đọc `task-events.dlq` thấy event gốc** — acceptance #3 đủ 2 nửa.
+3. FE remotes verify tổng thể trên stack thật (SF-3 đã sửa tests/tile/badge — bạn verify happy + saga path render đúng, screenshot/browser theo Rule 0 nếu có thể; else curl + CI evidence).
+4. Docs sync: walkthrough (thêm saga demo + **note Flyway V2 seed chạy 1 lần — pgdata volume CŨ thiếu svc users → `docker compose down -v` sau pull**), README 3 service + compose, rà ADR-0008 consistency với code thật.
+5. Security pass cuối: 9092 không expose host, secrets (JWT_SECRET, passwords) không vào envelope/event payload, `.env` không commit.
+6. Scaffold probe: `scaffold.sh` copy `platform/` nguyên khối → kafka entry + .env.example tự flow; chạy compose config -q trên output (convergence scaffold-verify job hiện có).
+7. Report (KHÔNG fix) bug product thấy được trong services/FE — SF sở hữu fix.
+
+## Touch map (files SF-5 tạo/sở hữu)
+```
+scripts/smoke/e2e.sh                  [SỞ HỮU]
+.github/workflows/convergence.yml     [SỞ HỮU — convergence touch points]
+docs/** (walkthrough, ADR consistency) [SỞ HỮU]
+README.md                             [SỬA lần cuối]
+platform/docker-compose.yml           [SỬA CHỈ health-gated depends_on nếu cần — còn lại flag]
+services/*, frontend/*, contracts/*   [READ-ONLY toàn bộ — bug = report coordinator]
+```
+
+## ACCEPTANCE (user-visible)
+- CI convergence xanh: compose 10 services + e2e 2 chiều (happy + saga kèm DLQ assert) + copy-dir standalone.
+- Saga e2e: assign svc-fail → task `assignment_failed` VÀ event gốc trong `task-events.dlq` (kafka-console-consumer assert).
+- Walkthrough fresh-clone đọc được một người mới chạy từ đầu (kèm note down -v cho volume cũ).
+- Security pass: 0 P0/P1.
+
+## Boundary (KHÔNG làm)
+- KHÔNG fix business logic services/FE (report coordinator).
+- KHÔNG merge vào main / KHÔNG tạo PR (coordinator làm).
+- KHÔNG thêm tính năng mới — hội tụ + chứng minh.
+- KHÔNG thử compose local — CI verify; browser walkthrough = human gate tại checkpoint (ghi hướng dẫn cho user).

package/stack-template/docs/superpowers/contexts/sf-6.md

@@ -0,0 +1,36 @@
+# SF-6 Context Pack — FE remotes (tasks + activity)
+> Đọc file này THAY VÌ tự tổng hợp từ bracket + epic + comments.
+> Epic spec: `docs/superpowers/specs/2026-10-12-boilerplate-microservice-mfe.md` (rev 3). Bracket: `docs/superpowers/mindmaps/micro-boilerplate.wakii`.
+
+## Spec slice (chỉ phần SF-6 chịu trách nhiệm)
+1. Scaffold 2 remote apps: `frontend/remotes/tasks/`, `frontend/remotes/activity/` — Rspack + @module-federation/enhanced REMOTE, cùng pattern.
+2. Remote URLs đọc từ remote registry (env-configurable); dev server proxy theo conventions (native mode không cần CORS mở).
+3. Remote `tasks`: danh sách + tạo/sửa task — gọi node-svc qua gateway `/api/tasks`, đính JWT (api client từ fe-shared); error envelope decode → toast/inline error.
+4. Remote `activity`: feed + stats — gọi go-svc qua gateway `/api/activity`; render user-display fields (userName, taskTitle) từ response.
+5. Shared singletons theo catalog (react/react-dom/router KHÔNG duplicate — expose + shared config đúng MF 2.0).
+6. Mỗi remote: vitest tests (component + api call mocked), Dockerfile nginx static, **boot-smoke CI job** (up + trả 200 + remoteEntry.js fetch được), compose impl điền vào entry pre-seed, README.md standalone (copy KÈM `frontend/shared`).
+7. Lưu ý vận hành: SF-5 đang song song regenerate `pnpm-lock.yaml` — khi merge coordinator xử lý theo checklist (lấy 1 phía + `pnpm install` lại); SF-6 commit lockfile của mình bình thường.
+
+## Touch map (files SF-6 tạo/sở hữu)
+```
+frontend/remotes/tasks/**        [SỞ HỮU]
+frontend/remotes/activity/**     [SỞ HỮU]
+frontend/shared/**               [READ-ONLY — SF-1; thiếu = FLAG]
+frontend/shell/**                [READ-ONLY — SF-5; host phải expose remote slots, nếu thiếu slot = FLAG]
+pnpm-workspace.yaml / catalog    [READ-ONLY]
+platform/docker-compose.yml      [READ-ONLY — impl điền vào entry pre-seed]
+platform/conventions/*           [READ-ONLY]
+pnpm-lock.yaml                   [chung với SF-5 — coordinator resolve khi merge]
+```
+
+## ACCEPTANCE (user-visible)
+- Chạy shell (SF-5) + 2 remote dev servers → login → route `/tasks`: tạo task mới → hiện trong danh sách (đi qua node-svc THẬT qua gateway); route `/activity`: feed/stats phản ánh task vừa tạo (go-svc thật).
+- 1 remote down → shell vẫn chạy, remote còn lại hoạt động.
+- Vitest pass cho cả 2 remote.
+- CI xanh: build + tests + boot-smoke per remote (remoteEntry fetch được).
+
+## Boundary (KHÔNG làm)
+- KHÔNG sửa shell/fe-shared/catalog/compose/contracts (đụng = flag).
+- KHÔNG implement service-side (SF-2/3/4 sở hữu).
+- KHÔNG thêm remote thứ 3 — chỉ tasks + activity.
+- KHÔNG thử docker local — CI verify.

package/stack-template/docs/superpowers/contexts/sf-7.md

@@ -0,0 +1,35 @@
+# SF-7 Context Pack — Convergence & Scaffold
+> Đọc file này THAY VÌ tự tổng hợp từ bracket + epic + comments.
+> Epic spec: `docs/superpowers/specs/2026-10-12-boilerplate-microservice-mfe.md` (rev 3). Bracket: `docs/superpowers/mindmaps/micro-boilerplate.wakii`.
+
+## Spec slice (chỉ phần SF-7 chịu trách nhiệm)
+1. **Smoke e2e API-level COMMITTED**: `scripts/smoke/e2e.sh` (curl: login auth-mock → tạo task node-svc → đọc feed go-svc; assert kết quả) + CI job chạy nó trên compose stack — KHÔNG ad-hoc tại checkpoint, KHÔNG browser trong CI (browser walkthrough = human gate tại checkpoint).
+2. CI hoàn chỉnh: path-filter + docker build per stack + contract test + gitleaks + **copy-dir standalone smoke** (copy 1 service + `frontend/shared` ra tmp → build/test pass).
+3. Docs đồng bộ: README Mermaid = kiến trúc thật; ADR ghi các quyết định (mixed stack, MF/Rspack, contract-first, readonly schema trade-off, fail-closed vs degrade, fire-and-forget events, fork-not-upgrade model); toolchain doc (JDK/Go/Node/pnpm/docker needed where); fresh-clone walkthrough checklist.
+4. Scaffold script `scripts/scaffold/`: copy + rename + prune (không generator framework) — sinh project mới đặt tên riêng, chạy được cùng flow. **Nếu trễ: scope-flag lên user — KHÔNG auto-complete bằng manual fallback.**
+5. Security-audit checkpoint: secrets/exec-bit/lockfile/deps scan (OWASP surface + repo hygiene).
+6. Rà multi-stage + pinned base images toàn bộ Dockerfile.
+7. Compose health-gated depends_on hoàn chỉnh (service_healthy chain) — e2e không flaky vì race.
+
+## Touch map (files SF-7 tạo/sở hữu)
+```
+scripts/smoke/e2e.sh             [SỞ HỮU]
+scripts/scaffold/**              [SỞ HỮU]
+.github/workflows/*              [SỞ HỮU riêng file convergence — SF-1 templates READ-ONLY, có gì thiếu flag]
+docs/** (ADR, walkthrough)       [SỞ HỮU]
+README.md                        [SỬA lần cuối — đồng bộ]
+platform/docker-compose.yml      [SỬA: health-gated depends_on — SF-7 được phép vì là convergence; mọi sửa khác flag]
+services/* frontend/*            [READ-ONLY toàn bộ — bug thấy được = report, KHÔNG fix]
+```
+
+## ACCEPTANCE (user-visible)
+- CI job e2e smoke xanh: script curl login → tạo task → đọc feed qua gateway — chứng minh chuỗi 3 service liền mạch.
+- Copy-dir smoke xanh: ≥1 service + fe-shared copy ra tmp build/test được — chứng minh standalone.
+- Scaffold: chạy script → thư mục project mới → cùng flow chạy được (CI verify scaffold output build được).
+- README + ADR + fresh-clone walkthrough đọc theo được một người mới chạy từ đầu.
+- Security-audit: 0 P0/P1 còn mở.
+
+## Boundary (KHÔNG làm)
+- KHÔNG fix bug business logic trong services/FE (report lại coordinator — SF sở hữu fix).
+- KHÔNG merge vào `main` / KHÔNG tạo PR thay người (PR agent tạo nhưng merge là human gate — outside SF-7 scope, coordinator làm).
+- KHÔNG thêm tính năng mới — chỉ hội tụ + chứng minh cái đã có.

package/stack-template/docs/superpowers/contexts/sf-cin-overview.md

@@ -0,0 +1,21 @@
+# Context pack — VU-53-CIN Cinematic Experience (epic-level, SF packs slice từ đây)
+
+## Spec slice (font: REF-SPEC docs/team/ref/ đo trực tiếp site ref)
+- Typography: display 12px/700 UPPERCASE tracking 2.4px · label mono 11px/700 tracking 2.64 · H1 hero 18px/300 LIGHT nền SÁNG chữ navy · H2 chapter ~29px/300 · body 12px/400 tracking 0.3 · copy punchy 2 dòng ALL-CAPS cho heading
+- Cấu trúc: hero sáng → 5 chương nền TỐI tự chủ gradient (section owns bg, theme-independent) → End CTA + footer numbered. Side-nav Anchor sticky progress single-source.
+- Motion vocabulary: parallax nền-gần-fixed (speed 0.08/strength 280) + split-text reveal + mask-reveal clip-path + sticky-pinned 200vh + mood crossfade theo scroll + sun-journey dawn→night. 150-250ms UI, infinite chỉ cho trạng thái. Reduced-motion tắt sạch.
+- 3D: ScrollFlythrough (three peer-dep, procedural ship, fallback node) trong Ch4. fps ≥50.
+- IP: kỹ thuật+cấu trúc+bố cọc sao chép được; copy/ảnh/art là của Orca (VN-flavored), KHÔNG copy nguyên văn ref.
+
+## Touch map
+src/templates/experience/** (chapters, lib/scroll-mood, index.stories) · src/ui/parallax (strength prop) · src/ui/experience3d (ScrollFlythrough) · src/styles/tokens.css (mood vars). Consumer apps KHÔNG đụng.
+
+## ACCEPTANCE (user-visible)
+1. Story Templates/Cinematic Experience — Experience chạy end-to-end: hero sáng → 5 chương → CTA, cuộn mượt không giật.
+2. Đặt cạnh ref-hero.png/ref-mid-chapter.png: typography + nhịp + mood tương đồng (số đo đúng REF-SPEC).
+3. Dark + light + prefers-reduced-motion + 375px đều đẹp; contrast ≥4.5:1 số đo được.
+4. Ch4 camera bay quanh tàu 3D thật, không cứng khung.
+5. Deploy alias xem được.
+
+## Boundary
+KHÔNG đụng: component core ngoài scope (chỉ dùng, không sửa API trừ prop mới đã ghi touch map) · apps consumer · pre-push hook. Việc cũ 6-chapter hiện có = prior art tái sử dụng, không phải ràng buộc.

package/stack-template/docs/superpowers/contexts/ui-redesign/sf-1.md

@@ -0,0 +1,46 @@
+# SF-1 Context Pack — Design direction + design-system nền móng
+> Đọc file này THAY VÌ tự tổng hợp. Epic spec: `docs/superpowers/specs/2026-10-13-ui-redesign.md` (rev 3). Mindmap: `docs/superpowers/mindmaps/ui-redesign.wakii`.
+> Depends: — (tier 0, SF đầu tiên). WHY: UI là "mặt tiền" boilerplate khi dev nội bộ fresh-clone demo — hiện gần như unstyled (CSS 68 dòng, 0 tokens, coupling CSS shell→remotes). SF này quyết định hướng thiết kế (USER CHỌN) và dựng nền móng mọi SF sau consume.
+
+## Spec slice (chỉ phần SF-1 chịu trách nhiệm)
+0. **DESIGN GATE ĐÃ XONG lúc CREATE** (2026-10-13): user đã chọn hướng **B "Linear-referenced dark"** — đọc `docs/superpowers/designs/ui-redesign-direction.md` (tokens + component props API ĐẦY ĐỦ, visual chuẩn `designs/drafts/b-reference.html`) + `designs/direction-approved.md`. KHÔNG chạy designer 3 hướng nữa — implement thẳng theo hand-off.
+1. `fe-shared/src/styles/tokens.css` + `base.css` — ĐÚNG giá trị mục 1-2 hand-off (không tự chế thêm token; thiếu = flag coordinator).
+2. `fe-shared/src/styles/tokens.css` — custom properties `:root`, idempotent (nhiều bản cùng giá trị vô hại — remote CSS inject runtime sau CSS shell). `fe-shared/src/styles/base.css` — `@layer reset,base` tối thiểu, GIỐNG HỆT mọi bản copy; shell là nơi import LÀM CHỦ global base (remote chỉ tokens + scoped classes).
+3. Primitives `fe-shared/src/ui/`: `Badge` (role="status", variant enum phủ 4 status extended tasks: todo/in_progress/done/assignment_failed + 5 action labels activity: task.created/updated/assigned/deleted/assignment_failed), `EmptyState`, `Skeleton` (aria-busy), `Spinner`. **TS props API từng primitive document trong hand-off doc** — SF-2/3/4 consume theo đúng shape.
+4. Barrel export + package.json exports map — CHỈ phần mới; 4 file logic fe-shared (api-client/token-storage/error-envelope/mf-bootstrap) READ-ONLY tuyệt đối, trường `mfToolkit` READ-LOCKED.
+5. **Rspack ×3**: remotes thiếu css rule + `experiments.css` — copy y hệt shell (`frontend/shell/rspack.config.mjs:42-45,85-87`); `declare module '*.css'` env.d.ts ×3 (defensive); **`'react/jsx-runtime': {singleton:true, requiredVersion:false}` vào shared CẢ 3 config** (hiện chỉ react/react-dom — JSX fe-shared compile ra import jsx-runtime sẽ duplicate react).
+6. **Spike R2 chạy SỚM** — ngay sau task 5 với 1 JSX stub tối thiểu trong fe-shared, TRƯỚC khi viết 4 primitives: build 3 package → load shell + remote mount + 1 tương tác đổi status → console KHÔNG có "Invalid hook call"/"2 copies of React" → screenshot vào `docs/superpowers/evidence/`. FAIL → fallback primitives **class-only** (không JSX — chỉ className helpers), hand-off ghi API shape thay thế.
+7. `output.cssFilename: '[name].[contenthash].css'` prod ×3 (cache-busting; CSS emit ở ROOT — không nằm trong `/assets/` immutable, đừng tìm rule đó).
+8. Remotes `src/index.tsx` (standalone debug :4001/:4002) import base+tokens — fix "standalone trơ trụi". SF-3/4 sẽ TIẾP TỤC sửa file này (banner debug) — giữ import, ghi comment rõ.
+9. Tests primitives ở **`frontend/shell/tests/primitives.test.tsx`** (fe-shared KHÔNG có vitest — thêm vào sẽ đụng `pnpm-lock.yaml`, success criteria cấm đổi lockfile).
+10. Ownership notes: comment `pnpm-workspace.yaml` (dòng SF-1 cũ sở hữu) + `frontend/shared/package.json` description + fe-shared README — ghi rõ từ story này: `src/styles/` + `src/ui/` do design-system SF sở hữu, logic files READ-LOCKED.
+11. Demo: 1 trang HTML đơn giản render primitives (đính kèm hand-off hoặc standalone dev) — user thấy được design system sống.
+
+## Touch map (files SF-1 tạo/sở hữu)
+```
+frontend/shared/src/styles/{tokens,base}.css        [MỚI — SỞ HỮU]
+frontend/shared/src/ui/{Badge,EmptyState,Skeleton,Spinner}.tsx [MỚI — SỞ HỮU]
+frontend/shared/src/index.ts                         [SỬA — barrel thêm export phần mới]
+frontend/shared/package.json                         [SỬA — exports map + description; mfToolkit LOCKED]
+frontend/shared/README.md                            [SỬA — cách import tokens/primitives]
+frontend/{shell,remotes/tasks,remotes/activity}/rspack.config.mjs [SỬA — css rule + jsx-runtime shared + cssFilename]
+frontend/{shell,remotes/tasks,remotes/activity}/env.d.ts [SỬA — declare *.css]
+frontend/remotes/{tasks,activity}/src/index.tsx      [SỬA — import base+tokens]
+frontend/shell/tests/primitives.test.tsx             [MỚI]
+docs/superpowers/designs/ui-redesign-direction.md    [MỚI — sau USER GATE]
+docs/superpowers/evidence/                           [spike R2 screenshot]
+pnpm-workspace.yaml                                  [SỬA — comment ownership]
+frontend/shared/src/{api-client,token-storage,error-envelope,mf-bootstrap}.ts [READ-ONLY]
+contracts/**, platform/**, services/**, scripts/**, .github/** [READ-ONLY]
+```
+
+## ACCEPTANCE (user-visible)
+- User được xem 3 hướng prototype đầy đủ (login + tasks + activity) và CHỌN 1 — hướng chưa chọn = SF chưa xong.
+- Sau SF-1: mở standalone `http://localhost:4001` / `:4002` trực tiếp → có baseline style (không còn trơ trụi); primitives render đúng hand-off; 3 package `pnpm build` xanh; spike R2 PASS có screenshot (console sạch duplicate-react); `pnpm test` shell xanh kèm tests primitives.
+- `pnpm-lock.yaml` KHÔNG đổi (0 deps mới).
+
+## Boundary (KHÔNG làm)
+- KHÔNG restyle shell/remotes pages (SF-2/3/4 — SF-1 chỉ nền móng + config).
+- KHÔNG đụng 4 file logic fe-shared + trường mfToolkit; KHÔNG thêm npm dependency nào.
+- KHÔNG tự chốt hướng thiết kế thay user (gate bắt buộc); KHÔNG thêm asset ngoài/CDN font (CSP chưa set).
+- KHÔNG merge vào main / KHÔNG tạo PR (coordinator làm).

package/stack-template/docs/superpowers/contexts/ui-redesign/sf-2.md

@@ -0,0 +1,44 @@
+# SF-2 Context Pack — Shell: layout + login + nav + remote fallback
+> Đọc file này THAY VÌ tự tổng hợp. Epic spec: `docs/superpowers/specs/2026-10-13-ui-redesign.md` (rev 3). Mindmap: `docs/superpowers/mindmaps/ui-redesign.wakii`.
+> Depends: SF-1 (tokens + primitives + hand-off doc đã merge). WHY: shell là khung mọi trang — layout/nav/login là thứ user nhìn đầu tiên sau login gate; hiện nav không active state, HomePage trống, login form trơ.
+
+## Spec slice (chỉ phần SF-2 chịu trách nhiệm)
+1. Layout: container max-width + header/page structure theo direction đã chọn (`docs/superpowers/designs/ui-redesign-direction.md`). **Giữ NGUYÊN VẸN**: skip link text "Tới nội dung chính" + `href="#main-content"`, `main id="main-content" tabIndex={-1}`, focus main khi đổi route (`frontend/shell/src/components/Layout.tsx:14-27`).
+2. NavBar active state: `aria-current="page"` + visual theo tokens; responsive wrap ≤768px (hiện flex không wrap → overflow mobile).
+3. NavBar user chip + logout/login styling — giữ `data-testid="nav-user"` + aria-label "Điều hướng chính".
+4. HomePage: dashboard chào + quick links 2 remote + demo hints (alice@demo.local / demo-password, fail@demo.local cho saga) — thay `<h1>Trang chủ</h1>` 8 dòng hiện tại.
+5. LoginPage: card giữa màn hình + error banner styling + demo hint format đẹp — behavior GIỮ (redirect khi có token, deep-link `location.state.from`, error messages nguyên văn "Email hoặc mật khẩu không đúng." / "Không kết nối được máy chủ đăng nhập.").
+6. RemoteSlot: Suspense fallback = `Skeleton` primitive (thay `<p>Đang tải {name}…</p>` — không test nào assert chuỗi này); error fallback visual — GIỮ text "Không tải được phần tasks…" + nút "Thử lại" (test contract).
+7. `frontend/shell/src/styles.css` rewrite → scoped classes + consume tokens từ fe-shared; xóa element selectors toàn cục (body/nav/form/label/button — đã chuyển vào base.css của SF-1). Shell import base+tokens LÀM CHỦ global (bootstrap.tsx).
+8. Tests tách theo surface: a11y 3 case giữ nguyên vẹn (hard gate) / login / remote-slot / integration — update chuỗi nếu UI đổi text (quy tắc cùng-commit cùng-SF).
+9. Diff-hygiene cuối SF: diff không chứa secrets, không exec-bit mới (phase-gate security Phase 1).
+
+## Interface contract (với SF-1 output)
+- Import: `@boilerplate/fe-shared` → `Skeleton`, tokens qua CSS (`tokens.css` vars theo hand-off doc). Props API từng primitive = mục hand-off "component spec" — DÙNG ĐÚNG SHAPE, không tự chế props.
+- Cần variant primitive chưa có trong hand-off? **FLAG coordinator** — fe-shared đã đóng băng sau SF-1, không tự sửa.
+
+## Touch map (files SF-2 tạo/sở hữu)
+```
+frontend/shell/src/styles.css              [SỞ HỮU — rewrite]
+frontend/shell/src/bootstrap.tsx           [SỬA — import chain]
+frontend/shell/src/components/Layout.tsx   [SỬA — className only, KHÔNG đụng focus logic]
+frontend/shell/src/components/NavBar.tsx   [SỬA — aria-current + styling]
+frontend/shell/src/components/RemoteSlot.tsx [SỬA — fallback visuals]
+frontend/shell/src/pages/{HomePage,LoginPage}.tsx [SỬA]
+frontend/shell/tests/*                     [SỬA — update + giữ a11y 3 case]
+frontend/remotes/**, frontend/shared/**    [READ-ONLY toàn bộ]
+rspack.config.mjs / env.d.ts               [READ-ONLY — SF-1 đã xong config]
+contracts/**, platform/**, services/**, scripts/** [READ-ONLY]
+```
+
+## ACCEPTANCE (user-visible)
+- Qua gateway :8080 (hoặc dev :3000): login form card đẹp giữa màn hình, hint demo đọc được; sau login nav hiện email chip + trang đang đứng được đánh dấu active; HomePage dashboard có quick links Tasks/Activity + hint saga.
+- Thu hẹp cửa sổ ≤768px: nav wrap, không overflow ngang.
+- Kill remote dev server → reload: slot hiện skeleton lúc tải + fallback đẹp có nút "Thử lại" hoạt động (walkthrough mục 4.4).
+- `pnpm test` + `pnpm typecheck` shell xanh; 3 test a11y pass nguyên vẹn.
+
+## Boundary (KHÔNG làm)
+- KHÔNG đụng frontend/remotes/** (SF-3/4) và frontend/shared/** (đóng băng sau SF-1).
+- KHÔNG đổi RemoteSlot text contract ("Không tải được phần tasks…" / "Thử lại"), KHÔNG đổi error messages login, KHÔNG bỏ skip-link/focus logic.
+- KHÔNG thêm tokens/primitives mới (flag coordinator nếu cần).
+- KHÔNG merge vào main / KHÔNG tạo PR (coordinator làm).

package/stack-template/docs/superpowers/contexts/ui-redesign/sf-3.md

@@ -0,0 +1,47 @@
+# SF-3 Context Pack — Remote tasks: TasksPage redesign + UX gaps
+> Đọc file này THAY VÌ tự tổng hợp. Epic spec: `docs/superpowers/specs/2026-10-13-ui-redesign.md` (rev 3). Mindmap: `docs/superpowers/mindmaps/ui-redesign.wakii`.
+> Depends: SF-1 (tokens + primitives + rspack css rule đã merge). WHY: Tasks là màn hình demo chính (walkthrough mục 4.2) — hiện là 1 component 181 dòng, select status + list 1 cột, bỏ lỡ DELETE/edit/assignee/pagination/filter mà API LÙN có sẵn.
+
+## Spec slice (chỉ phần SF-3 chịu trách nhiệm)
+1. Tách component: `TaskForm` / `TaskList` / `TaskItem` / `StatusSelect` — giữ export `default` + named `TasksPage` (MF expose `./TasksPage` cần default; đổi = breaking registry).
+2. TaskItem: card layout responsive; `StatusBadge` dùng primitive Badge — status thường 3 giá trị + **"Gán thất bại" cho assignment_failed giữ `role="status"` + text nguyên văn** (walkthrough 4b + test contract; KHÔNG cho chọn assignment_failed trong select — PATCH cấm).
+3. Per-item busy: Spinner + disable select khi PATCH đang bay (hiện không có — user không biết thao tác đang xử lý).
+4. Edit inline title/description: nút sửa → input inline → save (PATCH)/cancel. API có sẵn (`updateTask` — mở rộng `src/api.ts` payload nếu cần).
+5. Delete: nút xoá + confirm dialog → DELETE `/api/tasks/{id}` (API có sẵn, UI chưa có). Feed activity tự nhận task.deleted qua Kafka.
+6. Assignee hiển thị **UUID rút gọn monospace + tooltip full** — KHÔNG resolve tên qua `/api/users` (ngoài endpoint pin + sai base URL dev). + createdAt hiển thị.
+7. Pagination "Tải thêm": limit ≤100 + offset (API có sẵn) — hiển thị "x/total" đúng.
+8. Filter theo status: `?status=` (API có sẵn) — chip/toggle bộ 3 writable status.
+9. `src/api.ts` ĐƯỢC MỞ RỘNG: thêm params limit/offset/status cho `fetchTasks`, thêm `deleteTask` — đúng contract `contracts/openapi/tasks.yaml` (limit max 100, offset ≥0). KHÔNG gọi endpoint ngoài `/api/tasks*`.
+10. Loading = Skeleton list (primitive), empty = EmptyState (giữ text "Chưa có task nào" semantics), error banner giữ `role="alert"` + message 503 spring nguyên văn.
+11. Scoped css riêng theo kiến trúc CSS đích (tokens + scoped classes, KHÔNG element selectors toàn cục). SF-3∥SF-4 chạy song song — KHÔNG copy code SF-4.
+12. Standalone `src/index.tsx`: banner debug đẹp — **rebase trên SF-1, KHÔNG revert import base+tokens** SF-1 đã thêm.
+13. Tests: update chuỗi đổi + THÊM case: edit inline gọi PATCH đúng payload / delete gọi DELETE + confirm / load-more gọi offset / filter gọi ?status= / per-item busy.
+
+## Interface contract
+- Primitives + tokens theo hand-off (`docs/superpowers/designs/ui-redesign-direction.md`) — dùng đúng props API; cần variant mới → FLAG coordinator (fe-shared đóng băng).
+- MF contract GIỮ: name `tasks`, expose `./TasksPage`, default export, publicPath prod `/remotes/tasks/`.
+
+## Touch map (files SF-3 tạo/sở hữu)
+```
+frontend/remotes/tasks/src/TasksPage.tsx      [SỞ HỮU — tách component]
+frontend/remotes/tasks/src/components/*.tsx   [MỚI — TaskForm/TaskList/TaskItem/StatusSelect]
+frontend/remotes/tasks/src/styles.css         [MỚI — scoped]
+frontend/remotes/tasks/src/api.ts             [SỬA — mở rộng params + deleteTask]
+frontend/remotes/tasks/src/index.tsx          [SỬA — banner debug, giữ imports SF-1]
+frontend/remotes/tasks/tests/*                [SỬA — update + thêm case]
+frontend/shell/**, frontend/remotes/activity/**, frontend/shared/** [READ-ONLY]
+rspack.config.mjs / env.d.ts                  [READ-ONLY — SF-1 đã xong]
+contracts/**, platform/**, services/**        [READ-ONLY]
+```
+
+## ACCEPTANCE (user-visible)
+- Trên UI mới qua :8080: tạo task → thấy trong danh sách card; sửa tiêu đề inline; đổi status (select busy trong lúc bay); xoá có confirm; filter theo status; "Tải thêm" nếu >limit; "x/total" đúng.
+- Task item hiện assignee (UUID rút gọn) + createdAt.
+- Saga 4b: assign `fail@demo.local` → badge "Gán thất bại" hiện rõ (role=status), KHÔNG có select status.
+- Standalone :4001 mở trực tiếp: có style + banner debug.
+- `pnpm test` + `pnpm typecheck` tasks xanh (12 case cũ update + case mới).
+
+## Boundary (KHÔNG làm)
+- KHÔNG đụng frontend/shell/** (SF-2), frontend/remotes/activity/** (SF-4), frontend/shared/** (đóng băng).
+- KHÔNG đổi: STATUS_LABELS text nếu không bắt buộc (test contract), aria-label bộ tasks ("Quản lý tasks", "Form tạo task", "Danh sách tasks", "Trạng thái task <title>"), role=alert/status.
+- KHÔNG gọi API ngoài /api/tasks*; KHÔNG thêm deps; KHÔNG merge vào main / tạo PR.

package/stack-template/docs/superpowers/contexts/ui-redesign/sf-4.md

@@ -0,0 +1,44 @@
+# SF-4 Context Pack — Remote activity: ActivityPage redesign
+> Đọc file này THAY VÌ tự tổng hợp. Epic spec: `docs/superpowers/specs/2026-10-13-ui-redesign.md` (rev 3). Mindmap: `docs/superpowers/mindmaps/ui-redesign.wakii`.
+> Depends: SF-1 (tokens + primitives + rspack css rule đã merge). WHY: Activity chứng minh chuỗi Kafka (outbox → topic → go consumer) phản ánh thao tác Tasks — hiện stats tile inline-style + feed dòng text phẳng, khó "đọc" activity theo thời gian.
+
+## Spec slice (chỉ phần SF-4 chịu trách nhiệm)
+1. Stats: grid layout responsive + StatTile cards dùng tokens — **giữ nguyên bộ aria-label** ("Thống kê tasks", "Tổng số task", "Task Cần làm/Làm/Xong", "Sự kiện 24h qua").
+2. Feed: timeline theo nhóm ngày (mỗi nhóm heading ngày) + item card: action badge (primitive Badge, variant theo 5 action labels) + userName/taskTitle đậm + time vi-VN (`toLocaleString('vi-VN')` giữ).
+3. Unknown action: fallback render nguyên văn (giữ hành vi hiện tại).
+4. Nút "Làm mới": styling + busy state (Spinner, disable khi đang tải).
+5. Loading = Skeleton FEED + STATS RIÊNG BIỆT — giữ `Promise.allSettled` independence (stats fail KHÔNG che feed, ngược lại — có test).
+6. Empty = EmptyState primitive hướng dẫn sang Tasks ("Chưa có hoạt động nào — tạo một task ở trang Tasks…" semantics giữ).
+7. Scoped css riêng theo kiến trúc CSS đích (mục "Kiến trúc đích" spec — tokens + scoped classes). SF-3∥SF-4 chạy song song — KHÔNG copy code SF-3.
+8. Standalone `src/index.tsx`: banner debug đẹp — **rebase trên SF-1, KHÔNG revert import base+tokens**.
+9. Tests: update + THÊM (stats grid aria-label giữ, skeleton xuất hiện lúc loading từng khu).
+10. Diff-hygiene cuối SF (phase-gate security Phase 2).
+
+## Interface contract
+- Primitives + tokens theo hand-off (`docs/superpowers/designs/ui-redesign-direction.md`); Badge variant enum phủ 5 action labels — SF-1 đã cam kết; thiếu variant → FLAG coordinator.
+- MF contract GIỮ: name `activity`, expose `./ActivityPage`, default export, publicPath prod `/remotes/activity/`.
+
+## Touch map (files SF-4 tạo/sở hữu)
+```
+frontend/remotes/activity/src/ActivityPage.tsx  [SỞ HỮU — redesign]
+frontend/remotes/activity/src/components/*.tsx  [MỚI — StatTile/Timeline/FeedItem nếu tách]
+frontend/remotes/activity/src/styles.css        [MỚI — scoped]
+frontend/remotes/activity/src/index.tsx         [SỬA — banner debug, giữ imports SF-1]
+frontend/remotes/activity/tests/*               [SỬA — update + thêm]
+frontend/remotes/activity/src/api.ts            [SỬA tối thiểu — KHÔNG đổi call shape hiện có]
+frontend/shell/**, frontend/remotes/tasks/**, frontend/shared/** [READ-ONLY]
+rspack.config.mjs / env.d.ts                    [READ-ONLY — SF-1 đã xong]
+contracts/**, platform/**, services/**          [READ-ONLY]
+```
+
+## ACCEPTANCE (user-visible)
+- Qua :8080: stats là các card trong grid responsive; feed dạng timeline theo ngày, mỗi item có badge action + tên người + task + giờ vi-VN đọc được.
+- Tạo/sửa/xoá/assign task ở Tasks (SF-3) → reload Activity: sự kiện mới xuất hiện đúng badge (kể cả task.deleted).
+- Nút "Làm mới" có busy state; stats fail vẫn xem được feed (và ngược lại).
+- Standalone :4002 mở trực tiếp: có style + banner debug.
+- `pnpm test` + `pnpm typecheck` activity xanh.
+
+## Boundary (KHÔNG làm)
+- KHÔNG đụng frontend/shell/** (SF-2), frontend/remotes/tasks/** (SF-3), frontend/shared/** (đóng băng).
+- KHÔNG đổi ACTION_LABELS text + aria-label bộ activity ("Activity feed và thống kê", "Danh sách hoạt động", stats labels), KHÔNG bỏ Promise.allSettled independence.
+- KHÔNG gọi API ngoài /api/activity/*; KHÔNG thêm deps; KHÔNG merge vào main / tạo PR.