human-analyzer
HomeTrang chủ GuidesHướng dẫn JourneyHành trình
Follow one synthetic material from ingest to a gated, published assetTheo một tư liệu giả lập từ thu nhận đến asset đã-gate, đã-đăng

JourneyHành trình

source → MAT → PSY → EVL → CRE → assets/

This page traces a single synthetic material — no real PII, sourced from e2e/synthetic-project/ — through every event hand-off in the cascade. Each station names the skill, the event it emits, and what gates before the next stage can proceed. The full run is captured live: real outputTrang này theo dấu một tư liệu giả lập — không có PII thật, lấy từ e2e/synthetic-project/ — qua mọi lần bàn giao sự kiện trong cascade. Mỗi trạm nêu tên skill, sự kiện nó phát, và những gì cần qua cổng trước khi giai đoạn kế tiếp có thể tiếp tục. Toàn bộ lần chạy được chụp thật: đầu ra thật

python3 e2e/run-full-pipeline.py
[FINDINGS] PSY · health-check · completeness
[OK      ] PSY · crossref · timeline (dim 1)
[OK      ] PSY · crossref · bidirectional refs
[OK      ] PSY · crossref · extract events
[OK      ] PSY · timeline-sync
[FINDINGS] GRO · validate growth
[OK      ] GRO · competency gather
[OK      ] MAT · indexer · coverage gaps
[OK      ] MAT · indexer · stale materials
[OK      ] MAT · loader · inventory
[OK      ] MAT · loader · dup detection
[FINDINGS] CRE · humanize · scan ai-tells
[OK      ] CRE · privacy-guard · scan assets
[OK      ] CRE · privacy-guard · confidential names
[OK      ] EVL · validate · all rubrics
[OK      ] EVL · validate · scorecard invariants
[OK      ] LIB · verdict_cache · crisis is never-cached
[OK      ] LIB · verdict_cache · store+hit a verdict
[OK      ] LIB · preferences · read knobs

→ 19/19 steps OK · 7 frameworks · synthetic fixture · exit 0

The run above drives all 19 deterministic steps across 7 frameworks. Follow along below for what each station does and why the event matters.Lần chạy trên điều khiển cả 19 bước tất định qua 7 framework. Theo dõi bên dưới để biết từng trạm làm gì và tại sao sự kiện quan trọng.

The cascade — station by stationCascade — từng trạm

Material must clear each gate before the next framework may act. ORC is the event bus throughout — it routes, it doesn't own content. Each station emits exactly one event when it succeeds; a gate failure is fail-closed (the material stays at that station).Tư liệu phải qua mỗi cổng trước khi framework kế tiếp có thể hành động. ORC là event bus xuyên suốt — định tuyến, không sở hữu nội dung. Mỗi trạm phát đúng một sự kiện khi thành công; lỗi cổng là fail-closed (tư liệu ở lại trạm đó).

01 · MAT

mat:loader

Ingest the raw source. Classify type (transcript / article / interview), run the 15-criterion CRAAP score, assign evidence tier T1–T5, inject frontmatter. The loader writes only to docs/materials/. A source that fails minimum CRAAP stays at stage 1 — never reaches analysis.Thu nhận nguồn thô. Phân loại loại (bản ghi / bài báo / phỏng vấn), chạy chấm CRAAP 15 tiêu chí, gán bậc bằng chứng T1–T5, chèn frontmatter. Loader chỉ ghi vào docs/materials/. Nguồn trượt CRAAP tối thiểu ở lại giai đoạn 1 — không bao giờ đến phân tích.

writes docs/materials/ · no event yetghi docs/materials/ · chưa phát sự kiện
02 · MAT

mat:indexer

Run the integration gate: contradiction detection (does this source conflict with existing evidence?), coverage gap analysis (which profile dimensions does it fill?), and the final integration check. Only a source that passes all three checks is marked integrated. Premature PSY analysis is explicitly blocked until this point.Chạy cổng tích hợp: phát hiện mâu thuẫn (nguồn này có mâu thuẫn với bằng chứng hiện có không?), phân tích khoảng trống phủ sóng (nó lấp đầy chiều hồ sơ nào?), và kiểm tra tích hợp cuối. Chỉ nguồn qua cả ba kiểm tra mới được đánh dấu tích hợp. Phân tích PSY sớm bị chặn rõ ràng đến tận điểm này.

emits MAT.integrated → triggers PSY.refreshphát MAT.integrated → kích hoạt PSY.refresh
03 · PSY

psy:wave

Three-wave 5P clinical formulation: Wave 1 (Foundation — presenting picture, history, predisposing factors), Wave 2 (Deep Dive — defenses, attachment, trauma, Big Five, ICD-11 diagnostics), Wave 3 (Validation — internal consistency, cross-wave coherence). Each wave reads the integrated material; the formulation writes to the 25-file profile schema under docs/profiles/.Formulation 5P lâm sàng 3 đợt: Đợt 1 (Nền tảng — tranh bày hiện tại, lịch sử, yếu tố tiền định), Đợt 2 (Khai phá — cơ chế phòng vệ, gắn bó, sang chấn, Big Five, chẩn đoán ICD-11), Đợt 3 (Xác nhận — nhất quán nội bộ, kết hợp liên đợt). Mỗi đợt đọc tư liệu đã tích hợp; formulation ghi vào schema hồ sơ 25-file dưới docs/profiles/.

writes docs/profiles/ · no event yetghi docs/profiles/ · chưa phát sự kiện
04 · PSY

psy:crossref · psy:health-check

psy:crossref runs 10-dimension consistency validation (4 automated script checks + 6 LLM heuristic checks): timeline integrity, bidirectional reference symmetry, event extraction coherence, and cross-character relationship consistency. psy:health-check scores the 25-file profile 0–100 for completeness. Both must pass before the profile is considered refreshed.psy:crossref chạy xác nhận nhất quán 10 chiều (4 kiểm tra script tự động + 6 kiểm tra heuristic LLM): tính toàn vẹn dòng thời gian, đối xứng tham chiếu hai chiều, mạch lạc trích xuất sự kiện, và nhất quán quan hệ liên nhân vật. psy:health-check chấm hồ sơ 25-file từ 0–100 về độ đầy đủ. Cả hai phải pass trước khi hồ sơ được coi là đã làm mới.

emits PSY.refresh → triggers EVL + CREphát PSY.refresh → kích hoạt EVL + CRE
05 · EVL

evl:score

Score the refreshed profile against a versioned rubric. Scripts do deterministic gathering and weighted aggregation; the LLM judges each criterion. Every criterion must cite a MAT evidence tier (T1–T5) — an uncited score is reported [UNVERIFIED] and counted, never a silent pass. High-stakes rubrics use ≥2 independent judges → convergence; a divergence routes to manual review, never an auto-average.Chấm hồ sơ đã làm mới theo rubric có phiên bản. Script thực hiện thu thập tất định và tổng hợp trọng số; LLM phán xét từng tiêu chí. Mỗi tiêu chí phải trích dẫn bậc bằng chứng MAT (T1–T5) — điểm không trích là [UNVERIFIED] và được đếm, không bao giờ pass ngầm. Rubric rủi ro cao dùng ≥2 giám khảo độc lập → hội tụ; phân kỳ được chuyển đến review thủ công, không bao giờ tự lấy trung bình.

writes docs/profiles/*/eval/ · emits EVL.scored → CRE.recalibrateghi docs/profiles/*/eval/ · phát EVL.scored → CRE.recalibrate
06 · CRE

cre:post-writer

Draft platform-native content (Facebook, LinkedIn, blog…) using the refreshed profile + EVL scorecard. The skill reads the character's voice identity from docs/profiles/*/identity/writing-voice.md, selects the highest-evidence angle from the material index, and produces a draft in assets/{platform}/{YYMMDD}-{slug}/post.txt. The draft is not yet gated — it proceeds immediately to the two CRE gates.Soạn nội dung gốc cho nền tảng (Facebook, LinkedIn, blog…) dùng hồ sơ đã làm mới + scorecard EVL. Skill đọc danh tính giọng văn nhân vật từ docs/profiles/*/identity/writing-voice.md, chọn góc độ có bằng chứng cao nhất từ chỉ mục tư liệu, và tạo bản thảo trong assets/{platform}/{YYMMDD}-{slug}/post.txt. Bản thảo chưa qua cổng — tiến ngay đến hai cổng CRE.

writes assets/ draft · proceeds to gate 1ghi bản thảo assets/ · tiến đến cổng 1

The two CRE gates — fail-closedHai cổng CRE — fail-closed

Both gates run on every draft, every platform, every publish. Either gate failing stops publication entirely — no partial publish, no bypass. The gates are not advisory; they are blocking.Cả hai cổng chạy trên mọi bản thảo, mọi nền tảng, mọi lần đăng. Bất kỳ cổng nào thất bại đều dừng việc đăng hoàn toàn — không đăng một phần, không bỏ qua. Các cổng không phải tư vấn; chúng là chặn.

Gate 1Cổng 1

cre:evidence-scanner

Scans every claim in the draft against the MAT evidence index. Each claim must be traceable to an integrated source at T1–T5. Claims without a traceable source are flagged and block publication. The scanner also applies Rule 09 (confidentiality) — any claim that would require revealing a raw clinical label is flagged as a leak.Quét mọi claim trong bản thảo theo chỉ mục bằng chứng MAT. Mỗi claim phải truy nguyên được đến nguồn đã tích hợp ở T1–T5. Claim thiếu nguồn truy nguyên bị đánh dấu và chặn đăng. Scanner cũng áp dụng Rule 09 (bảo mật) — mọi claim cần tiết lộ nhãn lâm sàng thô bị đánh dấu là rò rỉ.

per-claim T1–T5 checkkiểm T1–T5 từng claim Rule 09 leak detectphát hiện rò rỉ Rule 09 fail-closedfail-closed
Gate 2Cổng 2

cre:privacy-guard

Pre-publish confidentiality scan of the assets/ draft. Checks for: PII patterns (names, dates, identifiers that could de-anonymize), raw psychiatric labels that must not appear in public content (show-don't-tell, Rule 02), and any data marked confidential in the source frontmatter. A single match blocks the entire asset — no claim-by-claim partial pass.Quét bảo mật trước khi đăng trên bản thảo assets/. Kiểm tra: mẫu PII (tên, ngày tháng, định danh có thể phi ẩn danh hóa), nhãn tâm thần thô không được xuất hiện trong nội dung công khai (thể hiện không kể, Rule 02), và bất kỳ dữ liệu nào được đánh dấu bảo mật trong frontmatter nguồn. Một kết quả khớp chặn toàn bộ asset — không có pass từng phần theo claim.

PII / de-anon scanquét PII / phi ẩn danh Rule 02 label guardbảo vệ nhãn Rule 02 fail-closedfail-closed
07 · PUBLISHED

assets/{platform}/{YYMMDD}-{slug}/

Both gates pass → the asset is published to assets/. The package convention is: post.txt (the content), image-prompts.txt (optional), images/ (optional), README.txt (provenance — which profile version, which rubric, which material batch fed this asset). The README.txt is the audit trail; it stays alongside the content forever.Cả hai cổng pass → asset được đăng vào assets/. Quy ước gói là: post.txt (nội dung), image-prompts.txt (tùy chọn), images/ (tùy chọn), README.txt (nguồn gốc — phiên bản hồ sơ nào, rubric nào, lô tư liệu nào nuôi asset này). README.txt là dấu vết kiểm toán; nó ở lại cùng nội dung mãi mãi.

emits CRE.recalibrate · asset is livephát CRE.recalibrate · asset đã đăng

Event hand-offs at a glanceBàn giao sự kiện tổng quan

EventSự kiện Emitted byPhát bởi TriggersKích hoạt Gate conditionĐiều kiện cổng
MAT.integrated mat:indexer psy:wave (PSY.refresh) contradiction-clean · coverage-adequate · CRAAP ≥ minsạch mâu thuẫn · phủ sóng đủ · CRAAP ≥ tối thiểu
PSY.refresh psy:crossref + psy:health-check evl:score + cre:post-writer crossref 10-dim pass · health-check score ≥ thresholdcrossref 10-chiều pass · điểm health-check ≥ ngưỡng
GRO.assessed gro:* psy:wave + evl:score + cre:post-writer growth data consistent · date-aligned (gro:validate)dữ liệu phát triển nhất quán · ngày tháng khớp (gro:validate)
EVL.scored evl:score cre:post-writer (recalibrate) all criteria cited · no [UNVERIFIED] blocking verdictmọi tiêu chí có trích dẫn · không có [UNVERIFIED] chặn phán quyết
CRE.recalibrate cre:evidence-scanner + cre:privacy-guard assets/ publishedassets/ đã đăng all claims cited · no PII / label leaks · both gates passmọi claim có trích dẫn · không rò rỉ PII / nhãn · cả hai cổng pass
🔄
ORC is the bus — not a content owner. orc:cascade resolves the multi-domain chain above; orc:audit verifies every declared event matches what actually ran (it exits 0 only when the event log and the cascade plan are consistent). ORC writes only to .claude/ — it never touches docs/ or assets/. Domain boundary violations are caught by platform_lib/fs_guard.py (Rule 12).ORC là bus — không phải chủ sở hữu nội dung. orc:cascade giải chuỗi đa-miền trên; orc:audit xác minh mọi sự kiện khai báo khớp với thực chạy (chỉ exit 0 khi log sự kiện và kế hoạch cascade nhất quán). ORC chỉ ghi vào .claude/ — không bao giờ đụng docs/ hay assets/. Vi phạm ranh giới miền bị bắt bởi platform_lib/fs_guard.py (Rule 12).

The GRO side edgeCạnh bên GRO

GRO (Growth) is not a linear step in the main cascade — it feeds PSY, EVL, and CRE in parallel whenever a growth assessment runs. Its output enriches the formulation (career trajectory feeds into the presenting picture), the rubric scoring (competency data feeds EVL criteria), and the content angle selection (growth milestones are high-evidence content angles). All GRO forecasts are explicitly labelled [FORECAST — NOT FACTUAL].GRO (Phát triển) không phải bước tuyến tính trong cascade chính — nó nuôi PSY, EVL, và CRE song song bất cứ khi nào đánh giá phát triển chạy. Đầu ra của nó làm giàu formulation (quỹ đạo sự nghiệp nuôi tranh bày hiện tại), chấm điểm rubric (dữ liệu năng lực nuôi tiêu chí EVL), và chọn góc độ nội dung (cột mốc phát triển là góc độ nội dung có bằng chứng cao). Mọi dự báo GRO được gắn nhãn rõ ràng [FORECAST — NOT FACTUAL].

GRO skills that feed the cascadeSkill GRO nuôi cascade
  • gro:career-pathstage mapping (Super) → PSY wave 1ánh xạ giai đoạn (Super) → PSY đợt 1
  • gro:competency-mapDreyfus gaps → EVL criteriakhoảng trống Dreyfus → tiêu chí EVL
  • gro:learning-profileKolb style → CRE anglephong cách Kolb → góc độ CRE
  • gro:mentoring-trackKram phases → relationship contentgiai đoạn Kram → nội dung quan hệ
  • gro:career-forecast[FORECAST] label requiredbắt buộc nhãn [FORECAST]
GRO boundary rulesQuy tắc ranh giới GRO

GRO does not do clinical analysis — that belongs to PSY (Rule 15 / GRO↔PSY boundary). GRO reads the profile but never writes to docs/profiles/ except under docs/profiles/*/growth/. The GRO↔PSY interface is the event GRO.assessed — GRO never calls PSY directly.GRO không phân tích lâm sàng — đó thuộc về PSY (Rule 15 / ranh giới GRO↔PSY). GRO đọc hồ sơ nhưng không bao giờ ghi vào docs/profiles/ ngoại trừ dưới docs/profiles/*/growth/. Giao diện GRO↔PSY là sự kiện GRO.assessed — GRO không bao giờ gọi PSY trực tiếp.

Honest limitsGiới hạn trung thực

⚖️
  • Scripts gather, LLM judges. The deterministic scripts may over-flag — false positives are expected and documented. The LLM does the heuristic judgment. Never delegate reasoning to scripts; never accept a script flag as a verdict without LLM review.Script thu thập, LLM phán xử. Script tất định có thể over-flag — dương tính giả được mong đợi và ghi lại. LLM thực hiện phán xét heuristic. Không bao giờ ủy thác suy luận cho script; không bao giờ chấp nhận cờ script là phán quyết mà không có review LLM.
  • Crisis flags are never cached. psy:crisis-assess is always re-run from raw material — a verdict cache hit is explicitly blocked for crisis results. A stale crisis verdict is worse than no verdict.Cờ khủng hoảng không bao giờ cache. psy:crisis-assess luôn chạy lại từ tư liệu thô — cache verdict bị chặn rõ ràng cho kết quả khủng hoảng. Phán quyết khủng hoảng cũ kỹ còn tệ hơn không có phán quyết.
  • [UNVERIFIED] is counted, never silently passed. An EVL criterion without a MAT evidence citation is reported as [UNVERIFIED] in the scorecard — it contributes to the count but does not produce a silent passing score.[UNVERIFIED] được đếm, không bao giờ pass ngầm. Tiêu chí EVL thiếu trích dẫn bằng chứng MAT được báo là [UNVERIFIED] trong scorecard — nó đóng góp vào số đếm nhưng không tạo điểm pass ngầm.
  • The e2e fixture has no real PII. e2e/synthetic-project/ is a fully synthetic 2-character corpus. It doubles as a worked example, the eval fixture, and the regression harness. It contains no real names, dates, or clinical data.Fixture e2e không có PII thật. e2e/synthetic-project/ là corpus giả lập hoàn toàn 2 nhân vật. Nó vừa là ví dụ mẫu, vừa là fixture eval, vừa là bộ regression. Không chứa tên thật, ngày tháng thật, hay dữ liệu lâm sàng thật.
5
cascade eventssự kiện cascade
2
CRE gates (both fail-closed)cổng CRE (đều fail-closed)
0
cross-domain direct writeslần ghi trực tiếp chéo miền
0
real PII in e2e fixturePII thật trong fixture e2e

FAQHỏi đáp

Why must material be integrated before PSY can run?Vì sao tư liệu phải tích hợp trước khi PSY chạy?
Premature analysis — profiling a character before the material's contradictions and coverage gaps are resolved — produces inconsistent, unreliable formulations. The MAT integration gate (mat:indexer) exists to block exactly this: PSY may not consume a source until indexer has confirmed it's contradiction-clean and coverage-adequate. Rule 11 enforces this boundary.Phân tích sớm — hồ sơ hóa nhân vật trước khi mâu thuẫn và khoảng trống phủ sóng của tư liệu được giải quyết — tạo ra các formulation không nhất quán, không đáng tin. Cổng tích hợp MAT (mat:indexer) tồn tại để chặn chính xác điều này: PSY không được tiêu thụ nguồn cho đến khi indexer xác nhận nó sạch mâu thuẫn và phủ sóng đủ. Rule 11 thực thi ranh giới này.
What happens if the evidence-scanner blocks a claim?Điều gì xảy ra nếu evidence-scanner chặn một claim?
The entire asset is blocked — not just the flagged claim. The scanner returns a list of flagged claims with their evidence gap: which source tier is needed and which claim needs revision. You revise the draft, re-run cre:evidence-scanner, and re-run cre:privacy-guard. No partial publish path exists.Toàn bộ asset bị chặn — không chỉ claim bị đánh dấu. Scanner trả về danh sách claim bị đánh dấu kèm khoảng trống bằng chứng: bậc nguồn nào cần và claim nào cần sửa. Bạn sửa bản thảo, chạy lại cre:evidence-scanner, và chạy lại cre:privacy-guard. Không có đường đăng một phần.
Can I skip EVL and go straight from PSY to CRE?Có thể bỏ EVL và đi thẳng từ PSY sang CRE không?
Yes — EVL is a side branch, not a required step in the minimal cascade. The minimal path is: MAT.integrated → psy:wave → psy:crossref → PSY.refresh → cre:post-writer → two CRE gates → publish. EVL enriches the content angle and evidence depth, but cre:post-writer can draft from the PSY profile alone. EVL.scored feeds CRE recalibration when it runs.Có — EVL là nhánh bên, không phải bước bắt buộc trong cascade tối thiểu. Đường tối thiểu là: MAT.integrated → psy:wave → psy:crossref → PSY.refresh → cre:post-writer → hai cổng CRE → đăng. EVL làm giàu góc độ nội dung và chiều sâu bằng chứng, nhưng cre:post-writer có thể soạn từ hồ sơ PSY đơn thuần. EVL.scored nuôi CRE recalibration khi nó chạy.
How does orc:audit verify the cascade actually ran?orc:audit xác minh cascade đã thực sự chạy như thế nào?
orc:audit reads the JSONL event log (appended by each skill when it completes) and compares the declared cascade plan against the events that actually fired. It exits 0 only when every declared event appears in the log with a success record. A missing event or out-of-order sequence causes a non-zero exit — blocking any dependent stage.orc:audit đọc log sự kiện JSONL (được append bởi từng skill khi hoàn thành) và so sánh kế hoạch cascade khai báo với sự kiện thực sự kích hoạt. Chỉ exit 0 khi mọi sự kiện khai báo xuất hiện trong log với bản ghi thành công. Thiếu sự kiện hoặc chuỗi sai thứ tự gây exit khác 0 — chặn mọi giai đoạn phụ thuộc.
What does CRE.recalibrate trigger downstream?CRE.recalibrate kích hoạt gì ở hạ lưu?
CRE.recalibrate signals that an asset has been published — or that a gate blocked it. Downstream: orc:event-log appends the outcome; orc:session-state updates the session domain tracker; and if EVL produced a new scorecard in the same cycle, EVL.scored can feed the next CRE draft's angle calibration. The event is the close of one cascade loop — the system is ready for the next material or the next content pass.CRE.recalibrate báo hiệu rằng một asset đã được đăng — hoặc cổng đã chặn nó. Ở hạ lưu: orc:event-log append kết quả; orc:session-state cập nhật bộ theo dõi miền phiên; và nếu EVL tạo scorecard mới trong cùng chu kỳ, EVL.scored có thể nuôi hiệu chỉnh góc độ cho bản thảo CRE kế tiếp. Sự kiện là kết thúc của một vòng cascade — hệ thống sẵn sàng cho tư liệu tiếp theo hoặc lần content pass tiếp theo.