Agent skill

Architecture Governance

by BytePioneer-AI in BytePioneer-AI/codex-host

Apply codexhost package and native ownership rules when changing production code or dependency directions.

LGPL-3.0Auto-check passed

Install Architecture Governance

skills CLI
$ npx skills add BytePioneer-AI/codex-host --skill architecture-governance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BytePioneer-AI/codex-host architecture-governance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BytePioneer-AI/codex-host.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/architecture-governance .claude/skills/architecture-governance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
architecture-governance
GitHub stars
2.8k
Token cost
~710 tokens
SKILL.md length
309 words
Files
4 (incl. references)
Skills in repo
9
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Apply codexhost package and native ownership rules when changing production code or dependency directions.

  • Works in 4 steps: Inspect the working tree and identify… → For dependency changes, read… → For changes to state, asynchronous… → …
  • SKILL.md covers Before changing code, Implement within existing… and Verify
  • Calls node

What it does

Architecture Governance is an agent skill from BytePioneer-AI/codex-host. Apply codexhost package and native ownership rules when changing production code or dependency directions. Inspect public contracts and run the existing boundary check; skip documentation-only work.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/ai-guidance.md` and `references/module-contract.md`).

The repository describes itself as: Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。 The licence is LGPL-3.0.

Example prompts

  • “/architecture-governance”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Inspect the working tree and identify the owning package or crate. Preserve unrelated edits. Read the relevant package exports, contracts…
  2. For dependency changes, read tools/check-boundaries.mjs and run node tools/check-boundaries.mjs before editing to establish the current…
  3. For changes to state, asynchronous behavior, or cross-package contracts, identify the authoritative owner, command path, derived views…
  4. Record substantial behavior or architecture decisions in the relevant existing feature document. Follow AGENTS.md for documentation scope…

What it can do on your machine

Read from SKILL.md and the folder at commit 08c7d65. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Architecture Governance loads about 710 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 309 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~710
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BytePioneer-AI/codex-host at commit 08c7d65, republished under its LGPL-3.0 licence (© BytePioneer-AI). 309 words, ~710 tokens.

Download SKILL.mdSave it as .claude/skills/architecture-governance/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
architecture-governance
description
Apply codexhost package and native ownership rules when changing production code or dependency directions. Inspect public contracts and run the existing boundary check; skip documentation-only work.
<!-- Adapted for codexhost from ZCode 872ad960de7ec172591f7e1952f7849229f94521. See ../NOTICE.md for provenance and licenses. -->

Architecture governance

Use the current repository's AGENTS.md and executable boundary checker as the policy. Paths in commands are relative to the repository root.

Before changing code

  1. Inspect the working tree and identify the owning package or crate. Preserve unrelated edits. Read the relevant package exports, contracts, implementation, tests, and feature documentation; use docs/index.md to locate it.
  2. For dependency changes, read tools/check-boundaries.mjs and run node tools/check-boundaries.mjs before editing to establish the current result. This checker scans the repository; it has no --changed mode or suppressible baseline.
  3. For changes to state, asynchronous behavior, or cross-package contracts, identify the authoritative owner, command path, derived views, event order, failure semantics, and native capability limits. Use implementation questions when needed.
  4. Record substantial behavior or architecture decisions in the relevant existing feature document. Follow AGENTS.md for documentation scope; small fixes do not require a new spec or module scaffold.

Implement within existing ownership

Use package public exports for cross-package dependencies. Preserve the Rust, Renderer, Shared Contracts, Host, and Harness Adapter responsibilities from AGENTS.md. Put Harness-specific protocols in the corresponding Adapter and load installed Harnesses through the plugin contract.

Use public contract guidance when an interface must change. New modules should solve a present responsibility; do not introduce ZCode's module manifests, layer names, or policy files into this repository merely to follow its original workflow.

Verify

Run node tools/check-boundaries.mjs after production changes that affect boundaries. Select other validation from the actual package scripts and owning test configuration, proportional to the change. Run focused behavior tests for changed semantics; a boundary check alone does not prove runtime correctness.

Report new failures separately from pre-existing failures, and state what was actually executed. A skipped or unavailable check remains unverified. Use the current script output as evidence; do not claim detection of cycles, line-count thresholds, or state ownership unless an executed check actually covers them.

© BytePioneer-AI, LGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .agents/skills/architecture-governance of BytePioneer-AI/codex-host.

  • SKILL.md
  • agents/openai.yaml
  • references/ai-guidance.md
  • references/module-contract.md

Open the folder on GitHubat commit 08c7d65

Compare with similar skills

Architecture Governance next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Architecture Governance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture Governance this skillBytePioneer-AI/codex-host2.8k—~710Automated safety check: PassLGPL-3.0
Docs Governanceaffaan-m/ECC277k—~1.1kAutomated safety check: PassMIT
Make Changesremix-run/remix33k—~2.4kAutomated safety check: PassMIT
Orch Change Featureaffaan-m/ECC277k1 repos~420Automated safety check: PassMIT
Change Managementsickn33/agentic-awesome-skills47k2 repos~3.5kAutomated safety check: PassMIT
Board Governancesickn33/agentic-awesome-skills47k1 repos~4.1kAutomated safety check: PassMIT

Similar skills

  • Docs Governance

    affaan-m/ECC

    Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.

    277k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Make Changes

    remix-run/remix

    Create or update Remix repo change files under packages//.changes.

    33k GitHub stars~2.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Orchestrate altering an existing, working feature to new desired behavior — update its tests to the new spec, change the implementation to match, review, and gated commit.

    277k GitHub starsUsed in 1 repo~420 tokens
    Auto-check passed
  • Change Management

    sickn33/agentic-awesome-skills

    Implement change management processes. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~3.5k tokens
    DevOps & CloudAuto-check passed
  • Board Governance

    sickn33/agentic-awesome-skills

    Board and governance register: meeting date, agenda, decision, resolution number, vote result, action owner and due date.

    47k GitHub starsUsed in 1 repo~4.1k tokens
    Auto-check passed
  • Agent Governance

    github/awesome-copilot

    Official

    Patterns and techniques for adding governance, safety, and trust controls to AI agent systems.

    40k GitHub starsUsed in 2 repos~4.6k tokens
    AI & LLM EngineeringAuto-check passed

More from BytePioneer-AI/codex-host

All 9 skills in this repo
  • Codexhost PR Triage

    BytePioneer-AI/codex-host

    手动增量分诊 codexhost Issue 与 PR,评估 PR 价值和实现克制,生成只读本地看板与回复草稿. An agent skill from BytePioneer-AI/codex-host.

    2.8k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Codexhost Add Harness

    BytePioneer-AI/codex-host

    为 codexhost 新增 Harness 插件,或规划、审查、补全现有 Harness Adapter。按当前公共契约实现原生能力,区分插件后端、预装发行和 Desktop 产品接入;不用于单纯添加 Model、Provider 或账号。

    2.8k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Codexhost Release

    BytePioneer-AI/codex-host

    发布 codexhost 正式版、预览版,编写或确认 Release Notes,检查发布 CI,暂停、恢复或排查发布。支持正常正式发布,以及 npm latest + GitHub Prerelease、不给现有用户更新提示的预览发行。不用于普通代码提交或 Harness CLI 更新。

    2.8k GitHub stars~998 tokensUpdated yesterday
    Auto-check passed
  • Web Gui Tester

    BytePioneer-AI/codex-host

    Verify web frontend behavior through real GUI interactions, read-only page inspection, and screenshots.

    2.8k GitHub starsUsed in 1 repo~4.1k tokens
    Auto-check passed
  • Feature Boundary Planner

    BytePioneer-AI/codex-host

    Trace a codexhost feature change across UI surfaces, Host routing, Harness capabilities, state ownership, persistence, and validation.

    2.8k GitHub stars~755 tokensUpdated yesterday
    Auto-check passed
  • Codexhost Update Impact Audit

    BytePioneer-AI/codex-host

    Diagnose whether a Codex Desktop update changed codexhost Composer/CDP bindings, private Renderer DOM or React state, Host bridges, routing, the Codex usage submission gate, or injected UI.

    2.8k GitHub stars~3.5k tokensUpdated yesterday
    Auto-check passed

Questions about Architecture Governance

What does Architecture Governance do?

Apply codexhost package and native ownership rules when changing production code or dependency directions. Architecture Governance is an agent skill from BytePioneer-AI/codex-host. Apply codexhost package and native ownership rules when changing production code or dependency directions.

How do I install Architecture Governance in Claude Code?

Run `npx skills add BytePioneer-AI/codex-host --skill architecture-governance -a claude-code`. Or copy the skill folder (.agents/skills/architecture-governance in BytePioneer-AI/codex-host) into .claude/skills/architecture-governance in your project. Claude Code loads it when a task matches its description.

How do I install Architecture Governance in Codex?

Run `npx skills add BytePioneer-AI/codex-host --skill architecture-governance -a codex`. Or copy the skill folder (.agents/skills/architecture-governance in BytePioneer-AI/codex-host) into .agents/skills/architecture-governance in your project. Codex loads it when a task matches its description.

Can I use Architecture Governance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BytePioneer-AI/codex-host --skill architecture-governance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture-governance, .gemini/skills/architecture-governance, .github/skills/architecture-governance and .opencode/skills/architecture-governance in your project.

What does Architecture Governance need to run?

Going by SKILL.md and its folder, Architecture Governance needs the command-line tools its instructions call (node).

Does Architecture Governance access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Architecture Governance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Architecture Governance use?

Architecture Governance is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Architecture Governance use?

About 710 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 563 tokens, read only when the agent opens those files.

What are the alternatives to Architecture Governance?

Skills that share tags, products or a category with Architecture Governance: Docs Governance (affaan-m/ECC, 277k stars), Make Changes (remix-run/remix, 33k stars), Orch Change Feature (affaan-m/ECC, 277k stars) and Change Management (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture Governance?

BytePioneer-AI (a GitHub user) maintains it in BytePioneer-AI/codex-host, which has 2,791 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 9, 2026.

Source: BytePioneer-AI/codex-host on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.