{"id":"d804c083-aa2c-4ae4-91db-338cac3f45b8","slug":"forge-os","kind":"mcp","name":"forge-os","summary":"The open-source control plane for AI agents — skill routing, context governance, trustworthy execution, evidence, security, and multi-agent orchestration.","owner":"Nolane-x","repoUrl":"https://github.com/Nolane-x/forge-os","license":"MIT","licenseTier":"permissive","trust":"community","stars":10,"match":null,"fewStars":false,"format":"mcp","createdAt":"2026-07-26T03:06:55.000Z","addedAt":"2026-10-14T06:09:29.532Z","logoUrl":"https://avatars.githubusercontent.com/u/278117157?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools","memory-knowledge"],"tags":["agent-orchestration","ai-agents","ai-control-plane","developer-tools","developer-tools-","developer-tools-ai-agent","javascript","javascript-project"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-20T19:18:58.558Z","sample":false,"url":"https://conduits.dev/tools/forge-os","language":"JavaScript","transports":["stdio"],"install":{"npm":"forge-os"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"<p align=\"center\">\n  <img src=\"assets/forgeos-v06-hero.svg\" alt=\"ForgeOS v0.6 — Deterministic Skill Intelligence OS\" width=\"100%\">\n</p>\n\n<p align=\"center\">\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-22c55e?style=for-the-badge\" alt=\"MIT License\"></a>\n  <a href=\"CHANGELOG.md\"><img src=\"https://img.shields.io/badge/release-v0.6.1-a78bfa?style=for-the-badge\" alt=\"ForgeOS v0.6.1\"></a>\n  <img src=\"https://img.shields.io/badge/kernel-128_techniques-63e6ff?style=for-the-badge\" alt=\"128 kernel techniques\">\n  <img src=\"https://img.shields.io/badge/MCP-60_tools-f97316?style=for-the-badge\" alt=\"60 MCP tools\">\n  <img src=\"https://img.shields.io/badge/tests-release--gated-22c55e?style=for-the-badge\" alt=\"Release-gated verification\">\n</p>\n\n<p align=\"center\"><img src=\"assets/forgeos-mark.svg\" alt=\"ForgeOS mark\" width=\"92\"></p>\n<h1 align=\"center\">ForgeOS</h1>\n<p align=\"center\"><strong>Skill Intelligence OS and Trust Control Plane for AI agents.</strong></p>\n<p align=\"center\">ForgeOS decides <strong>which skill may run</strong>, <strong>which context may enter</strong>, <strong>which steps must be deterministic</strong>, and <strong>which evidence is strong enough to accept completion</strong>.</p>\n\n<p align=\"center\">\n  <a href=\"#five-minute-path\">5-minute path</a> ·\n  <a href=\"#how-forgeos-works\">How it works</a> ·\n  <a href=\"#ecosystem-comparison\">Ecosystem comparison</a> ·\n  <a href=\"#for-developers\">For developers</a> ·\n  <a href=\"#for-experts-and-researchers\">For experts</a> ·\n  <a href=\"README-vn.md\">Tiếng Việt</a> ·\n  <a href=\"#languages\">22 translations</a>\n</p>\n\n---\n\n## Why ForgeOS exists\n\nAn agent does not become reliable because it has more prompts, more tools, or a longer context window.\n\nIt becomes reliable when the system can answer six questions:\n\n1. **What exact outcome is required?**\n2. **Which technique is appropriate—and which similar techniques are wrong here?**\n3. **What is the smallest context needed for this work unit?**\n4. **Which steps must be deterministic rather than delegated to a model?**\n5. **What independent evidence proves the output?**\n6. **Can the same workflow recover, resume, and audit itself after failure?**\n\nForgeOS v0.6 turns those questions into a runtime:\n\n```text\nconfirmed intent\n  → outcome + technique retrieval\n  → hard policy and anti-trigger filters\n  → minimum RoutePlan DAG\n  → isolated ContextPack per work unit\n  → deterministic / agent / reflection execution graph\n  → anchored outputs + coverage ledger\n  → trusted receipts + evidence gates\n  → release, rollback, recovery, and learning quarantine\n```\n\nIt is not a prompt collection. It is the control plane around skills, rules, hooks, agents, tools, context, evidence, and learning.\n\n---\n\n## What is real in v0.6.1\n\n| Surface | Verified implementation |\n|---|---:|\n| Legacy typed outcome scaffolds | **1,024** |\n| Deep Skill Contract v2 techniques | **128** |\n| L0 orchestration/trust/context techniques | **32** |\n| L1 cross-domain engineering techniques | **96** |\n| Independent evaluator bindings | **128** |\n| Skill catalog | **250** (**146** core, **104** domain) |\n| Stable procedural providers | **33** |\n| Candidate procedural providers | **242** |\n| Built-in skill + knowledge mappings | **1,299** |\n| Code Review Intelligence conformance cases | **12** |\n| Agent-surface adversarial cases | **20/20** |\n| Stable provider materialization | **33/33** |\n| Router Precision@1 / @3 | **93.75% / 100%** |\n| Router Recall@6 | **100%** |\n| Unsafe route activation | **0%** |\n\n> [!IMPORTANT]\n> The 1,024 legacy nodes are **outcome scaffolds**, not 1,024 production-grade procedural skills. v0.6 contains 128 deep technique contracts. Thirty-three procedural providers remain in the declared stable routing channel for compatibility, but the final certification audit finds 0/128 evidence-qualified stable and 0 certified under the Revision 2 Definition of Done. The remaining evidence requires holdout, paired multi-model, pressure, independent review, and production receipts.\n\n**Kernel inventory:** 32 L0 techniques + 96 L1 techniques = 128 deep kernel techniques.\n\n**Catalog routing states:** 33 declared stable-channel procedural providers and 242 candidates. **Formal certification evidence:** 0 stable-qualified, 0 certified. See [Final Certification Audit](docs/FINAL-CERTIFICATION-AUDIT.md).\n\nThe release audit intentionally keeps these claims false:\n\n```text\n1,024 production-grade procedural skills       false\nfull PostgreSQL lifecycle HA                    false\nuniversal microVM sandbox                       false\nexpert-labeled 200-PR review benchmark          false\n10,000 paired evaluation runs                   false\n```\n\nForgeOS v0.6 does not claim universal production completeness or 1,024 production-grade procedural skills.\n\nSee [Claims Boundary v0.6](docs/CLAIMS-BOUNDARY-V0.6.md).\n\n---\n\n## Universal lanes, governed execution\n\nThe immutable [Universal Lane Registry](docs/UNIVERSAL-LANES.md) routes work\nacross strategy and research, product UX/UI, visual media and 3D, software,\ndata and AI, agents, security, cloud operations, commerce, education,\nhardware/manufacturing, and robotics/physical AI. A lane is a truthful routing\nand evidence contract—not a claim that ForgeOS can autonomously operate a\nfactory, robot, payment flow, or production environment.\n\nPhysical-world work remains human-approved. High-risk third-party execution\nrequires a compatible configured remote provider; the local broker never\npretends to be a microVM. See [Remote MicroVM Sandbox](docs/REMOTE-MICROVM-SANDBOX.md).\n\n---\n\n## Five-minute path\n\nUse this path when you want value without learning the Trust Kernel first.\n\n### 1. Install\n\n```bash\nnpm install\nnpm test\nnode src/cli/forge.mjs init\n```\n\nInstalled package:\n\n```bash\nnpx forgeos init\nforge doctor\n```\n\n`forge init` creates a safe local SQLite-WAL profile. Its API key is written to a `0600` file and is never printed.\n\n### 2. Find the right technique\n\n```bash\nforge skills search \"react rerender\"\nforge skills inspect reducing-react-render-thrashing\nforge route --query \"compile the minimum context for a large monorepo\"\n```\n\n### 3. Inspect v0.6\n\n```bash\nforge v06 status\nforge profile plan coding --target codex\nforge security scan --file agent-surface.json\n```\n\n### 4. Check the high-risk execution boundary\n\n```bash\nnode src/cli/forge.mjs sandbox status --json\n```\n\nWithout a configured remote provider this intentionally returns `unavailable` and exit code `2`; ForgeOS never represents the local broker as a microVM. See [Remote MicroVM Sandbox](docs/REMOTE-MICROVM-SANDBOX.md) for the signed provider contract.\n\n### 5. Start the local control plane\n\n```bash\nnpm start\n# Dashboard: http://127.0.0.1:8787/dashboard\n# MCP:       http://127.0.0.1:8787/mcp\n# A2A:       http://127.0.0.1:8787/a2a\n```\n\n---\n\n## Deep operator path\n\nUse this path when embedding ForgeOS into Codex, Claude Code, ChatGPT, an open-source agent, CI, or an internal platform.\n\n### Skill Intelligence Router\n\nThe router performs two-stage retrieval instead of matching a skill name:\n\n```text\nintent / failed gate\n  → outcome retrieval\n  → direct technique-trigger retrieval\n  → anti-trigger exclusion\n  → trust, tenant, maturity, tool, license, freshness filters\n  → measured-utility reranking\n  → minimum technique DAG\n  → provider resolution\n  → frozen RoutePlan\n```\n\nEvery selected and rejected technique has a reason. Hard blockers always beat score.\n\n### Global Context Kernel v2\n\nForgeOS budgets the complete request:\n\n```text\nsystem · task · selected skill sections · code symbols · artifacts\n· memory · tool output · references · lazy tool schemas\n· output reserve · safety reserve\n```\n\nIt provides:\n\n- one token-accounting interface shared by resolver and materializer;\n- section-level skill loading;\n- isolated context per work unit;\n- lazy tool-schema materialization;\n- Semantic ABI symbol IDs and stale-hash rejection;\n- artifact delta projection;\n- scoped, expiring instinct injection;\n- content-addressed raw logs with distilled failure ranges;\n- an omission manifest for every source not included.\n\n### Deterministic Skill Fabric\n\nA v0.6 technique is compiled into an executable graph:\n\n```text\nDeterministic nodes\n  scope-selection · bundling · rule-resolution · anchoring · evidence\n\nAgent nodes\n  investigation · hypothesis · domain judgment\n\nReflection nodes\n  contradiction · false-positive filter · actionability\n\nControl nodes\n  parallel join · coverage gate · retry · rollback\n```\n\nThe SQLite coverage ledger uses leases, heartbeat, fencing, and trusted receipts. A reclaimed worker cannot mark a work unit complete.\n\n### Code Review Intelligence vertical slice\n\nThe first complete vertical slice proves the architecture end to end:\n\n```text\ncomplete scope\n→ relation-aware work units\n→ contextual rule selection\n→ isolated agent analysis\n→ line/hash anchors\n→ relocation after edits\n→ independent reflection\n→ coverage receipt\n```\n\nThe bundled 12-case corpus is a deterministic conformance benchmark. It is **not** advertised as an expert-labeled 200-PR benchmark.\n\n### Continuous Learning—without automatic self-poisoning\n\nObserved patterns become scoped instincts, not stable skills:\n\n```text\ntrusted run receipts\n  → observed instinct\n  → tenant/project/harness isolation + TTL\n  → compatible instinct cluster\n  → candidate evolution proposal\n  → independent evaluation\n  → human promotion or rollback\n```\n\nThe producer cannot promote its own learned behavior.\n\n### Harness Runtime v2\n\nForgeOS distinguishes four surfaces:\n\n| Surface | Use it for |\n|---|---|\n| **Rule** | Short invariant that must always apply |\n| **Hook** | Deterministic action bound to an event |\n| **Skill** | Conditional procedure requiring judgment |\n| **Agent role** | Separate context, tools, model, or authority |\n\nNeutral events include `before.tool.execute`, `after.file.write`, `verification.checkpoint`, `session.compact`, and `session.ended`. Host adapters must mark unsupported features instead of claiming false parity.\n\nProfiles:\n\n```text\nminimal · coding · creative · research · regulated\nlocal-small · enterprise\n```\n\n### Agent Surface Security\n\nThe security engine scans the agent system itself:\n\n- instruction and prompt-boundary violations;\n- hooks and package lifecycle scripts;\n- MCP descriptions, permissions, and tool reachability;\n- command allowlists;\n- secret/environment references;\n- secret-to-egress permission paths;\n- pipe-to-shell and broad wildcard capability;\n- profile permission diffs before installation.\n\nIts adversarial corpus currently passes **20/20** cases.\n\n### Brokered local execution\n\nThe local runner provides a real safety boundary for normal commands:\n\n- no shell interpolation;\n- command and environment allowlists;\n- workspace and symlink containment;\n- timeout and process-group termination;\n- bounded stdout/stderr;\n- content-addressed execution receipt.\n\nIt is **not** a universal network-denying microVM sandbox. High-risk third-party execution still requires an external container or microVM isolation layer.\n\nForgeOS now has a fail-closed remote microVM control-plane adapter: it submits only to a configured HTTPS provider and accepts only request-bound, Ed25519-signed receipts with explicit network and secret isolation evidence. It never falls back to the local broker. The adapter is not a hosted microVM service; a compatible production provider remains an external deployment requirement. See [Remote MicroVM Sandbox](docs/REMOTE-MICROVM-SANDBOX.md).\n\n---\n\n\n# How ForgeOS works\n\nForgeOS combines two products in one runtime:\n\n1. **A Skill Intelligence layer** that retrieves techniques, rejects unsafe near-matches, compiles only the required skill sections, and builds a frozen execution plan.\n2. **An AI control plane** that manages projects, artifacts, evidence, approvals, leases, recovery, federation, and release gates.\n\n```text\nconfirmed intent or failed gate\n  → outcome and direct-technique retrieval\n  → anti-trigger, tenant, trust, tool, license, and freshness filters\n  → minimum frozen RoutePlan DAG\n  → isolated ContextPack per work unit\n  → deterministic / agent / reflection Execution Graph\n  → anchored outputs and fenced Coverage Ledger\n  → trusted receipts and assurance-aware gates\n  → release, recovery, rollback, or learning quarantine\n```\n\n## Ten cooperating systems\n\n| System | What it controls |\n|---|---|\n| **Skill Intelligence Router** | Outcome retrieval, technique scoring, anti-triggers, hard policy, provider selection, and explainable RoutePlans |\n| **Global Context Kernel v2** | One total token budget across policy, task, skill sections, symbols, artifacts, memory, tool output, references, and output reserve |\n| **Deterministic Skill Fabric** | Hybrid graphs containing deterministic nodes, agent nodes, reflection nodes, approvals, anchors, and stop conditions |\n| **Coverage Ledger** | Work-unit ownership, leases, fencing tokens, completion coverage, stale-worker rejection, and resumability |\n| **Trust Kernel** | Evidence freshness, artifact lineage, approval authority, assurance levels, and release decisions |\n| **Agent Surface Security** | Prompt-injection patterns, dangerous package scripts, secret-to-egress paths, permissions, and adapter capability honesty |\n| **Brokered Local Execution** | Shell-free command spawning, allowlists, timeouts, output limits, and structured receipts |\n| **Continuous Learning** | Scoped instincts, expiry, confidence, quarantine, candidate proposals, and controlled promotion |\n| **Skill Federation** | Signed sources, trust tiers, quarantine, conflict handling, revocation, and synchronized catalogs |\n| **Harness Runtime v2** | Rules, hooks, skills, agent roles, permission diffs, and profiles for different AI harnesses |\n\n---\n\n# Ecosystem comparison\n\n> [!IMPORTANT]\n> This comparison describes the **native, first-class focus of each core repository**. `◐` means partial support, extension-based support, or support through an adjacent product. `—` means it is not the project's primary focus, not that it is impossible to build.\n\nGitHub stars below are approximate figures checked on **July 26, 2026**. They indicate community visibility, not engineering quality by themselves.\n\n## Ecosystem map\n\n| Project | Approx. GitHub stars | Primary role |\n|---|---:|---|\n| [Superpowers](https://github.com/obra/superpowers) | **255k** | Agent skill framework and software-development methodology |\n| [Anthropic Agent Skills](https://github.com/anthropics/skills) | **151k** | Skill standard and public skill library for Claude |\n| [LangChain](https://github.com/langchain-ai/langchain) | **139k** | Agent engineering platform and large integration ecosystem |\n| [OpenHands](https://github.com/All-Hands-AI/OpenHands) | **75k+** | End-to-end software-development agent application |\n| [CrewAI](https://github.com/crewAIInc/crewAI) | **56k+** | Multi-agent crews and event-driven flows |\n| [AutoGen](https://github.com/microsoft/autogen) | **50k+** | Multi-agent messaging and research runtime |\n| [LangGraph](https://github.com/langchain-ai/langgraph) | **37k+** | Stateful, long-running agent graphs |\n| [Semantic Kernel](https://github.com/microsoft/semantic-kernel) | **28k+** | Multi-language enterprise orchestration SDK |\n| [Awesome Agent Skills](https://github.com/VoltAgent/awesome-agent-skills) | **28k+** | Community catalog of more than one thousand skills |\n| [OpenAI Agents SDK](https://github.com/openai/openai-agents-python) | **27k+** | Agents, handoffs, guardrails, sessions, and tracing |\n| [smolagents](https://github.com/huggingface/smolagents) | **27k+** | Minimal agent library with code-agent emphasis |\n| [Letta](https://github.com/letta-ai/letta) | **23k+** | Stateful agents and persistent memory |\n| [Google ADK](https://github.com/google/adk-python) | **about 20k** | Code-first agent building, evaluation, and deployment |\n| [PydanticAI](https://github.com/pydantic/pydantic-ai) | **about 19k** | Type-safe Python agent framework |\n\n## Core capability matrix\n\n| System | Packaged skills | Routing + anti-trigger | Governed context | Deterministic/agent hybrid graph | Evidence + trust receipts | Agent-surface security | Native strength |\n|---|:---:|:---:|:---:|:---:|:---:|:---:|---|\n| **ForgeOS** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | Skill intelligence and trustworthy execution |\n| Anthropic Skills | ✅ | ◐ | ◐ | — | — | ◐ | Simple, portable skill standard |\n| Superpowers | ✅ | ✅ | ◐ | ◐ | ◐ | — | Highly explicit SDLC methodology for coding agents |\n| Awesome Agent Skills | ✅ | — | — | — | — | ◐ | Skill discovery across many sources |\n| LangChain | ◐ | ◐ | ◐ | ◐ | ◐ | ◐ | Very large integration ecosystem |\n| LangGraph | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Durable execution and stateful graphs |\n| OpenAI Agents SDK | ◐ | ◐ | ◐ | ◐ | ◐ | ◐ | Lightweight framework, handoffs, and tracing |\n| CrewAI | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Role-based agents combined with Flows |\n| AutoGen | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Event-driven multi-agent runtime |\n| Semantic Kernel / MAF | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Enterprise orchestration across runtimes |\n| Google ADK | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Build, evaluate, and deploy in Google's ecosystem |\n| PydanticAI | ◐ | ◐ | ◐ | ◐ | ◐ | ◐ | Type safety, validation, and Python ergonomics |\n| smolagents | ◐ | ◐ | ◐ | ◐ | — | ◐ | Minimal, readable agent implementation |\n| Letta | ◐ | ◐ | ✅ | ◐ | ◐ | ◐ | Persistent memory and stateful agents |\n| OpenHands | ◐ | ◐ | ◐ | ◐ | ◐ | ✅ | End-to-end coding-agent experience |\n\n## ForgeOS chooses a different battlefield\n\nA skill repository answers: **“What procedures can the agent learn?”**\n\nForgeOS also asks: **“Which technique is allowed now, which near-match must be rejected, which sections may enter context, which tools are required, what evidence must be produced, and what gate may declare the work complete?”**\n\nAn agent framework helps create agents, tools, handoffs, and workflows. ForgeOS focuses on the layer surrounding that runtime: capability retrieval, anti-triggers, global context budgets, deterministic/agent/reflection graphs, current evidence, approval authority, artifact lineage, recovery, and learning quarantine.\n\nA memory system focuses on what an agent remembers. ForgeOS additionally controls which tenant, project, user, trust domain, expiry, confidence, and promotion policy that memory belongs to.\n\nAn end-to-end coding agent provides the user experience. ForgeOS can run **under or beside** that agent as the skill-selection, context-governance, evidence, trust, and project-lifecycle layer.\n\n## Where mature ecosystems still lead\n\nThey currently have larger communities, more tutorials and integrations, more polished managed-cloud experiences, stronger no-code onboarding, and more publicly documented production deployments. ForgeOS deliberately concentrates on a less standardized problem: **controlling skill choice, context, evidence, authority, and completion state for AI agents**.\n\n---\n\n# Three entry paths\n\n## For everyday users\n\nYou do not need to understand every subsystem. Start with four observable tests:\n\n```bash\nnode src/cli/forge.mjs doctor\nnode src/cli/forge.mjs skills search --query \"review authentication changes\"\nnode src/cli/forge.mjs route --query \"review authentication changes without missing tests\"\nnode src/cli/forge.mjs scan agent-surface --path .\n```\n\nYou can inspect which technique was selected, why alternatives were rejected, how much context was compiled, what permissions are requested, and which evidence is still missing.\n\n## For developers\n\nForgeOS exposes the same runtime through:\n\n- CLI for local operation and CI;\n- HTTP APIs and Studio dashboard;\n- **60 schema-strict MCP tools**;\n- A2A task and agent-card surfaces;\n- direct service imports from the Node.js source tree;\n- **15 adapters** for agent and IDE ecosystems;\n- seven harness profiles: `minimal`, `coding`, `creative`, `research`, `regulated`, `local-small`, and `enterprise`.\n\nDevelopers can create projects, register artifacts, bind evidence, request approvals, compile RoutePlans and ContextPacks, execute graphs, recover revisions, synchronize federated skills, or add a new Skill Contract v2.\n\n## For experts and researchers\n\nForgeOS is designed to be challenged rather than accepted from a marketing page. Experts can independently test:\n\n- router precision, recall, anti-trigger behavior, and unsafe activation;\n- total-context overflow and Semantic ABI reduction;\n- deterministic coverage, anchors, reflection, leases, and fencing;\n- evidence freshness, artifact lineage, and assurance-aware gates;\n- prompt injection, package scripts, secret-to-egress paths, and adapter honesty;\n- federation conflict, quarantine, revocation, and source trust;\n- archive verification without `.git`.\n\n```bash\nnpm run validate\nnpm run v06:audit\nnpm run router:benchmark\nnpm run context:benchmark\nnpm run federation:eval\nnpm run federation:audit\nnpm run smoke\nnpm run adapter:tck\nnpm run release:verify\n```\n\n---\n\n# Repository map\n\n```text\nsrc/                         runtime implementation\n  cli/                       forge command-line interface\n  core/                      project, artifact, evidence, approval, recovery\n  skill-intelligence/        contracts, routing, evaluation, materialization\n  context/                   Global Context Kernel and work-unit compilation\n  execution/                 graph compiler, deterministic nodes, coverage\n  trust/                     evidence, assurance, authority, release gates\n  security/                  agent-surface scanning and command broker\n  federation/                remote sources, trust, quarantine, synchronization\n  learning/                  instincts, candidates, expiry, promotion\n  mcp/                       MCP server and 60 public tools\n  a2a/                       A2A cards, tasks, messages, and receipts\n  server/                    HTTP APIs, authentication, dashboard\n  storage/                   SQLite-WAL persistence and migrations\nadapters/                    15 agent and IDE adapters\nskills/                      250 portable Agent Skills v1, including candidate 3D and physical-AI lanes\nskills-v2/                   128 deep Skill Contract v2 techniques\ncapabilities-v2/             outcomes, techniques, providers, relations, graph\nschemas/                     public JSON Schema 2020-12 contracts\npacks/                       vertical capability packs and benchmarks\nevals/                       evaluation cases, rubrics, and corpora\ntests/                       125 test files and release invariants\nevidence/                    generated audit, benchmark, SBOM, and dashboard evidence\ndocs/                        architecture, protocols, security, testing, production\nscripts/                     generation, validation, audit, benchmark, and release tools\n```\n\nThe [Universal Lanes registry](docs/UNIVERSAL-LANES.md) makes the cross-domain coverage and execution boundary of every lane inspectable. It is deliberately not an “AI can do everything” claim: physical, production, and external actions still need the declared evidence and human authority.\n\n# Suitable use cases\n\n- Making coding agents more disciplined and auditable.\n- Building a control plane for several models, agents, and tools.\n- Operating an internal skill platform with routing and maturity controls.\n- Reviewing agent configurations, permissions, prompts, and supply-chain surfaces.\n- High-assurance or regulated workflows requiring evidence and approval gates.\n- Reducing context waste in large repositories through work-unit isolation and Semantic ABI.\n\nForgeOS is not a replacement for n8n-style business workflow automation. n8n connects applications and business events; ForgeOS controls AI technique selection, context, execution, evidence, and authority. They can be used together.\n\n---\n\n## Architecture\n\n```mermaid\ngraph TD\n  U[User intent / failed gate] --> R[Unified Skill Intelligence Router]\n  R --> RP[Frozen RoutePlan]\n  RP --> CK[Global Context Kernel v2]\n  CK --> CP[Isolated ContextPack per work unit]\n  CP --> EG[Deterministic Execution Graph]\n  EG --> D[Deterministic nodes]\n  EG --> A[Agent nodes]\n  EG --> RF[Independent reflection]\n  D --> CL[Coverage Ledger]\n  A --> AN[Anchored outputs]\n  RF --> AN\n  CL --> TK[Trust Kernel]\n  AN --> TK\n  TK --> G[Evidence-aware gates]\n  G --> O[Artifacts / release / recovery]\n  LR[Learning quarantine] --> R\n  SF[Skill / Knowledge / MCP Federation] --> R\n  HR[Harness Runtime + Security] --> EG\n```\n\n---\n\n## MCP and agent integration\n\nForgeOS speaks MCP `2025-11-25`, A2A `1.0`, Agent Skills-compatible packages, HTTP, and CLI.\n\nv0.6 public tools include:\n\n```text\nforge_v06_status\nforge_execution_graph_compile\nforge_review_scope_compile\nforge_context_work_units_compile\nforge_harness_profile_plan\nforge_agent_surface_scan\n```\n\nThey join the existing project, artifact, trusted evidence, recovery, federation, Skill Intelligence, and MCP broker tools. Stdio, HTTP MCP, CLI, and Studio share the same services and JSON Schemas.\n\nSupported adapter packs include ChatGPT, Codex, Claude Code, Cursor, OpenCode, Gemini CLI, Copilot CLI, Cline, Roo Code, Windsurf, Continue, Hermes, OpenClaw, Pi, and generic MCP/A2A. Evidence distinguishes **protocol-tested** adapters from **documentation-only** guides.\n\n---\n\n## Verification\n\n```bash\nnpm run validate\nnpm run skills:v2:audit\nnpm run v06:audit\nnpm run router:benchmark\nnpm run context:benchmark\nnpm run federation:eval\nnpm run federation:audit\nnpm run smoke\nnpm run adapter:tck\nnpm run release:verify\n```\n\nThe release gate checks behavior and contracts, not only line coverage:\n\n- state, fencing, stale-proof, and lifecycle invariants;\n- full MCP/A2A lifecycle and output schemas;\n- skill depth, boilerplate, section hash, and materialization;\n- router precision, recall, determinism, and unsafe activation;\n- global context overflow and omission accounting;\n- deterministic execution and coverage ledger;\n- review anchors and reflection;\n- independent evaluation and continuous-learning quarantine;\n- agent-surface adversarial cases;\n- archive installation and self-verification without `.git`.\n\n---\n\n## Production boundary\n\n**Integrated today**\n\n- SQLite WAL single-node lifecycle backend;\n- revision/CAS, leases, fencing, snapshots, restore, ACL, OIDC/API key;\n- trusted receipts, artifact envelope hashes, assurance-aware gates;\n- tenant-scoped skill/knowledge/MCP federation;\n- graceful drain, readiness, metrics, signed release provenance;\n- non-root/read-only deployment profiles.\n\n**Not yet a v0.6 claim**\n\n- full-lifecycle PostgreSQL drop-in backend and tested multi-node failover;\n- universal third-party microVM sandbox;\n- SCIM/delegated organization administration;\n- managed transparency service and PKI;\n- A2A streaming/push and distributed resume;\n- 1,024 production-grade procedural skills;\n- 10,000 paired eval runs;\n- expert-adjudicated cross-language code-review benchmark.\n\nRead [Production](docs/PRODUCTION.md), [Security Model](docs/SECURITY-MODEL.md), and [Self-Audit v0.6](docs/SELF-AUDIT-V0.6.md).\n\n---\n\n## Documentation map\n\n| Start here | Deep dive |\n|---|---|\n| [Quick Start](docs/QUICKSTART.md) | [Architecture](docs/ARCHITECTURE.md) |\n| [Skill Intelligence](docs/SKILL-INTELLIGENCE.md) | [Deterministic Fabric v0.6](docs/DETERMINISTIC-SKILL-FABRIC-V06.md) |\n| [CLI and profiles](docs/HARNESS-RUNTIME-V2.md) | [Global Context Kernel](docs/GLOBAL-CONTEXT-KERNEL.md) |\n| [Security](docs/AGENT-SURFACE-SECURITY.md) | [Continuous Learning](docs/CONTINUOUS-LEARNING-V06.md) |\n| [Testing](docs/TESTING.md) | [Claims Boundary](docs/CLAIMS-BOUNDARY-V0.6.md) |\n| [Contributing](CONTRIBUTING.md) | [Self-Audit](docs/SELF-AUDIT-V0.6.md) |\n\n---\n\n## Languages\n\n[Tiếng Việt](README-vn.md) · [简体中文](README-cn.md) · [繁體中文](README-tw.md) · [日本語](README-ja.md) · [한국어](README-ko.md) · [Español](README-es.md) · [Français](README-fr.md) · [Deutsch](README-de.md) · [Português](README-pt-br.md) · [Русский](README-ru.md) · [العربية](README-ar.md) · [हिन्दी](README-hi.md) · [Bahasa Indonesia](README-id.md) · [ไทย](README-th.md) · [Türkçe](README-tr.md) · [Italiano](README-it.md) · [Polski](README-pl.md) · [Українська](README-uk.md) · [Nederlands](README-nl.md) · [فارسی](README-fa.md) · [עברית](README-he.md) · [Svenska](README-sv.md)\n\n---\n\n## Contributing\n\nA new skill is not accepted because its prose sounds expert. It needs:\n\n1. a RED baseline that fails without the technique;\n2. precise triggers and anti-triggers;\n3. a domain-specific procedure and failure model;\n4. typed inputs, outputs, tools, and evidence;\n5. section hashes and token budgets;\n6. independent evaluator bindings;\n7. benchmark evidence and a maturity decision.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md), [GOVERNANCE.md](GOVERNANCE.md), and [SECURITY.md](SECURITY.md).\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n\n## Final release audits\n\n- [Final Hardening Report](docs/FINAL-HARDENING-REPORT.md)\n- [Final Skill Certification Audit](docs/FINAL-CERTIFICATION-AUDIT.md)\n"}