[{"data":1,"prerenderedAt":575},["ShallowReactive",2],{"docs-navigation":3,"docs-page-\u002Fdocs\u002Fagents\u002Fcode-governance":252,"docs-surround-\u002Fdocs\u002Fagents\u002Fcode-governance":572},[4],{"title":5,"path":6,"stem":7,"children":8,"page":251},"Docs","\u002Fdocs","docs",[9,36,101,197,232],{"title":10,"path":11,"stem":12,"children":13},"GET STARTED","\u002Fdocs\u002Fget-started","docs\u002F1.get-started\u002F1.index",[14,16,20,24,28,32],{"title":15,"path":11,"stem":12},"Welcome",{"title":17,"path":18,"stem":19},"Quickstart","\u002Fdocs\u002Fget-started\u002Fquickstart","docs\u002F1.get-started\u002F2.quickstart",{"title":21,"path":22,"stem":23},"API","\u002Fdocs\u002Fget-started\u002Fapi","docs\u002F1.get-started\u002F3.api",{"title":25,"path":26,"stem":27},"SDKs and CLI","\u002Fdocs\u002Fget-started\u002Fsdks-cli","docs\u002F1.get-started\u002F4.sdks-cli",{"title":29,"path":30,"stem":31},"Sandbox testing","\u002Fdocs\u002Fget-started\u002Flocal-development","docs\u002F1.get-started\u002F5.local-development",{"title":33,"path":34,"stem":35},"Authentication","\u002Fdocs\u002Fget-started\u002Fauthentication","docs\u002F1.get-started\u002F6.authentication",{"title":37,"path":38,"stem":39,"children":40},"FUNDAMENTALS","\u002Fdocs\u002Ffundamentals","docs\u002F2.fundamentals\u002F01.index",[41,43,47,51,55,59,63,67,71,75],{"title":42,"path":38,"stem":39},"Fundamentals",{"title":44,"path":45,"stem":46},"Architecture","\u002Fdocs\u002Ffundamentals\u002Farchitecture","docs\u002F2.fundamentals\u002F02.architecture",{"title":48,"path":49,"stem":50},"Memory model","\u002Fdocs\u002Ffundamentals\u002Fmemory-model","docs\u002F2.fundamentals\u002F03.memory-model",{"title":52,"path":53,"stem":54},"Compression","\u002Fdocs\u002Ffundamentals\u002Fcompression","docs\u002F2.fundamentals\u002F04.compression",{"title":56,"path":57,"stem":58},"RAG and cached context","\u002Fdocs\u002Ffundamentals\u002Frag-cag","docs\u002F2.fundamentals\u002F05.rag-cag",{"title":60,"path":61,"stem":62},"Context cache","\u002Fdocs\u002Ffundamentals\u002Fcontext-cache","docs\u002F2.fundamentals\u002F06.context-cache",{"title":64,"path":65,"stem":66},"Security","\u002Fdocs\u002Ffundamentals\u002Fsecurity","docs\u002F2.fundamentals\u002F07.security",{"title":68,"path":69,"stem":70},"Languages","\u002Fdocs\u002Ffundamentals\u002Flanguages","docs\u002F2.fundamentals\u002F08.languages",{"title":72,"path":73,"stem":74},"UI patterns","\u002Fdocs\u002Ffundamentals\u002Fui","docs\u002F2.fundamentals\u002F09.ui",{"title":76,"path":77,"stem":78,"children":79},"Global, Regional, and Jurisdictional Memory","\u002Fdocs\u002Ffundamentals\u002Fdata-placement","docs\u002F2.fundamentals\u002F10.data-placement\u002F1.index",[80,81,85,89,93,97],{"title":76,"path":77,"stem":78},{"title":82,"path":83,"stem":84},"TypeScript \u002F JavaScript","\u002Fdocs\u002Ffundamentals\u002Fdata-placement\u002Ftypescript","docs\u002F2.fundamentals\u002F10.data-placement\u002F2.typescript",{"title":86,"path":87,"stem":88},"Python","\u002Fdocs\u002Ffundamentals\u002Fdata-placement\u002Fpython","docs\u002F2.fundamentals\u002F10.data-placement\u002F3.python",{"title":90,"path":91,"stem":92},"PHP","\u002Fdocs\u002Ffundamentals\u002Fdata-placement\u002Fphp","docs\u002F2.fundamentals\u002F10.data-placement\u002F4.php",{"title":94,"path":95,"stem":96},"Go","\u002Fdocs\u002Ffundamentals\u002Fdata-placement\u002Fgo","docs\u002F2.fundamentals\u002F10.data-placement\u002F5.go",{"title":98,"path":99,"stem":100},"Rust","\u002Fdocs\u002Ffundamentals\u002Fdata-placement\u002Frust","docs\u002F2.fundamentals\u002F10.data-placement\u002F6.rust",{"title":102,"path":103,"stem":104,"children":105},"AGENTS & CODE NUCLEI","\u002Fdocs\u002Fagents","docs\u002F3.agents\u002F01.index",[106,108,112,116,120,124,128,132,136,140,158,193],{"title":107,"path":103,"stem":104},"Agents",{"title":109,"path":110,"stem":111},"Codex Code Nucleus","\u002Fdocs\u002Fagents\u002Fcodex-code-nucleus","docs\u002F3.agents\u002F02.codex-code-nucleus",{"title":113,"path":114,"stem":115},"Claude Code Nucleus","\u002Fdocs\u002Fagents\u002Fclaude-code-nucleus","docs\u002F3.agents\u002F03.claude-code-nucleus",{"title":117,"path":118,"stem":119},"Google Gemini Code Nucleus","\u002Fdocs\u002Fagents\u002Fgoogle-gemini-code-nucleus","docs\u002F3.agents\u002F04.google-gemini-code-nucleus",{"title":121,"path":122,"stem":123},"GitHub Copilot Code Nucleus","\u002Fdocs\u002Fagents\u002Fgithub-copilot-code-nucleus","docs\u002F3.agents\u002F05.github-copilot-code-nucleus",{"title":125,"path":126,"stem":127},"Cursor Code Nucleus","\u002Fdocs\u002Fagents\u002Fcursor-code-nucleus","docs\u002F3.agents\u002F06.cursor-code-nucleus",{"title":129,"path":130,"stem":131},"Windsurf Code Nucleus","\u002Fdocs\u002Fagents\u002Fwindsurf-code-nucleus","docs\u002F3.agents\u002F07.windsurf-code-nucleus",{"title":133,"path":134,"stem":135},"Agent skills","\u002Fdocs\u002Fagents\u002Fagent-skills","docs\u002F3.agents\u002F08.agent-skills",{"title":137,"path":138,"stem":139},"Admin UI prompt","\u002Fdocs\u002Fagents\u002Fadmin-ui-prompt","docs\u002F3.agents\u002F09.admin-ui-prompt",{"title":141,"path":142,"stem":143,"children":144},"Team Code Governance","\u002Fdocs\u002Fagents\u002Fcode-governance","docs\u002F3.agents\u002F10.code-governance\u002F1.index",[145,146,150,154],{"title":141,"path":142,"stem":143},{"title":147,"path":148,"stem":149},"Local Team Setup","\u002Fdocs\u002Fagents\u002Fcode-governance\u002Flocal-team-setup","docs\u002F3.agents\u002F10.code-governance\u002F2.local-team-setup",{"title":151,"path":152,"stem":153},"Language Governance Packs","\u002Fdocs\u002Fagents\u002Fcode-governance\u002Flanguage-packs","docs\u002F3.agents\u002F10.code-governance\u002F3.language-packs",{"title":155,"path":156,"stem":157},"GitHub CI\u002FCD Governance","\u002Fdocs\u002Fagents\u002Fcode-governance\u002Fgithub-cicd","docs\u002F3.agents\u002F10.code-governance\u002F4.github-cicd",{"title":159,"path":160,"stem":161,"children":162},"Memory + Consequence Agents","\u002Fdocs\u002Fagents\u002Fmemory-consequence-agents","docs\u002F3.agents\u002F11.memory-consequence-agents\u002F1.index",[163,164,185,189],{"title":159,"path":160,"stem":161},{"title":165,"path":166,"stem":167,"children":168},"End-to-End Agent Example","\u002Fdocs\u002Fagents\u002Fmemory-consequence-agents\u002Fend-to-end","docs\u002F3.agents\u002F11.memory-consequence-agents\u002F2.end-to-end\u002F1.index",[169,170,173,176,179,182],{"title":165,"path":166,"stem":167},{"title":82,"path":171,"stem":172},"\u002Fdocs\u002Fagents\u002Fmemory-consequence-agents\u002Fend-to-end\u002Ftypescript","docs\u002F3.agents\u002F11.memory-consequence-agents\u002F2.end-to-end\u002F2.typescript",{"title":86,"path":174,"stem":175},"\u002Fdocs\u002Fagents\u002Fmemory-consequence-agents\u002Fend-to-end\u002Fpython","docs\u002F3.agents\u002F11.memory-consequence-agents\u002F2.end-to-end\u002F3.python",{"title":90,"path":177,"stem":178},"\u002Fdocs\u002Fagents\u002Fmemory-consequence-agents\u002Fend-to-end\u002Fphp","docs\u002F3.agents\u002F11.memory-consequence-agents\u002F2.end-to-end\u002F4.php",{"title":94,"path":180,"stem":181},"\u002Fdocs\u002Fagents\u002Fmemory-consequence-agents\u002Fend-to-end\u002Fgo","docs\u002F3.agents\u002F11.memory-consequence-agents\u002F2.end-to-end\u002F5.go",{"title":98,"path":183,"stem":184},"\u002Fdocs\u002Fagents\u002Fmemory-consequence-agents\u002Fend-to-end\u002Frust","docs\u002F3.agents\u002F11.memory-consequence-agents\u002F2.end-to-end\u002F6.rust",{"title":186,"path":187,"stem":188},"Industry Agent Use Cases","\u002Fdocs\u002Fagents\u002Fmemory-consequence-agents\u002Findustry-use-cases","docs\u002F3.agents\u002F11.memory-consequence-agents\u002F3.industry-use-cases",{"title":190,"path":191,"stem":192},"Historical Actions and Learning","\u002Fdocs\u002Fagents\u002Fmemory-consequence-agents\u002Fhistorical-learning","docs\u002F3.agents\u002F11.memory-consequence-agents\u002F4.historical-learning",{"title":194,"path":195,"stem":196},"Consequence decision support","\u002Fdocs\u002Fagents\u002Fconsequence","docs\u002F3.agents\u002F12.consequence",{"title":198,"path":199,"stem":200,"children":201},"MODEL PROVIDERS","\u002Fdocs\u002Fproviders","docs\u002F4.providers\u002F1.index",[202,204,208,212,216,220,224,228],{"title":203,"path":199,"stem":200},"Providers",{"title":205,"path":206,"stem":207},"OpenAI and Azure OpenAI","\u002Fdocs\u002Fproviders\u002Fopenai","docs\u002F4.providers\u002F2.openai",{"title":209,"path":210,"stem":211},"Anthropic Claude","\u002Fdocs\u002Fproviders\u002Fanthropic","docs\u002F4.providers\u002F3.anthropic",{"title":213,"path":214,"stem":215},"Google Gemini and Vertex AI","\u002Fdocs\u002Fproviders\u002Fgoogle-gemini","docs\u002F4.providers\u002F4.google-gemini",{"title":217,"path":218,"stem":219},"OpenAI-compatible providers","\u002Fdocs\u002Fproviders\u002Fopenai-compatible","docs\u002F4.providers\u002F5.openai-compatible",{"title":221,"path":222,"stem":223},"Groq","\u002Fdocs\u002Fproviders\u002Fgroq","docs\u002F4.providers\u002F6.groq",{"title":225,"path":226,"stem":227},"Cohere","\u002Fdocs\u002Fproviders\u002Fcohere","docs\u002F4.providers\u002F7.cohere",{"title":229,"path":230,"stem":231},"Amazon Bedrock","\u002Fdocs\u002Fproviders\u002Famazon-bedrock","docs\u002F4.providers\u002F8.amazon-bedrock",{"title":233,"path":234,"stem":235,"children":236},"CHANGELOG","\u002Fdocs\u002Fchangelog","docs\u002F5.changelog\u002F1.index",[237,239,243,247],{"title":238,"path":234,"stem":235},"Changelog",{"title":240,"path":241,"stem":242},"Roadmap","\u002Fdocs\u002Fchangelog\u002Froadmap","docs\u002F5.changelog\u002F2.roadmap",{"title":244,"path":245,"stem":246},"Release notes","\u002Fdocs\u002Fchangelog\u002Frelease-runbook","docs\u002F5.changelog\u002F3.release-runbook",{"title":248,"path":249,"stem":250},"Testing","\u002Fdocs\u002Fchangelog\u002Ftesting","docs\u002F5.changelog\u002F4.testing",false,{"id":253,"title":141,"body":254,"description":566,"extension":567,"meta":568,"navigation":569,"path":142,"seo":570,"stem":143,"__hash__":571},"docs\u002Fdocs\u002F3.agents\u002F10.code-governance\u002F1.index.md",{"type":255,"value":256,"toc":557},"minimark",[257,261,265,268,273,345,348,352,355,398,401,409,413,416,426,433,437,488,491,495,498,519,522,526,529,532,536,553],[258,259,141],"h1",{"id":260},"team-code-governance",[262,263,264],"p",{},"Neutron gives a development team one durable, scoped source of coding policy that can follow work across Codex, Claude Code, Gemini CLI, GitHub Copilot, Cursor, and Windsurf. Install team policy, language standards, coding skills, and source-anchored knowledge bases into the repository's Code Nucleus, then require every coding agent to request those scopes before it plans or edits code.",[262,266,267],{},"Neutron improves consistency, but it is not a compiler or a policy engine by itself. Reliable enforcement combines agent guidance with deterministic local checks, protected-branch CI, reviews, and deployment approvals.",[269,270,272],"h2",{"id":271},"the-four-control-layers","The four control layers",[274,275,276,292],"table",{},[277,278,279],"thead",{},[280,281,282,286,289],"tr",{},[283,284,285],"th",{},"Layer",[283,287,288],{},"Purpose",[283,290,291],{},"Authority",[293,294,295,312,323,334],"tbody",{},[280,296,297,301,309],{},[298,299,300],"td",{},"Repository instructions",[298,302,303,304,308],{},"Project-specific architecture, naming, security, ownership, and commands in ",[305,306,307],"code",{},"AGENTS.md"," or the host adapter.",[298,310,311],{},"Closest rule to the code.",[280,313,314,317,320],{},[298,315,316],{},"Code Nucleus governance",[298,318,319],{},"Shared team policy, installed language skills, standards, reference knowledge, and reviewed outcomes.",[298,321,322],{},"Scoped supporting context.",[280,324,325,328,331],{},[298,326,327],{},"Local gates",[298,329,330],{},"Fast formatter, analyzer, compiler\u002Ftype, test, secret, and build feedback.",[298,332,333],{},"Developer feedback; locally bypassable.",[280,335,336,339,342],{},[298,337,338],{},"CI and review",[298,340,341],{},"Required checks, code owners, rulesets, environments, attestations, and deployment approval.",[298,343,344],{},"Authoritative merge and release gate.",[262,346,347],{},"The coding agent must use all four. A successful Neutron recall is not proof that code complies, and a passing formatter is not proof that architecture or security policy was followed.",[269,349,351],{"id":350},"installable-governance-catalog","Installable governance catalog",[262,353,354],{},"The Industry Library includes:",[356,357,358,369,390],"ul",{},[359,360,361,364,365,368],"li",{},[362,363,141],"strong",{}," — shared policy, an always-invoked change workflow, and governance reference knowledge in ",[305,366,367],{},"governance:team-code",".",[359,370,371,374,375,378,379],{},[362,372,373],{},"Language Engineering Governance"," — three assets per language in ",[305,376,377],{},"standards:\u003Clanguage>",":\n",[356,380,381,384,387],{},[359,382,383],{},"coding standards",[359,385,386],{},"governed coding skill",[359,388,389],{},"source-anchored language knowledge base",[359,391,392,394,395,368],{},[362,393,155],{}," — workflow standards, a CI\u002FCD review skill, and GitHub Actions knowledge in ",[305,396,397],{},"delivery:github-actions",[262,399,400],{},"Supported language packs cover C++, Rust, Go, Swift, TypeScript and JavaScript, Java, Kotlin, C# and .NET, Python, PHP, Ruby, Shell, and SQL\u002Fdatabase engineering.",[262,402,403,404,408],{},"See the ",[405,406,407],"a",{"href":152},"language pack catalog"," for every pack ID, scope, validation baseline, and source set.",[269,410,412],{"id":411},"recommended-scope-stack","Recommended scope stack",[262,414,415],{},"For a TypeScript service deployed through GitHub Actions, request:",[417,418,424],"pre",{"className":419,"code":421,"language":422,"meta":423},[420],"language-text","governance:team-code\nstandards:typescript-javascript\ndelivery:github-actions\nrepo:root\nservice:edge-api\ntests:edge-api\nagent:codex\n","text","",[305,425,421],{"__ignoreMap":423},[262,427,428,429,432],{},"Use only the languages and repository surfaces relevant to the task. A polyglot change can request multiple ",[305,430,431],{},"standards:*"," scopes, but a documentation-only change should not pull every language pack into context.",[269,434,436],{"id":435},"required-agent-loop","Required agent loop",[417,438,442],{"className":439,"code":440,"language":441,"meta":423,"style":423},"language-mermaid shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","flowchart LR\n  A[\"Bounded developer task\"] --> B[\"Validate Nucleus and request governance scopes\"]\n  B --> C[\"Read repository rules and current files\"]\n  C --> D[\"Plan and implement with installed skills\"]\n  D --> E[\"Run deterministic local checks\"]\n  E --> F[\"CI, review, and approval\"]\n  F --> G[\"Store safe reviewed outcome\"]\n","mermaid",[305,443,444,452,458,464,470,476,482],{"__ignoreMap":423},[445,446,449],"span",{"class":447,"line":448},"line",1,[445,450,451],{},"flowchart LR\n",[445,453,455],{"class":447,"line":454},2,[445,456,457],{},"  A[\"Bounded developer task\"] --> B[\"Validate Nucleus and request governance scopes\"]\n",[445,459,461],{"class":447,"line":460},3,[445,462,463],{},"  B --> C[\"Read repository rules and current files\"]\n",[445,465,467],{"class":447,"line":466},4,[445,468,469],{},"  C --> D[\"Plan and implement with installed skills\"]\n",[445,471,473],{"class":447,"line":472},5,[445,474,475],{},"  D --> E[\"Run deterministic local checks\"]\n",[445,477,479],{"class":447,"line":478},6,[445,480,481],{},"  E --> F[\"CI, review, and approval\"]\n",[445,483,485],{"class":447,"line":484},7,[445,486,487],{},"  F --> G[\"Store safe reviewed outcome\"]\n",[262,489,490],{},"The agent should stop and report the gap when a required policy scope is missing, stale, or contradictory. It must never silently replace team policy with a generic model preference.",[269,492,494],{"id":493},"policy-precedence","Policy precedence",[262,496,497],{},"Use this order when instructions conflict:",[499,500,501,504,507,510,513,516],"ol",{},[359,502,503],{},"Security, privacy, legal, tenant-isolation, and data-handling requirements.",[359,505,506],{},"The current developer task and explicit human decisions.",[359,508,509],{},"Repository and path-specific instructions.",[359,511,512],{},"Team architecture decisions and supported-version policy recalled from the current Nucleus.",[359,514,515],{},"Installed language and delivery standards.",[359,517,518],{},"General model knowledge.",[262,520,521],{},"Record exceptions with the rule, affected paths, reason, owner, approver, risk, compensating test, and expiry or review date. Do not teach an exception back to shared memory as a new rule unless the team approves it.",[269,523,525],{"id":524},"failure-safe-behavior","Failure-safe behavior",[262,527,528],{},"If Neutron is unavailable, the agent should still read repository instructions and run deterministic checks. It should clearly mark governance context as unavailable and must not claim full policy verification. For high-risk changes, teams can require the agent to stop until governance context is restored.",[262,530,531],{},"Never send secrets, access tokens, production data, private customer payloads, hidden prompts, model scratchpads, or raw chain-of-thought to Neutron.",[269,533,535],{"id":534},"continue","Continue",[356,537,538,543,548],{},[359,539,540],{},[405,541,542],{"href":148},"Set up local developers and coding agents",[359,544,545],{},[405,546,547],{"href":152},"Choose language governance packs",[359,549,550],{},[405,551,552],{"href":156},"Enforce GitHub CI\u002FCD policy",[554,555,556],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":423,"searchDepth":454,"depth":454,"links":558},[559,560,561,562,563,564,565],{"id":271,"depth":454,"text":272},{"id":350,"depth":454,"text":351},{"id":411,"depth":454,"text":412},{"id":435,"depth":454,"text":436},{"id":493,"depth":454,"text":494},{"id":524,"depth":454,"text":525},{"id":534,"depth":454,"text":535},"Keep local developers and coding agents aligned with team standards, policies, and best practices.","md",{},true,{"title":141,"description":566},"2dPFvgKrqzjtR5MXiAPeuUWsVuRs9eISgDvp04WiD3U",[573,574],{"title":137,"path":138,"stem":139,"children":-1},{"title":147,"path":148,"stem":149,"children":-1},1786883755931]