PR Design Doc
OpenHands/OpenHands
For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…
管理项目稳定领域上下文与难回退决策：按需建立边界严格的 CONTEXT.md，并用 docs/adr/README.md 统一索引、一项决策一个 ADR 文件。用于领域术语反复解释、同词异义、架构或数据库选型、认证/部署/数据模型/API 版本策略、需要记录为什么这样做及如何退出时。English triggers: domain context, context governance…
Install Context And Decisions
$ npx skills add qshanx/docs-governance --skill context-and-decisions -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install qshanx/docs-governance context-and-decisions --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/qshanx/docs-governance.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/context-and-decisions .claude/skills/context-and-decisions && rm -rf skills-srcUse ~/.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/
Install the "context-and-decisions" agent skill from https://github.com/qshanx/docs-governance/tree/main/skills/context-and-decisions into .claude/skills/context-and-decisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "context-and-decisions", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/qshanx/docs-governance/tree/main/skills/context-and-decisionsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add qshanx/docs-governance --skill context-and-decisions -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install qshanx/docs-governance context-and-decisions --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/qshanx/docs-governance.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/context-and-decisions .agents/skills/context-and-decisions && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "context-and-decisions" agent skill from https://github.com/qshanx/docs-governance/tree/main/skills/context-and-decisions into .agents/skills/context-and-decisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "context-and-decisions", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add qshanx/docs-governance --skill context-and-decisions -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install qshanx/docs-governance context-and-decisions --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/qshanx/docs-governance.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/context-and-decisions .cursor/skills/context-and-decisions && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "context-and-decisions" agent skill from https://github.com/qshanx/docs-governance/tree/main/skills/context-and-decisions into .cursor/skills/context-and-decisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "context-and-decisions", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/qshanx/docs-governance.git --path skills/context-and-decisions--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add qshanx/docs-governance --skill context-and-decisions -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install qshanx/docs-governance context-and-decisions --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/qshanx/docs-governance.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/context-and-decisions .gemini/skills/context-and-decisions && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "context-and-decisions" agent skill from https://github.com/qshanx/docs-governance/tree/main/skills/context-and-decisions into .gemini/skills/context-and-decisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "context-and-decisions", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install qshanx/docs-governance context-and-decisionsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add qshanx/docs-governance --skill context-and-decisions -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/qshanx/docs-governance.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/context-and-decisions .github/skills/context-and-decisions && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "context-and-decisions" agent skill from https://github.com/qshanx/docs-governance/tree/main/skills/context-and-decisions into .github/skills/context-and-decisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "context-and-decisions", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add qshanx/docs-governance --skill context-and-decisions -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install qshanx/docs-governance context-and-decisions --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/qshanx/docs-governance.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/context-and-decisions .opencode/skills/context-and-decisions && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "context-and-decisions" agent skill from https://github.com/qshanx/docs-governance/tree/main/skills/context-and-decisions into .opencode/skills/context-and-decisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "context-and-decisions", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
context-and-decisions- GitHub stars
- 134
- Token cost
- ~417 tokens
- SKILL.md length
- 85 words
- Files
- 1
- Skills in repo
- 10
- Repo updated
- First seen
- Licence
- MIT
At a glance
管理项目稳定领域上下文与难回退决策：按需建立边界严格的 CONTEXT.md，并用 docs/adr/README.md 统一索引、一项决策一个 ADR 文件。用于领域术语反复解释、同词异义、架构或数据库选型、认证/部署/数据模型/API 版本策略、需要记录为什么这样做及如何退出时。English triggers: domain context, context governance…
- Works in 8 steps: 先读取现有 CONTEXT.md、docs/adr/README.md 和相关… → 用真实约束写 Context；列出确实讨论过的… → 在 Decision 与 Reason 中区分“选了什么”和“为什么选”。 → …
- Tasks that involve Architecture decision records
- SKILL.md covers CONTEXT.md：只管领域语言, docs/adr/：一项决策一个文件, 决策流程 and 排期与任务边界
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Context And Decisions is an agent skill from qshanx/docs-governance. 管理项目稳定领域上下文与难回退决策：按需建立边界严格的 CONTEXT.md，并用 docs/adr/README.md 统一索引、一项决策一个 ADR 文件。用于领域术语反复解释、同词异义、架构或数据库选型、认证/部署/数据模型/API 版本策略、需要记录为什么这样做及如何退出时。English triggers: domain context, context governance, architecture decision record, ADR, database decision, architectural decision.
Its SKILL.md is about 420 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Architecture decision records. The repository describes itself as: Claude Code、Codex 与 ChatGPT 的文档驱动开发治理插件：防文档腐烂、维护上下文与决策、契约协作、测试与回归证据。 The licence is MIT.
When your agent uses it
- Tasks that involve Architecture decision records
Example prompts
- “/context-and-decisions”
Workflow steps
8 steps, taken from the first numbered list in SKILL.md.
- 先读取现有 CONTEXT.md、docs/adr/README.md 和相关 ADR，避免重复决策。
- 用真实约束写 Context；列出确实讨论过的 Alternatives，不补写虚构方案。
- 在 Decision 与 Reason 中区分“选了什么”和“为什么选”。
- 在 Consequences 中写收益、代价、可逆性、迁移与退出路径；不可逆部分明确标出。
- 用 Related 链接 Spec/Issue、CONTRACT、TEST-ID、提交或代码位置。
- 新决策替代旧决策时，新 ADR 填 Supersedes，旧 ADR 改为 superseded 并互相链接；不要删除旧记录。
- 更新 docs/adr/README.md，并从 CLAUDE_MAP.md 只挂 ADR 索引入口，不枚举每个 ADR。
- 在 PROJECT_LOG.md 追加一条决策事件。
What it can do on your machine
Read from SKILL.md and the folder at commit 520696e. 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
No scripts in the folder and no shell commands in SKILL.md.
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
Context And Decisions loads about 417 tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 85 words of instructions outside code blocks.
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 qshanx/docs-governance at commit 520696e, republished under its MIT licence (© qshanx). 85 words, ~417 tokens.
Download SKILL.mdSave it as
.claude/skills/context-and-decisions/SKILL.md (or your agent's skills folder).- name
- context-and-decisions
- description
- 管理项目稳定领域上下文与难回退决策：按需建立边界严格的 CONTEXT.md，并用 docs/adr/README.md 统一索引、一项决策一个 ADR 文件。用于领域术语反复解释、同词异义、架构或数据库选型、认证/部署/数据模型/API 版本策略、需要记录为什么这样做及如何退出时。English triggers: domain context, context governance, architecture decision record, ADR, database decision, architectural decision.
领域上下文与决策
把“业务里这些词是什么意思”和“为什么选择这个方案”分开管理。没有稳定内容时不要创建空壳。
CONTEXT.md：只管领域语言
在术语反复解释、同词异义或模块边界因语言不清而出错时，使用 templates/context.example.md 懒创建根目录 CONTEXT.md。
只记录：
- 领域术语及精确定义；
- 核心概念之间的关系；
- 已确认的歧义与采用口径；
- 仍待业务方确认的歧义。
禁止写入：实现细节、当前状态、任务排期、需求全文、决策理由和历史。对应内容分别回到代码/MAP、STATUS/Issue Tracker、Spec、ADR、LOG。术语必须能和代码、契约或业务证据对照；不能确认就标“待确认”，不要猜。
docs/adr/：一项决策一个文件
首次出现难回退决策时，创建：
docs/adr/README.md：薄索引，只列编号、标题、状态和链接；- 一项决策一份编号文件（例如
0001-use-postgresql.md），套用templates/adr.example.md。
使用连续四位编号。状态只允许 proposed、accepted、deprecated、superseded。ADR 至少包含：Context、Decision、Alternatives、Reason、Consequences、Status、Related、Supersedes。
以下变化默认检查是否需要 ADR：架构边界、数据库或存储、认证授权、部署拓扑、数据模型、API 版本策略、跨模块技术选型。普通实现细节、易回退的小改动和当天临时实验不要写 ADR。
决策流程
- 先读取现有
CONTEXT.md、docs/adr/README.md和相关 ADR，避免重复决策。 - 用真实约束写 Context；列出确实讨论过的 Alternatives，不补写虚构方案。
- 在 Decision 与 Reason 中区分“选了什么”和“为什么选”。
- 在 Consequences 中写收益、代价、可逆性、迁移与退出路径；不可逆部分明确标出。
- 用 Related 链接 Spec/Issue、CONTRACT、TEST-ID、提交或代码位置。
- 新决策替代旧决策时，新 ADR 填 Supersedes，旧 ADR 改为
superseded并互相链接；不要删除旧记录。 - 更新
docs/adr/README.md，并从CLAUDE_MAP.md只挂 ADR 索引入口，不枚举每个 ADR。 - 在
PROJECT_LOG.md追加一条决策事件。
排期与任务边界
让 GitHub Issues、Linear 或项目已有 Tracker 成为任务、状态、阻塞和排期的唯一事实源。只有项目没有外部 Tracker 时，才按项目约定使用本地 .scratch/；不要把排期塞进 CONTEXT.md、ADR、PROJECT_STATUS 或日志数据库。
© qshanx, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/context-and-decisions of qshanx/docs-governance.
Open the folder on GitHubat commit 520696e
Compare with similar skills
Context And Decisions 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Context And Decisions this skillqshanx/docs-governance | 134 | — | ~417 | Automated safety check: Pass | MIT | |
| PR Design DocOpenHands/OpenHands | 90k | — | ~2.4k | Automated safety check: Pass | MIT | |
| Cto AdvisorIbrahim-3d/orchestrator-supaconductor | 381 | 4 repos | ~2.4k | Automated safety check: Pass | MIT | |
| Architecture DecisionDonchitos/Claude-Code-Game-Studios | 26k | — | ~1.7k | Automated safety check: Pass | MIT | |
| Improve Codebase Architectureywwynm/EverythingDone | 144 | 15 repos | ~1.3k | Automated safety check: Pass | GPL-3.0 | |
| Domain Modelingbrim-borium/spotify_sdk | 166 | 5 repos | ~806 | Automated safety check: Pass | Apache-2.0 |
Similar skills
Cto Advisor
Ibrahim-3d/orchestrator-supaconductor
Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.
Architecture Decision
Donchitos/Claude-Code-Game-Studios
Create an ADR documenting a technical decision: context, alternatives considered, consequences.
Improve Codebase Architecture
ywwynm/EverythingDone
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.
Domain Modeling
brim-borium/spotify_sdk
Build and sharpen a project's domain model. An agent skill from brim-borium/spotify_sdk.
Design Doc Mermaid
SpillwaveSolutions/design-doc-mermaid
Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.
More from qshanx/docs-governance
All 10 skills in this repoAgent Entrypoints
qshanx/docs-governance
根据项目事实与已确认讨论生成、精简或审查 AGENTS.md / CLAUDE.md，明确共享规则主文件、可执行约束、PRD / Spec 读取路标和验证入口。用于项目入口只有空模板、规范含糊、双入口冲突或需要设置 Agent 项目说明时。English triggers: AGENTS.md, CLAUDE.md, project instructions, agent entrypoint…
Module Regression
qshanx/docs-governance
大项目模块间联动回归——一份 REGRESSION.md 回归台账登记"每个模块的下游消费者 + 可执行的回归验收命令"，每次改动后照台账跑回归审计，防"改一个模块悄悄弄坏其他模块"。判决靠退出码，不靠 AI 看着没问题。中文触发：模块回归、回归台账、回归审计、改A坏B、模块联动检查、影响面检查、模块牵连、下游验证、大项目改动检查。English triggers: module…
Contract First
qshanx/docs-governance
分前端/后端（或多个服务）多端开发的项目，用 CONTRACT.md 指向的唯一机器契约，各端只照它各做各的，防止字段漂移导致集成时白屏。支持单会话多 agent 和多终端各自跑两种模式。只要项目有前后端/多服务、接口字段老对不上、各端联调卡住、某端改了字段忘了通知别人、或前端为渲染一个页面要调一堆接口拼数据，就用这个…
Docs Governance
qshanx/docs-governance
作为面向长期 AI 协作项目的知识、决策与验证治理总入口，把优秀 Agent 的一次性工作沉淀为可继承、可验证、可持续演进的项目集体能力；根据用户意图把任务路由到活文档、领域上下文与 ADR、变更影响、接口契约、测试资产、模块回归或闭环设计能力，并在大型变更中组织正确顺序。用于用户只说“文档治理”“项目治理”“帮我整理项目知识”“改完怎么收尾”而未指定具体…
Living Docs Governance
qshanx/docs-governance
把长期项目的文档当成一个小系统来维护，防止文档腐烂——四份各司其职的脊柱文件（CLAUDE.md 共享章程 / CLAUDEMAP.md 地图 / PROJECTSTATUS.md 健康仪表盘 / PROJECTLOG.md 流水账）+ Codex 的 AGENTS.md 入口桥接 + 固定读序，并按需连接 ARCHITECTURE、CONTEXT、ADR、契约、测试、回归和 Issue…
Loop Design Check
qshanx/docs-governance
把一个任务"写成"一个目标导向的 loop，并"检查"这个 loop 写得对不对、会不会跑飞——防止空转烧钱 / Goodhart 作弊 / 把错的干到底。两个动作：① 写 loop（先做减法判该不该建 → 定可判定目标 → 选回路类型 → 选骨架）② 体检 loop（过五个崩法 + 可判定性 + 边界 + 降级 + judge 独立 + 判断留人红线）。中文触发：写 loop、设计…
Related
Categories
Questions about Context And Decisions
What does Context And Decisions do?
管理项目稳定领域上下文与难回退决策：按需建立边界严格的 CONTEXT.md，并用 docs/adr/README.md 统一索引、一项决策一个 ADR 文件。用于领域术语反复解释、同词异义、架构或数据库选型、认证/部署/数据模型/API 版本策略、需要记录为什么这样做及如何退出时。English triggers: domain context, context governance…. Context And Decisions is an agent skill from qshanx/docs-governance.md 统一索引、一项决策一个 ADR 文件。用于领域术语反复解释、同词异义、架构或数据库选型、认证/部署/数据模型/API 版本策略、需要记录为什么这样做及如何退出时。English triggers: domain context, context governance, architecture decision record, ADR, database decision, architectural decision.
When should I use Context And Decisions?
Context And Decisions fits situations like: tasks that involve Architecture decision records.
How do I install Context And Decisions in Claude Code?
Run `npx skills add qshanx/docs-governance --skill context-and-decisions -a claude-code`. Or copy the skill folder (skills/context-and-decisions in qshanx/docs-governance) into .claude/skills/context-and-decisions in your project. Claude Code loads it when a task matches its description.
How do I install Context And Decisions in Codex?
Run `npx skills add qshanx/docs-governance --skill context-and-decisions -a codex`. Or copy the skill folder (skills/context-and-decisions in qshanx/docs-governance) into .agents/skills/context-and-decisions in your project. Codex loads it when a task matches its description.
Can I use Context And Decisions 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 qshanx/docs-governance --skill context-and-decisions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/context-and-decisions, .gemini/skills/context-and-decisions, .github/skills/context-and-decisions and .opencode/skills/context-and-decisions in your project.
What does Context And Decisions need to run?
SKILL.md names no scripts, command-line tools or credentials: Context And Decisions is instructions for the agent only.
Does Context And Decisions 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 Context And Decisions 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 Context And Decisions use?
Context And Decisions is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Context And Decisions use?
About 417 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Context And Decisions?
Skills that share tags, products or a category with Context And Decisions: PR Design Doc (OpenHands/OpenHands, 90k stars), Cto Advisor (Ibrahim-3d/orchestrator-supaconductor, 381 stars), Architecture Decision (Donchitos/Claude-Code-Game-Studios, 26k stars) and Improve Codebase Architecture (ywwynm/EverythingDone, 144 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Context And Decisions?
qshanx (a GitHub user) maintains it in qshanx/docs-governance, which has 134 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 9, 2026.
Source: qshanx/docs-governance on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.