Distribution Scope

May 29, 2026 · View on GitHub

最終更新: 2026-05-14

この文書は claude-code-harness の「repo には存在するが、Claude Code plugin の配布 payload には載せないもの」を明文化する scope table です。 Plans.md、README、.gitattributes、配布スクリプト、検証スクリプトで迷ったら、この表を正本として扱います。

Scope Table

Path	Status	Why it exists	Enforcement signal
`.claude-plugin/`	Distribution-included	Claude Code plugin manifest / hooks / settings	`claude plugin validate`, `test-distribution-archive.sh`
`.cursor-plugin/`	Source-repo adapter only	Cursor adapter candidate manifest; not Claude plugin archive payload	`.gitattributes export-ignore`, `test-distribution-archive.sh`
`.codex-plugin/`	Source-repo adapter only	Codex adapter manifest; not Claude plugin archive payload	`.gitattributes export-ignore`, `test-distribution-archive.sh`
`bin/harness*`	Distribution-included	Go-native guardrail / lifecycle runtime	`validate-plugin`, `go test`, archive required entries
`skills/`	Distribution-included	Claude Code 用 primary skill surface	`validate-plugin`, mirror sync checks
`agents/`	Distribution-included	worker / reviewer / advisor	`validate-plugin`, agent frontmatter tests
`hooks/`, `monitors/`	Distribution-included	実行時 hook / monitor definitions	`hooks/hooks.json`, `validate-plugin`
`output-styles/`	Distribution-included	Claude Code output style	`plugin.json`, archive required entries
`templates/`, `workflows/`	Distribution-included	project init / rules / workflow templates	`check-consistency.sh`, template registry checks
`scripts/` runtime files	Distribution-included	hook handlers, setup, sync, review, plan, loop runtime	`validate-plugin`, runtime hook tests
`assets/`, public `docs/`	Distribution-included	README assets and public user documentation	README claim drift checks
`commands/`	Compatibility-retained	旧 slash command 資産。存在する場合のみ検証	`validate-plugin`
`codex/`, `opencode/`, `skills-codex/`	Source-repo mirror only	代替クライアント向け mirror / setup 導線。Claude plugin archive には載せない	`test-codex-package.sh`, `opencode-compat.yml`, `.gitattributes`
`go/`, `tests/`, `benchmarks/`, `.github/`	Development-only and distribution-excluded	source / CI / benchmark / validation	`.gitattributes`, `test-distribution-archive.sh`
`.claude/`, `.cursor/`, `CLAUDE.md`, `AGENTS.md`, `Plans.md`	Development-only and distribution-excluded	repo-local agent context, local plans, editor setup	`.gitattributes`, `test-distribution-archive.sh`
`.private/`	Local-only and distribution-excluded	`skills/` 直下に置くと `claude --plugin-dir .` の inventory に出る private/dev-only skills の退避先	`.gitignore`, `test-public-plugin-inventory.sh`
`scripts/ci/`, `scripts/evidence/`, `scripts/sandbox-test/`	Development-only and distribution-excluded	CI helpers, evidence fixtures, local sandbox examples	`.gitattributes`, `test-distribution-archive.sh`
`mcp-server/`	Development-only and distribution-excluded	オプション機能。repo では開発・調査用に残すが配布 payload には含めない	`.gitignore`, `.gitattributes`, CHANGELOG history
`harness-ui/`, `harness-ui-archive/`, `remotion/`	Development-only and distribution-excluded	optional UI / video experiments and archives	`.gitignore`, `.gitattributes`, CHANGELOG history
`docs/research/`, `docs/private/`, `docs/notebooklm/`, `docs/slides/`, `docs/presentation/`, `docs/social/`	Private or generated reference	調査記録、公開前の下書き、生成中間物	`.gitignore`, `.gitattributes`, `test-distribution-archive.sh`

Current Decisions

commands/ は削除済み扱いにしない。現在は Compatibility-retained。
codex/ / opencode/ は repo 上の mirror として検証対象だが、Claude Code plugin archive からは除外する。
.codex-plugin/ / .cursor-plugin/ は adapter metadata であり、Claude Code plugin archive payload ではない。host-specific install package は scripts/build-host-plugin-dist.sh で生成する。
.claude/ / .cursor/ / CLAUDE.md / AGENTS.md / Plans.md は repo-local context であり、plugin payload ではない。
private/dev-only skills は skills/ 配下に置かない。.gitignore されていても claude --plugin-dir . の local inventory には露出するため、.private/skills/ など public plugin surface の外へ退避する。
mcp-server/ は削除済み扱いにしない。現在は Development-only and distribution-excluded。
scripts/hook-handlers/memory-bridge.sh と memory-*.sh は local bridge でも Distribution-included。hook が参照するため、repo に tracked されている必要がある。
README や Plans.md で「削除」と書く場合は、実際に tree から消えたときだけ使う。
「配布外」「互換維持」「開発専用」はこの文書のラベルに合わせて使い分ける。

Update Rule

次のいずれかが起きたら、この表も同じ PR / commit で更新すること。

README の architecture / install / compatibility 説明を変更したとき
.gitignore や build script の除外規則を変更したとき
commands/ や mcp-server/ など、存在理由が誤解されやすいディレクトリの扱いを変えたとき
.gitattributes の export-ignore や tests/test-distribution-archive.sh の required / forbidden list を変更したとき