The system is character-agnostic by construction — character subjects are resolved dynamically via paths.py, so the public toolkit ships no corpus at all and still imports, compiles, and tests. Every framework owns exactly one write-root and communicates via an event bus, never through cross-domain file writes.Hệ thống character-agnostic theo cấu trúc — nhân vật được resolve động qua paths.py, nên toolkit công khai ship không corpus nào mà vẫn import, compile, và test. Mỗi framework sở hữu đúng một write-root và giao tiếp qua event bus, không bao giờ qua ghi file chéo miền.

7 write-roots — one per framework7 write-root — một cho mỗi framework

Each framework owns exactly the directories listed. Cross-domain writes are banned (Rule 12) — if a framework needs another's data, it fires an event and waits for the response.Mỗi framework sở hữu đúng những thư mục được liệt kê. Ghi chéo miền bị cấm (Rule 12) — nếu một framework cần dữ liệu của framework khác, nó phát sự kiện và chờ phản hồi.

FrameworkFramework	Write-root(s)Write-root	PurposeMục đích
MAT	docs/materials/	Evidence ingestion, CRAAP scores, T1–T5 tier filesThu nhận bằng chứng, điểm CRAAP, file bậc T1–T5
PSY	docs/profiles/ · docs/references/ · docs/graph/	25-file profile schema, clinical references, knowledge graphSchema hồ sơ 25-file, reference lâm sàng, đồ thị tri thức
CRE	assets/	Platform-native content packages ({platform}/{YYMMDD}-{slug}/)Gói nội dung gốc nền tảng ({platform}/{YYMMDD}-{slug}/)
GRO	docs/profiles/*/growth/	Career trajectory, competency maps, mentoring recordsQuỹ đạo sự nghiệp, bản đồ năng lực, hồ sơ cố vấn
EVL	docs/rubrics/ · docs/profiles/*/eval/	Versioned rubrics, evidence-cited scorecardsRubric có phiên bản, scorecard trích nguồn bằng chứng
ORC	.claude/	Event routing, session state, decisions log, agent memoryĐịnh tuyến sự kiện, trạng thái phiên, nhật ký quyết định, bộ nhớ agent
COM	.claude/ (shared; utility-only)(dùng chung; chỉ tiện ích)	Git hygiene, health monitoring, rules validation, skill analyticsVệ sinh git, giám sát sức khỏe, kiểm rule, phân tích skill

platform_lib — shared Python toolkitplatform_lib — bộ toolkit Python dùng chung

Shared Python helpers under .claude/scripts/platform_lib/. Skills import these directly; they are not addressable via the skill catalog. The design principle: scripts gather deterministically (may over-flag); the LLM judges. Never delegate reasoning to scripts.Helper Python dùng chung dưới .claude/scripts/platform_lib/. Skill import trực tiếp; chúng không địa chỉ được qua catalog skill. Nguyên tắc thiết kế: script gom tất định (có thể over-flag); LLM phán xử. Không bao giờ giao lập luận cho script.

4-layer knowledge graphĐồ thị tri thức 4 lớp

The knowledge graph lives at docs/graph/ and is owned by PSY (it models profile relationships). orc:graph queries it via seven platform_lib modules. Layers are incremental — each builds on the last.Đồ thị tri thức nằm ở docs/graph/ và do PSY sở hữu (nó mô hình hóa các quan hệ hồ sơ). orc:graph truy vấn nó qua bảy module platform_lib. Các lớp là tăng dần — mỗi lớp xây trên lớp trước.

The core design principleNguyên tắc thiết kế cốt lõi

The self-contained .claude/ treeCây .claude/ tự chứa

Everything needed to run the system is under .claude/. No global install, no dashboard, no external server. The project is self-contained — the venv at .claude/skills/.venv/ is the only Python runtime needed.Mọi thứ cần để chạy hệ thống nằm dưới .claude/. Không cài global, không dashboard, không server ngoài. Dự án tự chứa — venv tại .claude/skills/.venv/ là runtime Python duy nhất cần.

JSON schemas & runtime validationJSON schema & xác thực lúc chạy

Rubrics and scorecards are validated at runtime — evl:validate runs the check and schema_validator.py fails closed on structural violations. The token below is injected by the build pipeline with live schema stats:Rubric và scorecard được validate lúc chạy — evl:validate chạy kiểm và schema_validator.py fail-closed khi vi phạm cấu trúc. Token bên dưới được build pipeline chèn với thống kê schema trực tiếp:

Schema validation — 119 PASS, 0 FAIL, 3 SKIP
  ✓ All covered files conform to their schema.
PASS — exit 0

COM — utility framework (not a domain)COM — framework tiện ích (không phải miền)

COM handles cross-cutting concerns that no domain framework should own. It performs no domain writes — its only output surfaces are git history, session logs, and reports. Its 5 skills are invoked on-demand, not as part of the event cascade.COM xử lý các mối quan tâm xuyên cắt mà không framework domain nào nên sở hữu. Nó thực hiện không ghi miền — bề mặt đầu ra duy nhất là lịch sử git, log phiên, và báo cáo. 5 skill của nó được gọi theo-yêu-cầu, không phải là một phần của chuỗi sự kiện.