solution-erp/docs/changelog/sessions/2026-04-30-chot-session-6-md-audit-compact.md

Session log — 2026-04-30 chốt session 6 — MD audit + compact + 3 skill refresh + 2 rule mới

Topic: Pure docs work — audit toàn bộ MD, compact 3 file core, refresh 3 skill stale, chốt 2 rule mới (timing test §7 + audit định kỳ §6.4). 0 thay đổi code/test.

Dev: Claude (Opus 4.7) + user (pqhuy1987@gmail.com) Duration: ~2 giờ (bao gồm Q&A về unit test philosophy) Base commit: b874743 (chốt session 5)

Commits session 6

• d2298fa — Docs: chốt rule timing unit test (1 bảng 5-row compact)
• f24acb6 — Docs: compact 3 file core (-273 dòng tổng)
• (commit chốt session 6 này)

A. Q&A unit test philosophy

User hỏi:

1. Ý nghĩa unit test? Lợi ích?
2. Khi spec đổi (không phải bug) thì test thế nào?
3. Khi bug fix thì test thế nào?
4. Có nên áp rule? → user confirm.
5. Rule mới có overkill không? → user nhận xét sắc.
6. Có nên rewrite MD định kỳ? → user hỏi nghiêm túc.

Outcome:

• Chốt rule timing test (rules.md §7) — 1 bảng 5-row compact, sau khi rút gọn từ 70 dòng overkill ban đầu
• Chốt rule audit + compact MD định kỳ (rules.md §6.4) — KHÔNG rewrite toàn bộ
• Lưu feedback memory feedback_unittest_timing.md cho session sau

B. MD compact (commit f24acb6)

File	Trước	Sau	Δ
STATUS.md	196	144	-27%
HANDOFF.md	460	313	-32%
migration-todos.md	210	136	-35%
recently-done-archive-2026-04.md	(mới)	61	archive 51 row Phase 0-7

Pattern:

• STATUS Recently Done > 30 row → archive cũ vào changelog/recently-done-archive-{YYYY-MM}.md
• HANDOFF section duplicate (Versioned WF / File active / Git state) → cross-ref thay vì copy
• migration-todos Phase done → collapse thành 1 paragraph + cross-ref session log

0 information loss — tất cả nội dung vẫn còn ở file gốc (gotchas, rules, architecture, schema-diagram, session logs).

C. 3 skill refresh (commit chốt session)

form-engine/SKILL.md

• Status: "Phase 2 MVP — missing PDF + form builder" → "Tier 3 feature-complete"
• Known limitations: 6 row → 4 row, đánh dấu DONE Phase 8
• "Gen mã HĐ chưa implement" → DONE Phase 3+6, cross-ref contract-workflow skill (bỏ duplicate)

permission-matrix/SKILL.md

• Description: 12 menu + 48 policy → ~60 menu + ~240 policy
• Menu tree section: 12 menu cũ → ~60 với Pe_/PeWf_/Bg_*/Catalogs đầy đủ
• Inheritance roots: 4 group (Contracts/Workflows/PE/PeWorkflows). Budgets KHÔNG inherit (gotcha #35).

ef-core-migration/SKILL.md

• Code pointers: "ApplicationDbContext.cs — 24 DbSet" → "DbSet cho 52 bảng (15 migration)"
• Related: "ERD 24 bảng" → "ERD 52 bảng + §11 PE + §12 Budget + §13 PEDeptOpinions"

D. 2 rule mới chốt

rules.md §7 — Khi nào viết test (timing rule)

| Tình huống | Quy tắc |
| Feature mới | Test-after: UAT 2-3 lần ổn → viết test (≤1 commit theo sau) |
| Bug fix | Test-before BẮT BUỘC: reproduce bằng test failing → fix → green |
| Critical algorithm (codegen/guard/financial/security) | Test-before merge |
| Spec change | Update test cũ + code, commit chung. KHÔNG xóa, KHÔNG skip. |
| Skip | DTO mapping, CRUD master, FE snapshot, wrapper, migration backfill |

Rút gọn từ 70 dòng overkill (decision tree ASCII + triết lý chung + bảng critical algorithm chi tiết) còn 6 dòng. User nhận xét đúng — overkill thật.

rules.md §6.4 — Audit + compact MD định kỳ

Tần suất	Action	Effort
Cuối session	Update STATUS + HANDOFF	~10 phút
Cuối phase (~1 tháng)	Compact STATUS Recently Done > 30 row → archive	~30 phút
Đầu mỗi tháng (cron)	Audit skill + doc drift + count consistency, patch (Edit, không rewrite)	~45 phút
Khi trigger riêng	Selective rewrite 1 file (drift > 30%)	1-2 giờ
KHÔNG BAO GIỜ	Rewrite toàn bộ docs	—

Doc audit checklist (mở rộng từ §9.4 skill audit, chạy cùng cron):

1. dotnet test count khớp STATUS/CLAUDE/HANDOFF
2. ls migrations/ count khớp ef-core-migration skill
3. grep '#[0-9]\+' gotchas.md count khớp HANDOFF/STATUS
4. STATUS Recently Done > 30 row → đề xuất archive
5. HANDOFF section duplicate → đề xuất bỏ
6. Skill SKILL.md mention "Phase N MVP" mà N <= phase hiện tại → stale
7. Output report → human review patch (Edit, KHÔNG Write toàn file)

§9.4 Skill audit mở rộng cross-ref §6.4 — chạy chung cron solution-erp-skill-audit-monthly.

E. Verify state cuối session

✅ 77 test pass (Domain 54 + Infra 23) — chạy `dotnet test SolutionErp.slnx`
✅ 15 migration / 52 bảng / 41 gotcha — khớp docs
✅ 6 skill (3 refresh trong session)
✅ Cron 2026-05-01 ready fire mai (combined audit)
✅ MEMORY.md có 3 entry (project + node CI/CD + unit test timing)

F. Files touched session 6

docs/rules.md                                      (mod: §7 Timing test rule + §6.4 doc audit + §9.4 cross-ref)
docs/STATUS.md                                     (mod: Phase 9 active + Session 6 Recently Done + cron 05-01)
docs/HANDOFF.md                                    (mod: TL;DR session 6 + cảnh báo session 7+, bỏ 3 section duplicate)
docs/changelog/migration-todos.md                  (mod: Phase 6-7 collapse, Phase 9 + Session 6 done sub)
docs/changelog/recently-done-archive-2026-04.md    (NEW: 51 row archive)
docs/changelog/sessions/2026-04-30-chot-session-6-md-audit-compact.md (NEW: file này)
.claude/skills/form-engine/SKILL.md                (mod: refresh Phase 2 MVP → Tier 3 done)
.claude/skills/permission-matrix/SKILL.md          (mod: refresh 12 menu → ~60 + inheritance roots)
.claude/skills/ef-core-migration/SKILL.md          (mod: refresh count 24 → 52)
CLAUDE.md (root)                                   (mod: timing test compact 1 dòng)
~/.claude/.../memory/feedback_unittest_timing.md   (NEW: feedback memory)
~/.claude/.../memory/MEMORY.md                     (mod: index +1 entry)

G. Cảnh báo session 7

1. Cron solution-erp-skill-audit-monthly fire 2026-05-01 9:00 — combined audit theo §6.4 + §9.4 checklist. Log → docs/changelog/skill-audit-2026-05.md. Session sau verify cron đã fire OK.
2. Hard blockers ops vẫn chờ user — UAT 1 tuần / SMTP / rotate creds / SQL backup schedule.
3. 3 feature mới chưa test (PE Opinion Upsert / Budget validate / Contract BudgetId carry) — đợi UAT phát sinh bug → áp §7 rule (regression test before fix).
4. win-acme schedule task unhealthy — fix trước cert expire 2026-06-18.
5. MD compact pattern lần kế: cuối Phase 9 (sau UAT) — STATUS Recently Done > 30 row archive lần 2.

H. Lessons learned session 6

1. User feedback on overkill — Claude tendency là viết quá dài. Lần đầu rule timing test = 70 dòng (decision tree ASCII + triết lý + bảng chi tiết). User catch ngay → rút còn 6 dòng. Bài học: skill audit phải có "compact pass" sau draft đầu.
2. Rewrite vs compact — User hỏi nghiêm túc "rewrite toàn bộ định kỳ" và push back tốt khi tôi suggest 4 chiến lược (compact / audit / selective rewrite / never full rewrite). Confirm: drift là normal, fix bằng patch, KHÔNG rewrite.
3. Skill staleness là silent killer — form-engine lifeline "Phase 2 MVP missing PDF" survived qua nhiều session vì chỉ Claude đọc trước khi auto-invoke. User không thấy trực tiếp. Cron audit định kỳ là cơ chế duy nhất catch được.
4. Feedback memory path — Lưu rule vào memory file giúp session sau (không có conversation history) tự áp dụng. 3 entry hiện tại: project overview / Node CI/CD pin / unit test timing. Không bloat — chỉ rule actionable.
5. Path filter CI làm việc cực tốt cho docs-heavy session — session 6 có 3 commit, đều skip CI (0s deploy). Saving lớn nếu maintain pattern này.

I. Stats sau session 6

	Trước S6	Sau S6
BE LOC	~13050	~13050 (no code change)
DB tables	52	52
Migrations	15	15
API endpoints	~128	~128
FE pages	~31	~31
Tests	77	77 (no test change)
Gotchas	41	41
Skill	6 (3 stale)	6 (3 refresh)
Docs lines core 3 file	866	593 (-273, -32%)
Memory entries	2	3 (+unit test timing)
Demo user	30	30
Commits S6	0	3 (rule + compact + chốt)
Session log files	17	18