0. Gate references
Link bắt buộc: 05_MEMORIES/Designs/F##_short-name.html
1. Discovery summary
| Mục | Nội dung |
|---|---|
| Problem/Idea | Vấn đề hoặc ý tưởng đã mổ xẻ. |
| Goal | Kết quả cần đạt. |
| Non-goals | Những gì không làm trong scope này. |
| Users affected | Nhóm người dùng bị ảnh hưởng. |
| Constraints | Ràng buộc kỹ thuật/nghiệp vụ. |
2. Approved mockup / UX contract
| Contract | Mô tả |
|---|---|
| Layout | Vùng UI, hierarchy, breakpoint, scroll behavior. |
| Interaction | Click/hover/focus/keyboard/empty/loading/error. |
| Design language | Token/pattern HybReport phải bám. |
Nếu code lệch mockup đã duyệt → phải quay lại Gate 1 hoặc Gate 2 tùy mức độ.
3. Option analysis
| Option | Approach | Native compliance | Decision |
|---|---|---|---|
| A | Native/metadata-first | ✅ | Preferred nếu đủ. |
| B | Custom compatible | ⚠️ | Dùng khi native thiếu. |
| C | Hack/phá chuẩn | ❌ | Cấm triển khai. |
4. Huấn vs Bảnh
| Role | Nội dung |
|---|---|
| Huấn | Đề xuất cách triển khai cụ thể. |
| Bảnh | Phản biện risk, security, regression, architecture. |
| Final | Quyết định của coordinator + Admin. |
5. Scope & committed files
| Path | Action | Reason |
|---|---|---|
| client/custom/modules/... | MODIFY | ... |
| custom/Espo/Modules/... | NO TOUCH | Out of scope. |
6. Phase plan / phân kỳ
| Phase | Goal | Files | Output | Admin Manual Test | Rollback |
|---|---|---|---|---|---|
| P1 | Vertical slice testable | ... | ... | Steps rõ ràng | File/path rollback |
| P2 | Next slice | ... | ... | Steps rõ ràng | File/path rollback |
7. Risk plan
| Risk | Level | Mitigation |
|---|---|---|
| Security/Data/UX/Perf/Compat | Low/Med/High | Mitigation cụ thể. |
8. Verification plan
| Type | Command/Steps | Evidence |
|---|---|---|
| Static | lint/syntax/search | output |
| Automated | tests nếu có | result |
| Manual | Admin test theo phase | confirm |
9. Release plan
Version target: vX.Y.Z
Golden Record: 05_MEMORIES/Releases/vX.Y.Z.md
Release backup: 07_BACKUPS/vX.Y.Z/...
Antibody: 04_KNOWLEDGE/Antibodies/AB-...
FBS: python .agents/fqext/hyos.py fbs {ID}