minipower-analyst-cr

minipower-analyst-cr

Change request nội dung (delta FR/AC, DOC-18). Ticket board = minipower-pm-cr-track.

Pack: minipower · Tiên quyết: baseline DOC-01–07.

Template: DOC-18 · Folder: 00-governance/ · 06-changes/CR-xxx/ · Versioning: doc-versioning

Quy tắc: Sau baseline → CR bắt buộc · không sửa 02-baseline/ trực tiếp.

CR → impact → deltas/ → merge docs → regression → approve → vX.Y

Sau merge delta — minipower-*-review trong pack nghề regression tài liệu (trace + mâu thuẫn) trước re-baseline. CR lớn → minipower-router-deliberation trước khi chấp thuận.

Theo chế độ dự án

Chế độ đọc từ memory/profile.json; định nghĩa ở minipower-router § Chế độ dự án — không lặp lại ở đây.

	standard	mvp	maintain
CR	bắt buộc sau baseline	chưa baseline → đổi tự do, ghi doc-debt.md	CR = đơn vị công việc chính
Sự cố vận hành	hiếm	hiếm	06-changes/incident/ → thường đẻ ra CR
doc-review sau merge	đủ chiều	rút chiều	chỉ vùng CR động vào

Gate này mềm — không hook nào chặn trên "đã có CR chưa". Cái cứng là baseline-guard: docs/02-baseline/ deny ở mọi chế độ, không BYPASS. Vì thế "không sửa baseline trực tiếp" là điều kiện máy giữ được, còn "phải mở CR" thì không.

---

Chuyển chế độ dự án (QĐ-7)

Đổi project_mode không phải sửa một trường — nó là sự kiện có nghi thức, đi qua skill này và phải kèm DEC. Không có nghi thức thì "tự nhận mvp" thành đường né gate (R3).

mvp → standard — trả nợ rồi chốt baseline

1. Đọc memory/doc-debt.md — đó là danh sách việc, không phải ghi chú.
2. Backfill các DOC trong docs_focus của standard còn ở trạng thái nợ. Nguồn là artifact MVP đã có: code, FR rời, AC, ADR. Backfill là viết ngược từ cái đã làm — gần với minipower-architecture-as-built hơn là viết mới.
3. Gắn ID cho mọi FR/UC/AC chưa có ({MOD}-FR-001…). Nếu đã dùng ID từ ngày đầu như khuyến nghị thì bước này gần như trống.
4. trace:check phải xanh — ID không trỏ sai, không trùng.
5. Chốt baseline đầu tiên → docs/02-baseline/v1.0/.
6. Ghi DEC DEC-CHG-NNN: mode cũ → mới · vì sao · nợ nào đã trả · nợ nào cố ý mang theo.
7. Đổi project_mode trong memory/profile.json → standard.

Không có bước di trú cấu trúc. Khung folder đã đủ từ ngày init (QĐ-2) — chỉ điền tiếp.

maintain → standard — as-built đủ rồi mới chốt

1. minipower-architecture-as-built cho tới khi phủ hết docs_focus của maintain (04 · 08 · 09 · 10 · 11 · 12 · 17 · 18).
2. Mọi mục vào docs/ phải đã có người xác nhận — nháp chưa xác nhận không tính là đã trả nợ.
3. assets/archive/ còn nguồn "nghi ngờ" chưa xử lý → hoặc xác nhận, hoặc hạ xuống "đã lỗi thời". Không để lửng.
4. trace:check xanh → chốt baseline → ghi DEC → đổi trường.

standard → mvp / → maintain — hiếm, nhưng có thật

Dự án bị cắt scope, hoặc bàn giao cho đội vận hành. Vẫn phải ghi DEC — và ghi rõ baseline đã chốt có còn hiệu lực không. Hạ mode không xoá baseline đã có.

Hạ mode là tín hiệu cần người quyết, không phải thao tác dọn dẹp. decision-staleness sẽ nhắc nếu mvp sống quá lâu (R3).

Format doc-debt.md

Sổ nợ là điều kiện vào luồng chuyển mode, nên format phải máy đọc được ở mức tối thiểu:

| # | Thiếu gì | Module / phạm vi | Vì sao chấp nhận thiếu | Cần trước khi | Trạng thái |
|---|----------|------------------|------------------------|---------------|------------|
| 1 | DOC-04 Business Rules | ORD | MVP demo 3 tuần | chốt baseline v1.0 | ☐ nợ |

Quy tắc
Thiếu gì	Nêu DOC-NN rõ ràng — DOC-04 Business Rules, không phải "tài liệu nghiệp vụ"
Module / phạm vi	{MOD} nếu DOC theo module; dự án nếu cấp dự án. Cột này khớp chiều doc_scope mà prereq-gate dùng
Trạng thái	☐ nợ · ☐ đang trả · ☑ xong
Khi nào ghi	prereq-gate nhắc thiếu tiền đề mà vẫn quyết làm tiếp → ghi ngay. Đó là lúc nợ phát sinh

Liên quan: minipower-analyst-srs · minipower-architecture-sad · minipower-pm-plan · minipower-ops-deploy / minipower-qa-strategy · minipower-architecture-as-built

Anti-patterns

• Sửa SRS không CR · duplicate DOC · approve CR không cập nhật trace/test
• Đổi project_mode mà không ghi DEC — mất dấu vết, và mở đường né gate (R3)
• Hạ mode để cho gate im thay vì trả nợ tài liệu
• Coi doc-debt.md là ghi chú tuỳ hứng — nó là danh sách việc của luồng lên standard

Hướng dẫn người: README.md.