SubagentsSubagent
Skills don't execute everything inline — they deploy specialized subagents, each receiving only the context it needs and writing only to files it owns. 20 of them: 7 framework-domain agents that ship inside the pack, plus 13 dev-engineer agents used during active development. Input isolation is structural — by design, no agent sees another's output within the same review pass.Skill không chạy hết mọi thứ inline — chúng triển khai subagent chuyên biệt, mỗi cái chỉ nhận context cần thiết và chỉ ghi vào file nó sở hữu. 20 agent: 7 agent domain-framework ship cùng gói, cộng 13 agent dev-engineer dùng trong phát triển chủ động. Cô lập đầu vào là cấu trúc — theo thiết kế, không agent nào thấy đầu ra của agent khác trong cùng lượt review.
Skill vs subagentSkill vs subagent
A skill is the workflowSkill là quy trình
Prose guidance that orchestrates a task — it decides when to spawn an agent, what to hand it, and how to merge its findings back into the session.Hướng dẫn prose điều phối một task — nó quyết khi nào sinh agent, trao gì, và gộp phát hiện lại vào phiên.
An agent is the specialistAgent là chuyên gia
A focused worker with a sharp remit, isolated context, and strict file-ownership. It returns a report; the controlling session holds merge and approval decisions.Thợ tập trung với phạm vi sắc, context cách ly, và quyền sở hữu file nghiêm. Nó trả về báo cáo; phiên điều khiển giữ quyền gộp và duyệt.
7 framework-domain agents (shipped in the pack)7 agent domain-framework (ship trong gói)
These are listed in pack.manifest.yaml and exported with the public toolkit. Each owns exactly one domain's data and communicates via events — no cross-domain writes.Các agent này được liệt kê trong pack.manifest.yaml và xuất cùng bộ toolkit công khai. Mỗi agent sở hữu đúng một miền dữ liệu và giao tiếp qua sự kiện — không ghi chéo miền.
psychologist
PSY domain specialist — clinical profiling, 5P formulation, defense mechanisms, attachment styles, crisis assessment. Invoked by psy:wave, psy:crisis-assess, psy:hypothesis.Chuyên gia miền PSY — hồ sơ lâm sàng, formulation 5P, cơ chế phòng vệ, kiểu gắn bó, đánh giá khủng hoảng. Gọi bởi psy:wave, psy:crisis-assess, psy:hypothesis.
material-analyst
MAT domain specialist — evidence ingestion, CRAAP scoring, tier T1–T5 classification, integration gate. Invoked by mat:loader and mat:indexer.Chuyên gia miền MAT — thu nhận bằng chứng, chấm CRAAP, phân bậc T1–T5, cổng tích hợp. Gọi bởi mat:loader và mat:indexer.
content-strategist
CRE domain specialist — platform content creation, voice consistency, evidence-tier gating, privacy guard before publish. Invoked by cre:post-writer, cre:multiplatform.Chuyên gia miền CRE — tạo nội dung gốc nền tảng, nhất quán giọng, gate bậc bằng chứng, bảo mật trước đăng. Gọi bởi cre:post-writer, cre:multiplatform.
growth-analyst
GRO domain specialist — career trajectory analysis, competency mapping, learning-profile assessment, mentoring documentation. Writes only to docs/profiles/*/growth/.Chuyên gia miền GRO — phân tích quỹ đạo sự nghiệp, lập bản đồ năng lực, đánh giá hồ sơ học tập, ghi chép cố vấn. Chỉ ghi vào docs/profiles/*/growth/.
cross-validator
Cross-domain validator — multi-character consistency, timeline sync, inter-character relationship validation. Writes only to plans/reports/. Never edits profile files directly.Validator đa-miền — nhất quán nhiều nhân vật, đồng bộ timeline, kiểm quan hệ liên-nhân-vật. Chỉ ghi vào plans/reports/. Không bao giờ sửa trực tiếp file hồ sơ.
profile-manager
Profile CRUD — new character scaffolding, 25-file schema health checks, profile comparisons, and status reports. Invoked by orc:bootstrap.CRUD hồ sơ — dàn giáo nhân vật mới, kiểm sức khỏe schema 25-file, so sánh hồ sơ, báo cáo trạng thái. Gọi bởi orc:bootstrap.
evl-rubric-importer
Maps an external evaluation framework (psychometric instrument, casting brief, competency model) onto the canonical EVL rubric schema. Proposes a mapping — never writes files, never invents weights. Invoked by evl:rubric-import.Ánh xạ framework đánh giá bên ngoài (công cụ đo lường tâm lý, hồ sơ casting, mô hình năng lực) lên schema rubric EVL chuẩn. Đề xuất ánh xạ — không bao giờ ghi file, không tạo ra trọng số. Gọi bởi evl:rubric-import.
13 dev-engineer agents (development toolkit)13 agent dev-engineer (bộ công cụ phát triển)
These are not shipped in the distribution pack — they are the engineering layer used when building and maintaining the framework itself. They follow strict file-ownership rules defined in task descriptions.Các agent này không ship trong gói phân phối — chúng là lớp kỹ thuật dùng khi xây và bảo trì bản thân framework. Chúng tuân theo quy tắc sở hữu file nghiêm được định nghĩa trong mô tả task.
Plan & researchLập kế hoạch & nghiên cứu
planner
Researches and writes a comprehensive, phased implementation plan. Spawns researcher subagents in parallel for each topic domain.Nghiên cứu và viết kế hoạch triển khai đầy đủ, chia phase. Sinh researcher song song theo từng miền.
researcher
Surveys multiple sources, weighs evidence, and returns a ranked, cited research report. Often run in parallel by planner.Khảo nhiều nguồn, cân bằng chứng, trả về báo cáo nghiên cứu xếp hạng có trích dẫn. Thường chạy song song bởi planner.
brainstormer
Explores solution space and debates architectural trade-offs with honest caveats. Invoked for open-ended design questions.Khám phá không gian giải pháp và tranh luận đánh đổi kiến trúc với cảnh báo trung thực. Gọi cho câu hỏi thiết kế mở.
Build, verify & maintainXây, kiểm & bảo trì
fullstack-developer
Executes implementation phases from parallel plans with strict file-ownership boundaries. Handles backend, frontend, and infra tasks.Thực thi các phase triển khai từ plan song song với ranh giới sở hữu file nghiêm. Xử lý backend, frontend, và infra.
debugger
Investigates a failure to its root cause — logs, system behavior, performance — before any fix attempt.Điều tra lỗi đến tận gốc — log, hành vi hệ thống, hiệu năng — trước mọi lần thử sửa.
code-reviewer
Comprehensive review with scout-based edge-case detection — bugs, regressions, security. Fires after every implementation pass.Review toàn diện với dò edge-case kiểu scout — bug, regression, bảo mật. Kích hoạt sau mỗi lượt implement.
tester
Validates through unit / integration tests, coverage, and error-handling checks. Run before any push; failing tests are never skipped.Validate qua test unit / integration, coverage, và kiểm xử-lý-lỗi. Chạy trước mọi push; test thất bại không bao giờ bỏ qua.
code-simplifier
Refines recently-changed code for clarity and consistency while preserving every behavior. A distinct simplification pass after implementation.Tinh chỉnh code vừa đổi cho rõ và nhất quán mà giữ nguyên mọi hành vi. Lượt rút gọn riêng biệt sau implement.
docs-manager
Manages docs/ — codebase-summary, scripts-infrastructure, architecture — keeping documentation in sync after code changes.Quản lý docs/ — codebase-summary, scripts-infrastructure, architecture — giữ tài liệu đồng bộ sau thay đổi code.
project-manager
Tracks progress against the plan, consolidates agent reports, and surfaces status at milestone boundaries.Theo dõi tiến độ theo plan, gộp báo cáo agent, và hiển thị trạng thái tại các mốc milestone.
git-manager
Stages, commits, and pushes with conventional commits. Never commits .env, credentials, or corpus. Pre-commit secret scan is mandatory.Stage, commit, push với conventional commit. Không bao giờ commit .env, credentials, hay corpus. Quét secret trước commit là bắt buộc.
journal-writer
Documents technical decisions and post-mortems with deliberate brutal-honesty candor — fixed independent of session voice level.Ghi quyết định kỹ thuật và post-mortem với độ thẳng tàn nhẫn có chủ đích — cố định độc lập với cấp giọng phiên.
Anti-anchoring: structural input isolationChống neo: cô lập đầu vào cấu trúc
The most dangerous failure mode in multi-agent review is anchoring — where one agent's verdict primes the next. Two ORC skills enforce structural prevention rather than relying on prompt instructions.Lỗi nguy hiểm nhất trong review đa-agent là neo — khi phán quyết của agent này dẫn dắt agent kế. Hai skill ORC ép ngăn chặn cấu trúc thay vì dựa vào chỉ dẫn prompt.
orc:council — 4-voice framework
Frames a decision through four independent voices (Analyst · Devil's Advocate · Pragmatist · Synthesizer) that each receive only the raw question and original evidence — never each other's output. The Synthesizer reads all four only at the merge step. This prevents a single confident voice from anchoring the result.Đặt khung quyết định qua bốn giọng độc lập (Phân tích · Phản biện · Thực dụng · Tổng hợp) mỗi cái chỉ nhận câu hỏi thô và bằng chứng gốc — không bao giờ thấy đầu ra của nhau. Tổng hợp đọc cả bốn chỉ ở bước gộp. Điều này ngăn một giọng tự tin đơn neo kết quả.
orc:santa — dual-reviewer gate
Runs two independent reviewers (Maker · Checker) in sequence: the Maker drafts a score; the Checker sees only the original artefact and pre-check criteria — never the Maker's score. Divergence above a threshold escalates to the user. The pattern is directly analogous to a two-person rule for high-stakes decisions.Chạy hai reviewer độc lập (Người làm · Người kiểm) theo thứ tự: Người làm phác điểm; Người kiểm chỉ thấy artefact gốc và tiêu chí kiểm trước — không bao giờ thấy điểm của Người làm. Phân kỳ vượt ngưỡng thì leo thang lên người dùng. Mẫu này tương tự trực tiếp quy tắc hai người cho quyết định quan trọng.
Per-agent persistent memory: orc:agent-memoryBộ nhớ lâu dài theo agent: orc:agent-memory
Each agent accumulates calibration memory across sessions — not per-session scratchpad, but cross-session learnings stored in atomic JSONL via instinct_store.py. When an agent is deployed, orc:agent-memory loads its prior findings and feeds them as calibrated priors, preventing the same reasoning from being re-derived from scratch every invocation.Mỗi agent tích lũy bộ nhớ hiệu chỉnh xuyên phiên — không phải nháp theo phiên, mà là học từ nhiều phiên lưu dạng JSONL atomic qua instinct_store.py. Khi agent được triển khai, orc:agent-memory nạp các phát hiện trước và đưa vào như prior đã hiệu chỉnh, ngăn cùng một lập luận phải suy lại từ đầu mỗi lần gọi.
- Extracts session learnings → memory after each session.Trích học phiên → bộ nhớ sau mỗi phiên.
- Feeds
orc:dreamfor periodic consolidation.Cung cấp choorc:dreamđể hợp nhất định kỳ.
- Loads calibrated priors on spawn.Nạp prior đã hiệu chỉnh khi sinh.
- Confidence-scored JSONL via
instinct_store.py.JSONL chấm độ tự tin quainstinct_store.py.
- Periodic merge of compounded learnings.Gộp định kỳ các học đã cộng dồn.
- Prunes stale or superseded entries.Tỉa các mục lỗi thời hoặc đã thay thế.
Do framework agents change profile files on their own?Agent framework có tự sửa file hồ sơ không?
docs/profiles/*/ for PSY, docs/profiles/*/growth/ for GRO. cross-validator writes only to plans/reports/. No agent writes cross-domain. The event bus carries signals; direct cross-domain writes are blocked by Rule 12.Agent domain (psychologist, growth-analyst, …) chỉ ghi vào write-root của framework mình — docs/profiles/*/ cho PSY, docs/profiles/*/growth/ cho GRO. cross-validator chỉ ghi vào plans/reports/. Không agent nào ghi chéo miền. Event bus mang tín hiệu; ghi chéo miền trực tiếp bị chặn bởi Rule 12.Why is input isolation structural rather than prompt-based?Tại sao cô lập đầu vào là cấu trúc thay vì dựa vào prompt?
orc:council and orc:santa enforce this by withholding intermediate results until all independent passes complete.Chỉ dẫn prompt có thể bị ghi đè bởi context đủ chi tiết rỉ vào system prompt. Cô lập cấu trúc — khi đầu ra của agent trước vật lý vắng mặt trong cửa sổ context của agent kế — không thể bị "quên." orc:council và orc:santa ép điều này bằng cách giữ lại kết quả trung gian cho đến khi tất cả lượt độc lập hoàn thành.Which agents ship in the public distribution pack?Agent nào ship trong gói phân phối công khai?
pack.manifest.yaml: psychologist, material-analyst, content-strategist, growth-analyst, cross-validator, profile-manager, evl-rubric-importer. Dev-engineer agents (planner, researcher, tester, etc.) are development tools — they are not part of the character toolkit and are excluded from the pack.7 agent domain-framework liệt kê trong pack.manifest.yaml: psychologist, material-analyst, content-strategist, growth-analyst, cross-validator, profile-manager, evl-rubric-importer. Agent dev-engineer (planner, researcher, tester, …) là công cụ phát triển — chúng không phải bộ toolkit nhân vật và bị loại khỏi gói.