Thông tin ADR

Trường	Giá trị
ID	ADR-0815
Tier	08xx
Trạng thái	accepted
Ngày tạo	—
Cập nhật lần cuối	—
Audit định kỳ	—
Thay thế	—
Bị thay thế bởi	—

ADR-0815: Claire Master Frontend Sunset

Status: Accepted Date: 2026-03-05 Deciders: Daniel (khuongle.daniel@gmail.com) Category: Operation Infrastructure — Project Lifecycle Tags: claire-master, frontend, sunset, deprecation, claire-web-app

Context

claire-master-frontend là standalone Next.js web app tại ACE-engines/ACE-LDK-claire-MASTER-engine/frontend/, được khởi tạo như một prototype/reference implementation cho Claire AI web interface. Project đã đạt:

v1.0 Core Chat MVP (shipped 2026-02-24) — streaming chat, tool use, quick commands, DS v3
v2.0 Engine Dashboard + Pack Foundation (shipped 2026-02-27) — engine data views, pack schema, MFE extraction

Trong khi đó, claire-web-app (ACE-claire-web-app) đã tiến hóa thành production-grade multi-tenant platform với:

Supabase auth, RLS, rate limiting
Multi-org, RBAC, audit logging
Observability (Sentry, AI usage telemetry)
Advanced E2E test coverage (Playwright, 26 phases)
Portfolio Cycle PC1 đã lên kế hoạch v4.0 “Daniel Parity” — tích hợp toàn bộ tính năng của claire-master

Việc duy trì song song hai frontend app tạo ra:

Maintenance overhead: Hai codebase Next.js cần update DS, dependencies, auth patterns riêng biệt
Feature drift: claire-master ngày càng lag so với claire-web-app
Context fragmentation: Agent và engineer phải context-switch giữa hai project
Confusion về direction: claire-master v3.0 đã được plan nhưng không còn phù hợp với portfolio strategy

Decision

Sunset claire-master-frontend standalone web app ngay lập tức (2026-03-05).

Cụ thể:

Dừng mọi development trên ACE-engines/ACE-LDK-claire-MASTER-engine/frontend/
Không thực hiện v3.0 cycle đã được plan trước đó
Archive project ở trạng thái v2.0 COMPLETE
Tính năng reference (tool use, quick commands, MFE contract) đã được capture trong .ACE/mfe-contract-v1.md và sẽ được implement trong claire-web-app v4.0 (Phase 33–40)

Scope rõ ràng:

✅ Sunset: ACE-engines/ACE-LDK-claire-MASTER-engine/frontend/ (standalone web app)
❌ KHÔNG sunset: ACE-engines/ACE-LDK-claire-MASTER-engine/ (engine, memory, agents, data — vẫn active)
❌ KHÔNG sunset: ACE-packs/ACE-LDK-claire-MASTER-pack/ (pack — vẫn active)

Rationale

Why sunset now (not after v4.0)?

Portfolio Cycle PC1 đã allocate claire-web-app v4.0 (Phase 33–40) để deliver “Daniel Parity” — tức là toàn bộ tính năng của claire-master được rebuild natively trong claire-web-app. Tiếp tục develop claire-master song song sẽ:

Tạo conflict về where features land
Tăng risk của duplicate implementation
Làm chậm velocity claire-web-app khi context phân tán

Sunset sớm giúp tập trung 100% effort vào claire-web-app v4.0.

Why not archive later?

v2.0 là một completion point tự nhiên — 40/40 points, all phases complete, build passing. Đây là thời điểm tốt nhất để archive: clean state, không có work-in-progress.

Migration path

claire-master feature	Migration target	Timeline
Tool use (read_active_tasks, read_deadlines, read_diary, read_issues)	claire-web-app v4.0 Phase 34 (Engine Gateway Client)	PC1 M1
Quick Commands Panel (7 commands)	claire-web-app v4.0 Phase 33 (Quick Commands Framework)	PC1 M1
`<ClaireChat />` MFE contract	claire-web-app v4.0 Phase 38 (Enhanced Chat UX)	PC1 M1
Engine Dashboard	claire-web-app v4.0 Phase 34	PC1 M1
CLAIRE_TOOLS + sentinel protocol	claire-web-app v4.0 (adapt to EG client pattern)	PC1 M1

Reference: .ACE/mfe-contract-v1.md trong frontend directory (preserved as archive artifact).

Consequences

Positive

Reduced maintenance surface: Chỉ còn một Next.js frontend cần maintain
Clear ownership: claire-web-app là definitive Claire AI web interface
Focused velocity: Engineering effort 100% vào claire-web-app v4.0+
Clean portfolio: Portfolio dashboard không còn bị confusing với “v2.0 Complete → promote / v3.0 next”

Negative / Mitigations

No localhost
dev tool: Trước đây claire-master chạy ở port 3001 để quick test. Mitigation: claire-web-app dev server (port 3000/3002) phục vụ mục đích này trong v4.0
Reference implementation lost as live app: Mitigation: Code, decisions, MFE contract được archive và remain accessible tại frontend/ — không xóa source code

Neutral

ACE-engines/ACE-LDK-claire-MASTER-engine/ engine và tất cả artifacts vẫn active và unchanged
Existing Playwright E2E tests trong frontend/tests/e2e/ được preserve as reference

Implementation Checklist

ADR-0815 created (2026-03-05)
frontend/.planning/STATE.md updated → SUNSET
GSD Portfolio PORTFOLIO.md updated → claire-master status = ⛔ SUNSET
project-aliases.json updated → claire-master archived
frontend/SUNSET.md created với sunset notice
claire-web-app v4.0 Phase 33 PLAN.md reference claire-master tool use patterns (at planning time)

ADR-0308: Software Delivery Portfolio Delivery Mode and Analysis
ADR-0314: Portfolio-Level ACE Cycle Planning
ADR-0807: Milestone Lifecycle and Phase-Level Release
ADR-0221: Mandatory UX Design Step for Frontend Projects

Recorded by Claire (Cursor agent) on behalf of Daniel — 2026-03-05