ORC
ORC is the meta-framework: it routes events between MAT, PSY, CRE, GRO, and EVL but never owns domain content. Its write-root is exclusively .claude/ — skills, session state, config, cache, the event log, and the knowledge graph. Every session starts with ORC (orc:intake), every multi-step cascade is resolved by ORC (orc:cascade), and every declared event is verified by ORC (orc:audit). ORC is the bus; it routes, it does not own the data.
ORC là meta-framework: định tuyến sự kiện giữa MAT, PSY, CRE, GRO và EVL nhưng không bao giờ sở hữu nội dung miền. Write-root của nó chỉ là .claude/ — skill, session state, config, cache, event log và đồ thị tri thức. Mỗi phiên bắt đầu bằng ORC (orc:intake), mỗi cascade nhiều bước được giải quyết bởi ORC (orc:cascade), và mỗi sự kiện khai báo được xác minh bởi ORC (orc:audit). ORC là bus; định tuyến, không sở hữu dữ liệu.
Entry skills — every session starts hereSkill nhập — mọi phiên bắt đầu ở đây
orc:bootstrap
Bootstrap project context for human-analyzer sessions. Loads character context (profiles + recent git delta + session state) and reinjects the compact-digest.json snapshot after a context compaction. Run at session start and any time the context goes stale. Quick mode (--quick) reloads config and event log only; full mode reloads all profile trees.
Bootstrap ngữ cảnh dự án cho các phiên human-analyzer. Tải ngữ cảnh nhân vật (hồ sơ + git delta gần đây + session state) và tái-inject snapshot compact-digest.json sau khi compaction ngữ cảnh. Chạy lúc bắt đầu phiên và bất kỳ khi nào ngữ cảnh trở nên cũ. Chế độ nhanh (--quick) chỉ tải lại config và event log; chế độ đầy đủ tải lại toàn bộ cây hồ sơ.
orc:intake + orc:classify
orc:intake — classify incoming work type (materials ingestion / profile update / content creation / growth analysis) and route to the optimal skill chain. Always runs first on every new task.orc:classify — classify task risk level (tiny / normal / high_risk) before content creation begins. Must run before cre:post-writer. Risk level determines ceremony: tiny tasks skip the plan gate; high-risk tasks require orc:council or orc:santa review.
orc:intake — phân loại loại việc đến (thu nhận tư liệu / cập nhật hồ sơ / tạo nội dung / phân tích tăng trưởng) và định tuyến đến chuỗi skill tối ưu. Luôn chạy đầu tiên ở mỗi nhiệm vụ mới.orc:classify — phân loại mức rủi ro nhiệm vụ (tiny / normal / high_risk) trước khi tạo nội dung. Phải chạy trước cre:post-writer. Mức rủi ro quyết định nghi lễ: nhiệm vụ tiny bỏ qua gate plan; nhiệm vụ high-risk yêu cầu review orc:council hoặc orc:santa.
The routing chainChuỗi định tuyến
Three skills resolve multi-step cascades. Together they form the bus backbone: classify → route → cascade → audit. Ba skill giải quyết cascade nhiều bước. Cùng nhau chúng tạo thành xương sống bus: phân loại → định tuyến → cascade → kiểm toán.
Route domain eventsĐịnh tuyến sự kiện miền
Given a git diff or explicit event name, resolves which downstream skills should activate. The router is the authoritative source for which framework owns a changed file; if a file's write-root is ambiguous the router flags it rather than guessing.Cho một git diff hoặc tên sự kiện tường minh, giải quyết skill nào ở downstream nên kích hoạt. Router là nguồn quyền uy xác định framework nào sở hữu một file đã thay đổi; nếu write-root của file mơ hồ thì router gắn cờ thay vì đoán.
input: diff or event nameđầu vào: diff hoặc tên sự kiệnResolve multi-domain chainGiải chuỗi đa-miền
Orchestrate multi-step event cascades across domains. Enforces ordering (MAT before PSY before CRE), checks event idempotency (same event twice must not double-process), and clears pending_events in session state before marking a session complete. Cannot proceed if any pending event is unresolved.Điều phối cascade sự kiện nhiều bước trên các miền. Ép thứ tự (MAT trước PSY trước CRE), kiểm idempotency sự kiện (cùng sự kiện hai lần không được xử lý gấp đôi) và xóa pending_events trong session state trước khi đánh dấu phiên hoàn thành. Không thể tiếp tục nếu có sự kiện đang chờ chưa giải quyết.
Verify event consistencyXác minh nhất quán sự kiện
Audit cross-domain event consistency — verify all declared events match what actually ran. Reads the event-log.jsonl and compares declared vs actual workflow. Flags divergences without auto-correcting. The audit token below shows a real run.Kiểm toán nhất quán sự kiện liên miền — xác minh tất cả sự kiện khai báo khớp với thực chạy. Đọc event-log.jsonl và so sánh workflow khai báo vs thực tế. Gắn cờ phân kỳ mà không tự sửa. Token audit bên dưới hiển thị một lần chạy thật.
Live audit output — declared vs actualĐầu ra audit trực tiếp — khai báo vs thực tế
orc:audit — every declared event verified against event-log.jsonlorc:audit — mỗi sự kiện khai báo được xác minh với event-log.jsonl
The audit reads what ORC declared should run and what orc:event-log recorded actually ran. Divergences are flagged — never silently resolved. real output
Audit đọc những gì ORC khai báo nên chạy và những gì orc:event-log ghi lại đã thực sự chạy. Phân kỳ được gắn cờ — không bao giờ giải quyết im lặng. đầu ra thật
✓ Skill count assertion PASS: 68 framework skills (matches CLAUDE.md)
Routable events: 15 | Loggable: 34
Hard violations (C1-C4): 0
✓ Referential integrity holds — routable ⊆ loggable, emits/path-map ⊆ routable, declared emits loggable
Doc-sync advisories (C5-C6): 4
· [C6] CRE.blocked: rules-12 conceptual convention, not wired as loggable/routable (informational)
· [C6] MAT.analyzed: rules-12 conceptual convention, not wired as loggable/routable (informational)
The audit never auto-corrects. A divergence between declared and actual is surfaced to the user for judgment — the LLM judges, scripts only gather. Removing a divergence from the log without resolving its root cause is a Rule 12 violation. Audit không bao giờ tự sửa. Phân kỳ giữa khai báo và thực tế được đưa lên cho người dùng phán xử — LLM phán xử, script chỉ thu thập. Xóa phân kỳ khỏi log mà không giải quyết nguyên nhân gốc là vi phạm Rule 12.
Persistence — session state & event logLưu trữ — session state & event log
orc:session-state
Tracks multi-step workflow state in .claude/session-state/state.json — exclusively owned by ORC. Key fields: active_character, current_phase, pending_events, materials_in_flight, last_psy_refresh, open_contradictions, session_mode. State transitions: idle → mat-ingestion → psy-refresh → cre-recalibrate → idle. ORC must clear pending_events before marking a session complete. The --compact-digest flag snapshots a bounded per-framework delta; orc:bootstrap re-injects it on resume after compaction.
Theo dõi trạng thái workflow nhiều bước trong .claude/session-state/state.json — chỉ ORC sở hữu. Trường chính: active_character, current_phase, pending_events, materials_in_flight, last_psy_refresh, open_contradictions, session_mode. Chuyển trạng thái: idle → mat-ingestion → psy-refresh → cre-recalibrate → idle. ORC phải xóa pending_events trước khi đánh dấu phiên hoàn thành. Flag --compact-digest snapshot delta giới hạn mỗi framework; orc:bootstrap tái-inject khi tiếp tục sau compaction.
orc:event-log — JSONL append-only
Persistent event log at .claude/session-state/event-log.jsonl. Every core framework event is appended via orc:event-log --append. Each record carries: timestamp, event, source, character, reason. Query examples: orc:event-log --query --event-type PSY.refresh --since 2026-05-01. The log never rotates — it is the authoritative audit trail. orc:audit reads it to verify declared vs actual. Scripts: orc-event-log/scripts/append-event-to-log.py and query-event-log-with-filters.py.
Event log lưu trữ tại .claude/session-state/event-log.jsonl. Mỗi sự kiện framework cốt lõi được append qua orc:event-log --append. Mỗi record mang: timestamp, event, source, character, reason. Ví dụ query: orc:event-log --query --event-type PSY.refresh --since 2026-05-01. Log không bao giờ xoay vòng — đây là vết audit quyền uy. orc:audit đọc nó để xác minh khai báo vs thực tế. Script: orc-event-log/scripts/append-event-to-log.py và query-event-log-with-filters.py.
Decision tooling — council, santa, decisionsCông cụ quyết định — council, santa, decisions
orc:council — 4-voice deliberationthảo luận 4 giọng
A 4-voice decision framework for ambiguous situations. Each voice takes a distinct epistemic stance — analyst, critic, integrator, advocate — and deliberates independently before synthesis. Used for high-risk content decisions, ethical edge cases, and multi-character arc conflicts. Council outputs are recorded via orc:decisions. Input is isolated per voice so no voice anchors on another's framing (prevents groupthink).
Khung quyết định 4 giọng cho các tình huống mơ hồ. Mỗi giọng giữ lập trường nhận thức riêng — nhà phân tích, nhà phê bình, nhà tích hợp, người ủng hộ — và thảo luận độc lập trước khi tổng hợp. Dùng cho các quyết định nội dung rủi ro cao, trường hợp biên đạo đức và xung đột arc đa nhân vật. Đầu ra council được ghi lại qua orc:decisions. Đầu vào được cô lập mỗi giọng để không giọng nào neo vào đóng khung của giọng khác (ngăn tư duy nhóm).
orc:santa — dual-reviewer gategate hai reviewer
Dual-reviewer quality gate for high-risk changes. Two reviewers (Santa = approves / Anti-Santa = challenges) independently assess the change and must reach consensus before it proceeds. Used pre-commit on profile changes that touch multiple characters or crisis-sensitive sections. Input isolation prevents anchor bias — Anti-Santa never sees Santa's verdict first. Gate chất lượng hai reviewer cho các thay đổi rủi ro cao. Hai reviewer (Santa = chấp thuận / Anti-Santa = thách thức) đánh giá độc lập thay đổi và phải đạt đồng thuận trước khi tiếp tục. Dùng trước commit trên các thay đổi hồ sơ chạm nhiều nhân vật hoặc các mục liên quan đến khủng hoảng. Cô lập đầu vào ngăn thiên kiến neo — Anti-Santa không bao giờ thấy phán quyết của Santa trước.
orc:decisions
Record and retrieve character arc decisions — append-only log of meaningful choices made about a character's trajectory, content arc, or clinical interpretation. Each decision entry carries rationale, evidence basis, and the skills/events that informed it. Queried during orc:council to surface prior art before deliberating the same question twice.
Ghi lại và tra cứu các quyết định arc nhân vật — log chỉ-append của các lựa chọn có ý nghĩa về quỹ đạo, arc nội dung hoặc diễn giải lâm sàng của nhân vật. Mỗi mục quyết định mang lý do, cơ sở bằng chứng và các skill/sự kiện đã thông tin. Được truy vấn trong orc:council để đưa ra tiền lệ trước khi thảo luận cùng câu hỏi lần thứ hai.
orc:graph
Search the character-corpus knowledge graph — a plain markdown-derived adjacency structure under docs/graph/ (PSY owns graph writes; ORC queries read-only). Edges represent documented relationships between characters, events, and clinical constructs. orc:graph answers questions like "what is the documented relationship between character A and character B in the grief arc?" without reading entire profile trees. Governed by Rule 16.
Tìm kiếm đồ thị tri thức corpus nhân vật — cấu trúc adjacency thuần markdown được dẫn xuất dưới docs/graph/ (PSY sở hữu ghi đồ thị; ORC chỉ-đọc khi truy vấn). Các cạnh đại diện cho các mối quan hệ được tài liệu hóa giữa nhân vật, sự kiện và các cấu trúc lâm sàng. orc:graph trả lời các câu hỏi như "mối quan hệ được tài liệu hóa giữa nhân vật A và nhân vật B trong arc đau buồn là gì?" mà không đọc toàn bộ cây hồ sơ. Được điều chỉnh bởi Rule 16.
The memory loop — compounding, dream, observe, agent-memoryVòng bộ nhớ — compounding, dream, observe, agent-memory
orc:compounding — extract durable learnings after content or profile work. Captures patterns that compound across sessions: what voice choices worked on which platform, which clinical refs surfaced most often, which evidence gaps recur. Feeds orc:dream for full consolidation.orc:dream — periodic consolidation of character insights and storytelling patterns across all sessions. Synthesises compounding extracts into durable principles. Run at natural breakpoints (end of major arc, after multiple sessions on same character).orc:observe — emit a cross-framework observation signal (passive telemetry). Complemented by the automatic observe-framework-signal.cjs hook (PostToolUse on Edit|Write) which appends a deterministic {fw}-touched signal to observations.jsonl. Observations are passive — they never trip a cascade.orc:agent-memory — persistent memory for CK-domain agents (psychologist, content-strategist, growth-analyst). Agents load their memory at the start of a session and update it at the end; memory never lives in the session context alone.
orc:compounding — trích xuất các học hỏi bền vững sau công việc nội dung hoặc hồ sơ. Nắm bắt các mô hình tích lũy qua các phiên: lựa chọn giọng nào hoạt động trên nền tảng nào, ref lâm sàng nào xuất hiện thường xuyên nhất, khoảng trống bằng chứng nào tái phát. Nuôi orc:dream để tổng hợp đầy đủ.orc:dream — tổng hợp định kỳ các insight nhân vật và mô hình kể chuyện qua tất cả phiên. Tổng hợp các trích xuất compounding thành các nguyên tắc bền vững. Chạy ở các điểm giao cắt tự nhiên (kết thúc arc lớn, sau nhiều phiên về cùng nhân vật).orc:observe — phát tín hiệu quan sát liên framework (telemetry thụ động). Được bổ sung bởi hook tự động observe-framework-signal.cjs (PostToolUse trên Edit|Write) append tín hiệu {fw}-touched tất định vào observations.jsonl. Quan sát là thụ động — không bao giờ kích hoạt cascade.orc:agent-memory — bộ nhớ liên tục cho các agent CK-domain (psychologist, content-strategist, growth-analyst). Agent tải bộ nhớ lúc bắt đầu phiên và cập nhật lúc kết thúc; bộ nhớ không bao giờ chỉ tồn tại trong ngữ cảnh phiên.
ORC is the bus — not a domain (Rule 12)ORC là bus — không phải miền (Rule 12)
What ORC writes toORC ghi vào đâu
Exclusively .claude/ — skills, session-state, config, cache. ORC never writes to docs/profiles/, docs/materials/, assets/, or docs/graph/. Those belong to domain frameworks. ORC reads everything for orchestration; it edits nothing outside its write-root. A cross-boundary write from ORC is a Rule 12 violation and a bug — not a shortcut.
Chỉ .claude/ — skill, session-state, config, cache. ORC không bao giờ ghi vào docs/profiles/, docs/materials/, assets/ hay docs/graph/. Những thứ đó thuộc về các framework miền. ORC đọc mọi thứ để điều phối; không chỉnh sửa gì ngoài write-root của mình. Một lần ghi qua ranh giới từ ORC là vi phạm Rule 12 và một lỗi — không phải phím tắt.
What ORC routes (never owns)ORC định tuyến gì (không bao giờ sở hữu)
Materials → MAT. Profiles → PSY. Assets → CRE. Growth files → GRO. Rubric scorecards → EVL. The knowledge graph is written by PSY (docs/graph/) and queried read-only by ORC (orc:graph). Domain boundaries are the single source of truth for per-domain write roots — the platform_lib/fs_guard write-jail derives its allowed roots from exactly these rows. If a file's ownership is unclear, orc:domain-router flags it — never guesses.
Tư liệu → MAT. Hồ sơ → PSY. Asset → CRE. File tăng trưởng → GRO. Scorecard rubric → EVL. Đồ thị tri thức được ghi bởi PSY (docs/graph/) và được truy vấn chỉ-đọc bởi ORC (orc:graph). Ranh giới miền là nguồn sự thật duy nhất cho write-root mỗi miền — write-jail platform_lib/fs_guard dẫn xuất các root được phép từ chính xác những hàng này. Nếu quyền sở hữu file chưa rõ, orc:domain-router gắn cờ — không bao giờ đoán.
Two automatic project hooksHai hook dự án tự động
Two project-authored hooks run automatically — neither depends on the CK CLI (ck). Both fail-open: an error never blocks a tool. They record deterministic baseline telemetry that orc:observe and orc:session-state can read.
Hai hook do dự án tạo chạy tự động — không cái nào phụ thuộc vào CK CLI (ck). Cả hai fail-open: một lỗi không bao giờ chặn một tool. Chúng ghi telemetry baseline tất định mà orc:observe và orc:session-state có thể đọc.
{fw}-touched signal to observations.jsonl. Passive telemetry only — never trips a cascade. Manual entry: orc:observe (semantic signals beyond what the hook detects). Controlled by hooks.observeFrameworkSignal in framework-config.json (default on).
Ánh xạ đường path đã chỉnh sửa đến framework của nó, append tín hiệu {fw}-touched tất định vào observations.jsonl. Chỉ telemetry thụ động — không bao giờ kích cascade. Mục nhập thủ công: orc:observe (tín hiệu ngữ nghĩa ngoài những gì hook phát hiện). Kiểm soát bởi hooks.observeFrameworkSignal trong framework-config.json (mặc định bật).
compact-digest.json before context is compacted. orc:bootstrap re-injects this snapshot on resume so the new context window knows what changed. Controlled by hooks.compactDigest (default on). Manual entry: orc:session-state --compact-digest.
Snapshot một delta giới hạn mỗi framework vào compact-digest.json trước khi ngữ cảnh bị compact. orc:bootstrap tái-inject snapshot này khi tiếp tục để cửa sổ ngữ cảnh mới biết điều gì đã thay đổi. Kiểm soát bởi hooks.compactDigest (mặc định bật). Mục nhập thủ công: orc:session-state --compact-digest.
observations.jsonl is passive telemetry — it never drives a cascade. Domain events (the framework streams) drive the cascade. The hook guarantees a deterministic baseline trail; orc:observe adds LLM-judged signals on top.
observations.jsonl là telemetry thụ động — không bao giờ điều khiển cascade. Sự kiện miền (các luồng framework) điều khiển cascade. Hook đảm bảo một vết baseline tất định; orc:observe thêm các tín hiệu do LLM phán xử lên trên.
All 17 ORC skillsToàn bộ 17 skill ORC
Entry & classificationNhập & phân loại
orc:bootstrap · orc:intake · orc:classifyorc:bootstrap · orc:intake · orc:classify
Start every session. Classify work type. Determine risk level before any content gate. The trilogy that sets up all downstream routing.Bắt đầu mỗi phiên. Phân loại loại việc. Xác định mức rủi ro trước mọi content gate. Bộ ba thiết lập tất cả định tuyến downstream.
Routing & cascadeĐịnh tuyến & cascade
orc:domain-router · orc:cascade · orc:auditorc:domain-router · orc:cascade · orc:audit
The bus backbone. Route events to domains, resolve multi-step chains, audit declared vs actual. The audit output is injected via <!--ORC_AUDIT-->.Xương sống bus. Định tuyến sự kiện đến miền, giải chuỗi nhiều bước, kiểm toán khai báo vs thực tế. Đầu ra audit được inject qua <!--ORC_AUDIT-->.
PersistenceLưu trữ
orc:session-state · orc:event-logorc:session-state · orc:event-log
Session workflow state (JSON) + JSONL append-only event trail. Together they make multi-session workflows resumable and auditable.Trạng thái workflow phiên (JSON) + vết sự kiện JSONL chỉ-append. Cùng nhau chúng làm cho các workflow nhiều phiên có thể tiếp tục và kiểm toán.
Decision toolingCông cụ quyết định
orc:council · orc:santa · orc:decisionsorc:council · orc:santa · orc:decisions
4-voice deliberation, dual-reviewer gate, and append-only decision log. Input-isolated to prevent anchor bias. Council and santa outputs always flow into decisions.Thảo luận 4 giọng, gate hai reviewer và log quyết định chỉ-append. Cô lập đầu vào để ngăn thiên kiến neo. Đầu ra council và santa luôn đổ vào decisions.
Memory loopVòng bộ nhớ
orc:compounding · orc:dream · orc:observe · orc:agent-memoryorc:compounding · orc:dream · orc:observe · orc:agent-memory
Extract durable learnings → consolidate across sessions → record passive observations → persist agent-specific memory across conversations.Trích xuất học hỏi bền vững → tổng hợp qua các phiên → ghi quan sát thụ động → lưu bộ nhớ theo agent qua các cuộc trò chuyện.
Knowledge graph + stocktakeĐồ thị tri thức + stocktake
orc:graph · orc:skill-stocktakeorc:graph · orc:skill-stocktake
Query the character-corpus adjacency graph (read-only; PSY owns writes). Audit the project skill catalog — quick scan (counts per framework vs declared) or deep scan (per-skill conformance). The SKILL_STOCKTAKE token on the pipeline page shows a real run.Truy vấn đồ thị adjacency corpus nhân vật (chỉ-đọc; PSY sở hữu ghi). Kiểm toán danh mục skill dự án — quick scan (số lượng mỗi framework vs khai báo) hoặc deep scan (conformance mỗi skill). Token SKILL_STOCKTAKE trên trang pipeline hiển thị một lần chạy thật.
Four workflow tracks — ORC entry, domain executionBốn workflow track — ORC nhập, miền thực thi
orc:cascade resolves which tracks fire and in what order. Three inter-track quality gates enforce dependencies: MAT→PSY (integration gate), PSY→CRE (profile freshness gate), CRE→Publish (privacy + voice gate). A gate failure STOPS the chain and surfaces to the user — ORC never silently advances past a failed gate.
orc:cascade giải quyết track nào bắn và theo thứ tự nào. Ba gate chất lượng liên-track ép các phụ thuộc: MAT→PSY (integration gate), PSY→CRE (profile freshness gate), CRE→Publish (privacy + voice gate). Lỗi gate DỪNG chuỗi và đưa lên cho người dùng — ORC không bao giờ tiến qua một gate đã fail im lặng.
The full pipelinePipeline đầy đủ
MAT → PSY → EVL → CRE with all ORC-orchestrated gates and cascade edges visualised end-to-end.MAT → PSY → EVL → CRE với tất cả gate do ORC điều phối và các cạnh cascade được trực quan hóa end-to-end.
SubagentsSubagent
The 20 domain subagents ORC coordinates — psychologist, content-strategist, growth-analyst and more. Input-isolated for council/santa reviews.20 domain subagent mà ORC điều phối — psychologist, content-strategist, growth-analyst và nhiều hơn. Cô lập đầu vào cho các review council/santa.
Full skill catalogDanh mục skill đầy đủ
All 17 ORC skills with trigger keywords, routing table entries, and GUIDE links.Toàn bộ 17 skill ORC với từ khóa trigger, mục bảng định tuyến và liên kết GUIDE.
Architecture & domain boundariesKiến trúc & ranh giới miền
The write-root table, fs_guard jail, and how the toolkit ships with no character corpus.Bảng write-root, write-jail fs_guard và cách toolkit phân phối không corpus nhân vật.