Incomex AI Portal
KB-3673

PG read PG old docs cleanup — 2026-06-27

7 min read Revision 1
reportpg-read-pgcleanupold-delete2026-06-27

PG read PG old docs cleanup — 2026-06-27

Mission: Dọn knowledge/dev/laws-new/pg-read-pg/ cho hướng mới Balo/dán nhãn. Không sửa nội dung tài liệu; chỉ archive tài liệu cũ sang old-delete/ rồi xóa bản gốc sau khi verify.

0. Nền tảng

Đã đọc .claude/skills/incomex-rules.md đầy đủ: 36 mục, 8 bước.

Đã đọc qua search_knowledge() trực tiếp main process:

  • operating rules SSOT → hit chính: knowledge/dev/ssot/vps/vps-operating-rules.md, Version 1.0, Date 2026-02-28.
  • hiến pháp v4.0 constitution → hit chính: knowledge/dev/laws/constitution.md, metadata hiện hành v4.6.3; đồng thời có context review v4.0.
  • Luật/liên quan mission: pg read pg balo dán nhãn old-delete quy định → hit knowledge/dev/laws-new/pg-read-pg/old-delete/README.md, de-bai-pg-read-pg.md, balo-thuc-the-quy-dinh.md.

3 câu Tuyên ngôn

  1. Vĩnh viễn: Cleanup chuyển tài liệu cũ vào archive path ổn định old-delete/; root chỉ còn SSOT hiện hành cho hướng Balo/dán nhãn, không cần dọn lại từng file lẻ.
  2. Nhầm được không: Script move dùng danh sách explicit 8 source path; archive được read-back và so SHA-256 trước delete. Hai file Balo không nằm trong danh sách delete.
  3. 100% tự động: Toàn bộ move chạy bằng Agent Data API loop: get full → upload archive → get archive → compare exact content/hash → delete source. Không có edit tay nội dung.

1. Nhận việc

Mục tiêu duy nhất: move an toàn 8 tài liệu cũ từ knowledge/dev/laws-new/pg-read-pg/ sang knowledge/dev/laws-new/pg-read-pg/old-delete/, giữ nguyên nội dung.

2. Thiết kế trước khi làm

Đây là cleanup/archive document, không phải thiết kế feature/collection mới.

Luồng áp dụng:

  1. List prefix bằng MCP Agent Data.
  2. Read full content từng source.
  3. Upload archive path với cùng content.
  4. Verify archive đọc lại được và hash khớp.
  5. Delete source.
  6. List hậu kiểm.

3. Thực thi

List prefix ban đầu

MCP list_documents(path='knowledge/dev/laws-new/pg-read-pg/', limit=100) trả returned_count=11, gồm:

  • balo-thuc-the-design-handoff.md
  • balo-thuc-the-quy-dinh.md
  • bao-cao-pg-read-pg.md
  • de-bai-pg-read-pg.md
  • dot-list.md
  • form-nuxt-report.md
  • old-delete/README.md
  • runbook-reports-mvp.md
  • thiet-ke/thiet-ke-khuon-reports.md
  • tong-hop-pg.md
  • workflow-list.md

Move + verify evidence

Script output thật:

MOVED knowledge/dev/laws-new/pg-read-pg/bao-cao-pg-read-pg.md -> knowledge/dev/laws-new/pg-read-pg/old-delete/bao-cao-pg-read-pg.md chars=5836 sha256=9d47b43af36b48a4e4e7563f57a212cb77a4ab3b16f5f47b8fc7509ba8e7c730
MOVED knowledge/dev/laws-new/pg-read-pg/de-bai-pg-read-pg.md -> knowledge/dev/laws-new/pg-read-pg/old-delete/de-bai-pg-read-pg.md chars=12537 sha256=954e45e7d27245ad201e041320d7d6b31753df125c0bbb080ef40555d36f2da9
MOVED knowledge/dev/laws-new/pg-read-pg/dot-list.md -> knowledge/dev/laws-new/pg-read-pg/old-delete/dot-list.md chars=2001 sha256=2278ec03c5dbe16846b2e8967c2c80328391efe54c345ac3c38654074b1c9523
MOVED knowledge/dev/laws-new/pg-read-pg/form-nuxt-report.md -> knowledge/dev/laws-new/pg-read-pg/old-delete/form-nuxt-report.md chars=7569 sha256=40bb5b8dc2e3a7197a212b22f375788a9a225e31e8e503bb55d6aecc73b51bc9
MOVED knowledge/dev/laws-new/pg-read-pg/runbook-reports-mvp.md -> knowledge/dev/laws-new/pg-read-pg/old-delete/runbook-reports-mvp.md chars=9762 sha256=670c8ce076e066be8d03e0618bc3144a1da96a8331e51541b213212b34a65e97
MOVED knowledge/dev/laws-new/pg-read-pg/thiet-ke/thiet-ke-khuon-reports.md -> knowledge/dev/laws-new/pg-read-pg/old-delete/thiet-ke/thiet-ke-khuon-reports.md chars=26046 sha256=366e7d151b169c24055a12ad4af6f8909fbc4a1f823bd48f1c800337492f3a0d
MOVED knowledge/dev/laws-new/pg-read-pg/tong-hop-pg.md -> knowledge/dev/laws-new/pg-read-pg/old-delete/tong-hop-pg.md chars=2328 sha256=58cf086d18742d0c8aa016bbacc4c8dc6fed78a33427c64d55b848c55540c987
MOVED knowledge/dev/laws-new/pg-read-pg/workflow-list.md -> knowledge/dev/laws-new/pg-read-pg/old-delete/workflow-list.md chars=2198 sha256=1dbf4690870485ef986884219061714ba23e4544b2fff144be3348ae23dc52d3

Với mỗi dòng trên, script đã thực hiện: read full source → upload archive → read full archive → compare exact string + SHA-256 → chỉ sau đó mới delete source.

4. Hai mũ / deploy

Không áp dụng PR/deploy vì đây là thao tác KB document archive qua Agent Data, không đổi code/schema/production app.

Self-review:

  • Không delete 2 file Balo.
  • Không sửa nội dung tài liệu; archive hash được tính trên body đọc từ source và verify với archive trước delete.
  • Subfolder được hỗ trợ: old-delete/thiet-ke/thiet-ke-khuon-reports.md đã tạo và đọc lại được.

5. Verify

List hậu kiểm prefix pg-read-pg/

MCP list_documents(path='knowledge/dev/laws-new/pg-read-pg/', limit=100) trả returned_count=11 sau cleanup. Trong đó parent root knowledge/dev/laws-new/pg-read-pg chỉ còn:

  • knowledge/dev/laws-new/pg-read-pg/balo-thuc-the-design-handoff.md
  • knowledge/dev/laws-new/pg-read-pg/balo-thuc-the-quy-dinh.md

Các file còn lại đều nằm dưới old-delete/.

List hậu kiểm old-delete/

MCP list_documents(path='knowledge/dev/laws-new/pg-read-pg/old-delete/', limit=100) trả returned_count=9:

  • knowledge/dev/laws-new/pg-read-pg/old-delete/README.md
  • knowledge/dev/laws-new/pg-read-pg/old-delete/bao-cao-pg-read-pg.md
  • knowledge/dev/laws-new/pg-read-pg/old-delete/de-bai-pg-read-pg.md
  • knowledge/dev/laws-new/pg-read-pg/old-delete/dot-list.md
  • knowledge/dev/laws-new/pg-read-pg/old-delete/form-nuxt-report.md
  • knowledge/dev/laws-new/pg-read-pg/old-delete/runbook-reports-mvp.md
  • knowledge/dev/laws-new/pg-read-pg/old-delete/thiet-ke/thiet-ke-khuon-reports.md
  • knowledge/dev/laws-new/pg-read-pg/old-delete/tong-hop-pg.md
  • knowledge/dev/laws-new/pg-read-pg/old-delete/workflow-list.md

6. Báo cáo + dọn dẹp

File đã move:

  • bao-cao-pg-read-pg.md → old-delete/bao-cao-pg-read-pg.md
  • de-bai-pg-read-pg.md → old-delete/de-bai-pg-read-pg.md
  • dot-list.md → old-delete/dot-list.md
  • form-nuxt-report.md → old-delete/form-nuxt-report.md
  • runbook-reports-mvp.md → old-delete/runbook-reports-mvp.md
  • thiet-ke/thiet-ke-khuon-reports.md → old-delete/thiet-ke/thiet-ke-khuon-reports.md
  • tong-hop-pg.md → old-delete/tong-hop-pg.md
  • workflow-list.md → old-delete/workflow-list.md

File giữ lại:

  • knowledge/dev/laws-new/pg-read-pg/balo-thuc-the-quy-dinh.md
  • knowledge/dev/laws-new/pg-read-pg/balo-thuc-the-design-handoff.md
  • knowledge/dev/laws-new/pg-read-pg/old-delete/README.md

File không move được: không có.

OR/TD update: Không cần — mission chỉ archive tài liệu cũ, không thay đổi luật vận hành, schema, DOT, hoặc trạng thái task hệ thống.

Verdict

PASS — root pg-read-pg/ đã sạch: chỉ còn 2 file Balo hiện hành ở parent root; archive đầy đủ nằm trong old-delete/, đã verify đọc lại và hash khớp trước khi delete bản gốc.