CyberOS platform terms
BRAIN
BRAIN
The conceptual alias for the CyberOS memory module. Technically, BRAIN refers to the memory store located at
.cyberos/memory/store/ within an installed repository. The store is a local-first, append-only, cryptographically chained record of every memory operation. When documentation refers to “writing to BRAIN” or “querying BRAIN,” it means interacting with this Layer 1 memory store.SKILL.md
SKILL.md
The normative contract file for a CyberOS skill. Every skill folder contains a
SKILL.md that defines the skill’s name, description, supported invocation modes (author, audit, MCP tool, CLI), and the input/output schema. SKILL.md conforms to the Anthropic Agent Skills open standard, meaning skills authored for CyberOS are compatible with Claude, Codex, Cursor, Goose, Amp, and any other Agent Skills-compliant client.CUO — Central Unified Orchestrator
CUO — Central Unified Orchestrator
The workflow engine that routes tasks to the right persona and skill chain. CUO is a rule-based router (Phase 1, shipped) with LLM-augmented routing (Phase 2) and multi-skill chain execution (Phases 3–4) in design. CUO reads a task’s domain and intent, selects the matching persona and workflow, and dispatches it to the appropriate invoker (subprocess, LLM, or mock). Every routing decision and invocation result is emitted as a memory audit row.
ship-tasks
ship-tasks
The single CyberOS workflow that drives tasks through the 10-state lifecycle.
ship-tasks is the canonical way to move a task from backlog through ready_to_implement, implementing, gates, human_gate_1, done, and the remaining states. The workflow enforces two mandatory human-acceptance gates (HITL) and runs automated gate checks (build, lint, test, coverage) before each gate. Use the Claude plugin /ship-tasks command or cyberos-cuo execute to run it.HITL — Human-in-the-Loop
HITL — Human-in-the-Loop
The two mandatory human-acceptance gates in the
ship-tasks workflow. The first HITL gate occurs after automated gates pass and before a task is marked human_gate_1 (typically a spec review). The second occurs before final done marking. No task can transition past either gate without an explicit human approval signal — CUO cannot self-approve. The HITL model is documented in AGENTS.md and enforced in ship-tasks at the workflow level.Task
Task
A markdown file under
docs/tasks/ with YAML frontmatter defining a unit of work. Task frontmatter specifies at minimum: id, title, status, priority, module, owner, and acceptance_criteria. Tasks are the atomic unit of the CyberOS backlog — every feature, fix, and improvement is a task file. The task-author and task-audit skills produce and verify tasks conforming to the engineering-spec@1 contract.Skill
Skill
A versioned, auditable agent capability packaged as a folder with a
SKILL.md contract file. A skill may include a RUBRIC.md (for audit skills), a template.md (output template), a CHANGELOG.md, and a CONTRACT.md (inter-skill dependency contract). Skills are invoked by CUO via the Skill module’s WASM host (Rust + Wasmtime + Bun toolchain). The CyberOS skill library currently contains 100+ author/audit pairs.Persona
Persona
A named C-role in CUO — for example,
chief-technology-officer, chief-financial-officer, or chief-revenue-officer — with its own suite of workflows. Each persona folder under modules/cuo/ contains one or more workflow markdown files that define multi-skill chains for that role’s recurring responsibilities. CUO currently has 47 active personas and 221+ workflows.MMR — Merkle Mountain Range
MMR — Merkle Mountain Range
The cryptographic audit-chain structure used in memory binlogs. Every memory write appends a new leaf to the MMR, producing a Merkle root that covers all prior entries. This means any retrospective modification to a memory entry would produce a detectable root mismatch. CyberOS uses MMR to make the memory store tamper-evident. Long-term, the root is intended to anchor to Sigstore Rekor for external verifiability.
Layer 1 / Layer 2
Layer 1 / Layer 2
The two storage layers of the CyberOS memory architecture. Layer 1 is the local append-only protocol store — the
.cyberos/memory/store/ directory containing the binlog and MMR. Layer 1 is the source of truth. Layer 2 is the Rust semantic search service that indexes Layer 1 content for fast vector-similarity queries. Reads that require semantic recall go through Layer 2; all writes go directly to Layer 1.Agent
Agent
Any AI system operating under the
AGENTS.md protocol within a CyberOS-installed repository. This includes Claude (Anthropic), Codex (OpenAI), Cursor, Goose, and Amp. The AGENTS.md file at the repo root (a thin pointer to .cyberos/AGENT-ENTRY.md) defines the rules all agents must follow: memory protocol, task lifecycle, skill invocation, audit chain emission, and HITL gate behaviour. Agents are treated as equal participants in the task workflow — “agent-equal” means an agent can log activities, submit tasks, and run skills with the same permissions as a human member, subject to scope grants.Gates
Gates
Automated verification checks run before a human gate in
ship-tasks. Gates include build (does the code compile?), lint (does it pass style checks?), test (do all tests pass?), and coverage (does coverage meet the threshold?). CUO’s gate autodetect (TASK-CUO-207) supports Go, JVM, .NET, PHP, Ruby, Rust, Python, TypeScript, and Bun. Per-repo gate configuration lives in .cyberos/config.yaml. All gates must be green before the workflow advances to the next HITL gate..cyberos/
.cyberos/
The gitignored vendor folder created by
cyberos install in your repository. It contains the memory store (memory/store/), the agent entry point (AGENT-ENTRY.md), the installed version (VERSION), the runtime config (config.yaml), and the vendored skill bundles. The .cyberos/ directory is never committed to your repository — it is recreated by cyberos install and updated by cyberos version.Module acronyms
Vietnamese terms
MST — Mã số thuế
MST — Mã số thuế
Vietnamese business tax identification number issued by the General Department of Taxation (GDT). Standard format is 10 digits for the head office; branch offices append a 3-digit suffix (13 digits total). MST is required on every B2B invoice (hóa đơn) and is the primary identifier for business accounts in CRM. CyberOS validates MST against the live GDT registry on every CRM account write.
Hóa đơn
Hóa đơn
Vietnamese VAT invoice. Under Decree 123/2020/NĐ-CP, all businesses in Vietnam must issue electronic hóa đơn (hóa đơn điện tử) in the GDT-specified XML schema. CyberOS emits compliant hóa đơn via the INV module on deal close, using the
vietnam-vat-invoice skill. Standard VAT rate is 10%; reduced rate is 5% for specified goods; export rate is 0%.BHXH — Bảo hiểm xã hội
BHXH — Bảo hiểm xã hội
Social insurance (Bảo hiểm xã hội). Employee contribution is 10.5% of monthly base salary; employer contribution is 17.5%. Governed by Decree 152/2020. REW computes and reports both sides of the BHXH contribution on every payroll run.
BHYT — Bảo hiểm y tế
BHYT — Bảo hiểm y tế
Health insurance (Bảo hiểm y tế). Employee contribution is 1.5% of monthly base salary; employer contribution is 3%. Governed by Decree 152/2020. Computed alongside BHXH in REW.
BHTN — Bảo hiểm thất nghiệp
BHTN — Bảo hiểm thất nghiệp
Unemployment insurance (Bảo hiểm thất nghiệp). Employee contribution is 1% of monthly base salary; employer contribution is 1%. Governed by Labour Code 2019. Computed in REW as part of the full statutory deductions block.
PIT — Thuế thu nhập cá nhân
PIT — Thuế thu nhập cá nhân
Personal Income Tax (Thuế thu nhập cá nhân). Progressive tax rates from 5% to 35% applied to taxable income after statutory deductions (BHXH, BHYT, BHTN) and personal exemptions. REW computes PIT on each payroll run and provides a breakdown of taxable income per bracket.
VietQR
VietQR
The Napas247 open QR payment standard used by Vietnamese banks and banking apps for interbank transfers. A VietQR code encodes bank BIN, account number, transfer amount, and payment reference in the EMVCo QR format. Any Napas-connected banking app can scan and pre-fill a transfer from a VietQR code. CyberOS generates VietQR codes from CRM deals via the
vietnam-bank-transfer skill.PDPL — Personal Data Protection Law
PDPL — Personal Data Protection Law
Vietnam’s personal data protection law, enacted as Decree 13/2023/NĐ-CP (Nghị định 13/2023/NĐ-CP), effective 1 July 2023. Key obligations for CyberOS tenants include: data localisation for
vn-1 tenants (Decree 53/2022), cross-border transfer approval (Art. 38), Data Subject Access Request fulfilment (Art. 14), DPO designation for high-risk processing (Art. 28), and processing logs (Art. 17). All PDPL obligations are managed in the TEN module.Hội đồng Chuyên môn — Specialist Council
Hội đồng Chuyên môn — Specialist Council
A peer-review body of 3–5 specialist judges who evaluate Member skill promotion decisions in the LEARN module. When a Member submits evidence for a promotion (degree, certification, project record), the Specialist Council reviews the submission and votes. A majority vote is required for promotion. The council composition and voting records are stored in LEARN and linked to the Member’s HR profile.
Bằng cấp
Bằng cấp
Academic degree certificate (Bằng cấp). A formal tertiary academic credential — bachelor’s, master’s, or doctorate. In the LEARN module, bằng cấp records are one of the two primary evidence types a Member can submit for skill promotion or qualification verification.
Chứng chỉ
Chứng chỉ
Professional certification (Chứng chỉ). An industry or professional body certification — AWS certifications, CPA, PMP, and similar. In LEARN, chứng chỉ records are the second primary evidence type for skill promotion submissions, alongside bằng cấp.
Business terms
Engagement
Engagement
A client project record in the PROJ module that links a CRM deal, a rate card, a team roster, and billable hours. When an AM clicks Convert to Engagement on a won CRM deal, PROJ creates an Engagement pre-populated with the deal’s pricing, contract URL, and client account. TIME entries flow into the Engagement; INV invoices are generated from it. The Engagement is the operational unit that connects sales (CRM) to delivery (PROJ + TIME) to billing (INV).
BP — Bonus Points
BP — Bonus Points
CyberOS’s inflation-indexed compensation unit, accruing in the REW module. Bonus Points are awarded quarterly from the BP fund and accumulate in each Member’s BP ledger. The ledger accrues interest at the ACB benchmark rate (vn-acb-rate) to index against inflation. BP can be converted to cash or rolled over. BP forms the P3 (performance pay) component of the 3P compensation model.
VP — Voting Power
VP — Voting Power
A quarterly score computed in the LEARN module used for REW bonus distribution. VP rolls up contributions from PROJ (issues closed, engagement quality), TIME (billable hours, utilisation), and KB (knowledge articles authored and rated). Members with higher VP receive a larger share of the quarterly BP distribution. VP resets each quarter so recent contributions always matter.
3P — P1/P2/P3 Pay Components
3P — P1/P2/P3 Pay Components
The three-component pay model in REW: P1 (Base pay / Lương cơ bản) is the floor salary, protected by a DB CHECK constraint that prevents reduction; P2 (Allowance / Phụ cấp) covers fixed allowances such as transport, meals, and phone; P3 (Performance pay / Lương hiệu suất) is the variable quarterly component distributed from the BP fund proportional to each Member’s VP score. Total compensation = P1 + P2 + P3.