Skip to content
This repository was archived by the owner on Oct 17, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@

- `README.md` and `README.zh-CN.md` are human-facing. Read them only when changing public usage or installation behavior.
- Runtime behavior is defined by `SKILL.md`, `skills/`, `agents/`, `references/`, and `scripts/`.
- Bundled method Skills and the Agent profiles that load them are one portable runtime contract;
installation and validation must add or remove both sides together. Self-contained Agent profiles
have no bundled Skill half.
- Skills and Agent profiles are managed independently. An Agent profile may load a bundled Skill,
and a bundled Skill may remain available without a dedicated Agent profile; keep each source
inventory and its installed projection in sync.
- This repository is the source of truth for portable runtime behavior. Installed Skills, Agents,
and global rules are deployment artifacts; task-package language, machine-specific routing, and unrelated Hook registration stay outside the repository.
- The target local platforms are macOS and native Windows. Claim support only after both CI
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ The repository is the only source of truth for its portable Skills, Agents, inst

## Who it is for

This release targets Codex on macOS and native Windows for reusable exploration, research, implementation, prototype, debugging, and focused-review agents. A release candidate is supported only after both platform CI jobs pass.
This release targets Codex on macOS and native Windows for reusable exploration, research, implementation, debugging, and focused-review agents, plus a standalone prototype Skill. A release candidate is supported only after both platform CI jobs pass.

Installation uses one deterministic, dry-run-first Python implementation on both platforms. An Agent may operate it after reading `INSTALL.md`, but it does not reconstruct the filesystem projection itself.

Expand All @@ -136,9 +136,9 @@ worker. Use risk-appropriate reviewers, and do not take over silently if a worke
- A root-task orchestration Skill that owns delegation briefs, local write leases, Worktree Root coordination, acceptance, and reusable Agent execution.
- An explicit, current-root-only manager-only branch with adaptive strong delegation and no silent code-work takeover.
- An independent `codex-review-gate` Skill that defines the PR/merge R0–R3 route and authorizes only its selected read-only Reviewers; the review-owning root handles classification and authorized remediation; the merge-owning root retains integration.
- The complete `diagnosing-bugs` and `prototype` method Skills used by their corresponding writable Agents.
- The complete `diagnosing-bugs` method Skill used by its writable Agent, plus the standalone `prototype` Skill.
- Read-only explorer, official-reference research, web research, expert, and focused-review agents.
- Writable implementation, debugging, and prototype workers governed by a per-root single-writer lease.
- Writable implementation and debugging workers governed by a per-root single-writer lease.
- No project Hook; tool schemas own call mechanics, the Skill owns orchestration policy, and Agent profiles own derived-agent scope.
- One small, managed global `AGENTS.md` block that independently routes subagent execution and code-change Review without replacing personal instructions.
- A local, optional model-routing file. No model IDs are pinned in the repository.
Expand Down
6 changes: 3 additions & 3 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ python3 scripts/install.py --uninstall --apply

## 适合谁

当前版本以 macOS 和原生 Windows 上的 Codex 为目标,提供可复用的代码探索、资料研究、正式实现、原型、疑难 Bug 和专项 Review 子代理。候选版本只有在两个平台的 CI 都通过后才声明受支持。
当前版本以 macOS 和原生 Windows 上的 Codex 为目标,提供可复用的代码探索、资料研究、正式实现、疑难 Bug 和专项 Review 子代理,并保留独立的 prototype Skill。候选版本只有在两个平台的 CI 都通过后才声明受支持。

安装在两个平台上共用一个确定性、默认 dry run 的 Python 实现。Agent 可以在完整阅读 `INSTALL.md` 后代为运行,但不再自行重建文件投影。

Expand All @@ -117,9 +117,9 @@ python3 scripts/install.py --uninstall --apply
- 负责委派简报、本地写入租约、Worktree Root 协调、验收和通用 Agent 执行的根任务编排 Skill。
- 一个显式、仅当前根任务生效的 manager-only 分支,提供自适应强委派并禁止静默接管代码工作。
- 独立定义合并前 R0–R3 路由、且只授权所选只读 Reviewer 的 `codex-review-gate` Skill;分级、整改和集成由合并负责人执行。
- `diagnosing-bugs` 和 `prototype` 两份由对应可写 Agent 使用的完整方法 Skill。
- 由可写 Agent 使用的完整 `diagnosing-bugs` 方法 Skill,以及独立可用的 `prototype` Skill。
- 只读代码探索、官方资料研究、Web 研究、专家和专项 Review Agent。
- 受每个根任务单 Writer 租约约束的实现、Bug 诊断和原型 Worker。
- 受每个根任务单 Writer 租约约束的实现与 Bug 诊断 Worker。
- 不安装项目 Hook;工具 schema 负责调用机制,Skill 负责编排策略,Agent 配置负责派生代理职责边界。
- 一个精简的全局 `AGENTS.md` 受控块:分别路由子代理执行与代码变更 Review,同时不替换个人指令。
- 可选的本地模型路由文件;仓库不固定任何模型 ID。
Expand Down
12 changes: 0 additions & 12 deletions agents/prototype-worker.toml

This file was deleted.

9 changes: 5 additions & 4 deletions docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,10 +39,11 @@ of installation.
Codex plugin packaging is not the suite authority because plugins do not replace the separate
custom-Agent projection.

The `skills/diagnosing-bugs` and `skills/prototype` directories contain the complete method Skills
loaded by their corresponding writable workers. The read-only `simplicity-reviewer` embeds its
focused review method directly in its Agent profile. Agent profiles retain authority and
orchestration boundaries; bundled method Skills provide the detailed writable task workflows.
The `skills/diagnosing-bugs` directory contains the complete method Skill loaded by its writable
worker. The `skills/prototype` Skill remains independently installable without a dedicated Agent
profile. The read-only `simplicity-reviewer` embeds its focused review method directly in its Agent
profile. Agent profiles retain authority and orchestration boundaries; bundled Skills provide
task workflows when useful.

Every Codex task is a root for its own agent tree. Derived agents remain non-orchestrators, while a
Worktree Root is an independent task and session with the same local orchestration authority as any
Expand Down
8 changes: 1 addition & 7 deletions scripts/validate.py
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@
"prototype": ROOT / "skills" / "prototype",
}
THIRD_PARTY_SKILLS = {"diagnosing-bugs", "prototype"}
WRITERS = {"worker", "diagnosing-bugs-worker", "prototype-worker"}
WRITERS = {"worker", "diagnosing-bugs-worker"}
REVIEWERS = {
"architecture-reviewer",
"correctness-reviewer",
Expand Down Expand Up @@ -1081,12 +1081,6 @@ def validate_source() -> list[str]:
"diagnosing-bugs-worker does not load its method Skill",
failures,
)
require(
"load the `prototype` Skill"
in (ROOT / "agents" / "prototype-worker.toml").read_text(encoding="utf-8"),
"prototype-worker does not load its method Skill",
failures,
)
simplicity_reviewer = profile_instructions.get("simplicity-reviewer", "")
simplicity_order = [
simplicity_reviewer.find(phrase) for phrase in SIMPLICITY_REVIEW_ORDER_PHRASES
Expand Down
Loading