briefbound-project-review

briefbound-project-review is a skill for Claude Code, Codex from CCDawn/codex-skills. It costs 55 tokens per session (1,071 once invoked), scanned A, original, MIT.

A read-only health review of a whole code repository or a clearly defined subsystem. It examines code, architecture, tests, dependencies, configuration, release concerns, and maintainability using evidence from the project.

In plain words
What is it for?
It is for repository reviews, architecture and technical-debt checks, test-coverage assessment, risk-module discovery, onboarding checks, and deciding what to fix first.
Why use it?
It helps reveal the issues most likely to cause failed work, accidental changes, or poor user value before planning a refactor, taking over a project, or setting priorities.

Skill for Claude CodeCodex

Written for Claude Code and Codex: shipped in a Claude Code plugin, but also agents/openai.yaml present.

Part of the briefbound-skills plugin — 30 skills shipped together

Good fit It is for repository reviews, architecture and technical-debt checks, test-coverage assessment, risk-module discovery, onboarding checks, and deciding what to fix first.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/ccdawn/codex-skills/briefbound-project-review
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add CCDawn/codex-skills --skill briefbound-project-review
Clone the repo
git clone --depth 1 https://github.com/CCDawn/codex-skills

Made for: Claude Code, Codex.

Or install briefbound-skills, the plugin that ships this one along with the rest of its 30 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for briefbound-project-review

README.md
[![agentmods](https://agentmods.dev/badge/skills/ccdawn/codex-skills/briefbound-project-review/github.svg)](https://agentmods.dev/skills/ccdawn/codex-skills/briefbound-project-review)
Your own site
<a href="https://agentmods.dev/skills/ccdawn/codex-skills/briefbound-project-review"><img src="https://agentmods.dev/badge/skills/ccdawn/codex-skills/briefbound-project-review/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for briefbound-project-review

Your own site · 80×15
<a href="https://agentmods.dev/skills/ccdawn/codex-skills/briefbound-project-review"><img src="https://agentmods.dev/badge/skills/ccdawn/codex-skills/briefbound-project-review.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 55 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,071 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00055 $0.01071
Opus 5 $0.00028 $0.00535
Sonnet 5 $0.00011 $0.00214
Haiku 4.5 $0.00006 $0.00107

Measured 9d ago against content hash 01dce76db78f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

briefbound-project-review scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/engineering/briefbound-project-review/SKILL.md · 68 lines

What it actually says

Briefbound Project Review

目标

对整仓或明确子系统做只读、证据化审查,找出最影响完成率、误改率和用户价值的问题。PR/diff 使用 briefbound-pr-review,具体 bug 使用 briefbound-bug-review

Briefbound task contract

  • Context Boundary: 审查范围、实际读取的入口/模块/测试/配置/git/运行证据和排除范围。
  • Output Contract: 项目健康结论、风险排序 findings、可连续执行的修复顺序和 Route Out。
  • Allowed Action: 默认只读;不编辑文件、移动分支或修改 index。用户要求修复时由 Briefbound Router 建立执行契约。
  • Success Evidence: finding 绑定文件/命令/运行证据、影响、最小动作和验证条件。
  • Stop Condition: 范围不明、对象变成 PR/具体 bug、关键证据缺失、需要写入或高风险决策。
  • Route Out: briefbound-simplification-auditbriefbound-planningbriefbound-bug-reviewbriefbound-performance-engineeringbriefbound-pr-reviewbriefbound-router 或 BLOCKED。

统一调用契约

  • 只处理 Briefbound task contract 范围;不匹配时回 briefbound-router 或更具体 owner,复合任务不吞其他 owner。
  • 用户可见内容默认中文;保留技术字面量;只报结论、证据、风险和产出;Route Out 仅以 Briefbound task contract 为准,末行写 下一步建议: <一个具体动作>

深度与证据

  • QUICK:目录、README、配置、测试入口和近期 git 信号。
  • STANDARD:默认;增加关键链路、依赖、CI、测试质量和边界。
  • DEEP:接手、重构或高风险发布前;增加热点历史、状态/数据/权限/迁移风险。

不要为了全面扫描全仓。先确认事实源和高信号入口,再沿用户目标钻取 owning modules;证据足以回答审查目标时停止。按需检查架构边界、修改热点、真实行为测试、配置/数据/权限、发布回滚和接续成本,不为未命中的通用清单继续扩读。

Findings

严重度:P0 数据/安全/核心不可用;P1 高风险缺陷或关键契约/测试缺口;P2 明显增加误改和维护成本;P3 非阻塞改进。

每条必须包含:位置或命令证据、具体观察、影响、最小有效动作、验证条件。不得把“项目复杂”“测试不足”“TODO 很多”直接当 finding;孤立实现 bug 不升级为项目 finding,除非证据表明它代表重复模式、架构边界或系统性风险。

Telemetry Gap 与已确认问题分开;WATCHLIST 必须写明升级、降级或关闭所需的日志、指标、测试或时间窗口。

执行顺序

多个 finding 按依赖、用户价值、误改风险和验证成本排序,而不是只推荐一个:

  • SAFE_DIRECT:已有修复许可时依次执行并验证,不逐项询问。
  • PLAN_THEN_EXECUTE:存在设计分叉时先规划,再回到执行。
  • DEFERRED:只记录触发条件。
  • BLOCKED:停止并问一个不可约问题。

只有顺序会改变产品取舍、范围或高风险动作时才让用户选择。只读审查请求本轮停在报告;用户说“继续/开始修复/按顺序修”时从第一个非 Deferred/Blocked 项连续推进。

输出

项目审查: HEALTHY / WATCHLIST / NEEDS_ATTENTION / HIGH_RISK / BLOCKED
范围与关键证据: ...
Findings:
- P0/P1/P2/P3 [位置] 问题;影响;最小动作;验证条件
执行顺序(仅多个后续动作时):
1. <动作> [SAFE_DIRECT/PLAN_THEN_EXECUTE/DEFERRED/BLOCKED]
证据缺口与剩余风险: ...
下一步建议: <一个具体动作>

没有 finding 时明确说明未发现结构性问题,并用一句话说明最重要的未覆盖边界。不默认生成项目地图、矩阵、ledger、完整扫描清单或专项路由清单。

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 68 lines · 55 tokens per session scan A 01dce76db78f

Subscribe to this mod's changes

briefbound-project-review is a skill published in the GitHub repository CCDawn/codex-skills (4 stars, last pushed 27d ago), licensed MIT. It adds 55 tokens to every session and 1,071 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.