docs(agents): keep one-off investigation tooling and raw data out of the repository
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 76/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
調査の方向性
既存の AGENTS.md のガイダンスと、docs/plugin-philosophy.md の指示の経済性に関するセクションを読みます。この issue では、関連する根拠として ADR 0056 と Playwright skill の ## Gotchas が示されています。ルールを AGENTS.md に記載するか、別の場所に記載するかを判断し、ハーネスを再実行する場合の例外と、この issue の根拠への引用を含む1行のルールを追加します。両方の受け入れ基準を満たしたら完了です。
索引モデルが issue の本文から書いたものです。
説明
Problem
Agents doing a one-off investigation (a benchmark, an evaluation, a spike) commit the harness and its raw output alongside the conclusion. Nothing in AGENTS.md says where that material belongs, so it lands in the repository, sometimes inside a shipped plugin directory, where every install carries it.
Observed stumble
- melodic-software/claude-code-plugins#6477 committed a browser-CLI benchmark under
plugins/testing/benchmarks/browser-tools/: 52 files, including a fixture server, CDP drivers, graders, run logs, and a parser with tests. The benchmark ran once to answer one question. The answer (keep playwright-cli, don't adopt agent-browser) was already recorded in ADR 0056 and the playwright skill's## Gotchas. - melodic-software/claude-code-plugins#6525 removed it again. That took a second PR, a
bump: nonechangelog fragment, a spell-check exclusion cleanup, a CHANGELOG entry, and edits to every reference that cited the deleted results file.
This meets the instruction economy bar: the model didn't follow this unaided, and the cleanup cost more than one standing line.
Proposal
Add one line to AGENTS.md, roughly:
One-off investigation tooling and raw data (benchmarks, spikes, evaluation harnesses, run logs) stay in the session scratchpad; commit only the conclusion, to the ADR, doc, or skill that uses it. Commit a harness only when something re-runs it (a CI lane, a schedule, a skill action).
Open questions for whoever picks this up:
- Is a line in
AGENTS.mdthe right surface, or should a CI check also flag new non-shipped directories (such asbenchmarks/) underplugins/*/? - Should "commit only the conclusion" name where reproduction notes go when a result needs to be re-checkable (for example, a short method section in the ADR)?
Acceptance criteria
-
AGENTS.md(or the surface chosen above) states the rule in one line, with the exception for re-run harnesses. - The line cites this issue's evidence, per the instruction-economy rule.
Generated by Claude Code
- 主要言語
- Shell
- スター
- 22
- フォーク
- 2
- 平均マージ
- 5時間 15分
- マージ済み PR（30日）
- 833
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
melodic-software/claude-code-plugins のほかの issue
-
good first issue needs-triage priority: medium
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
melodic-software/claude-code-plugins#6631 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
melodic-software/claude-code-plugins#6547 ·
メンテナーはふだん 1 日以内に返信
-
test_comment_census.py: SccArgv flag-shaped-filename test errors on Windows (#!/bin/sh scc shim)オープンgood first issue needs-triage priority: low
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
melodic-software/claude-code-plugins#6532 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
good first issue needs-triage priority: low
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
melodic-software/claude-code-plugins#6390 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
good first issue needs-triage priority: low
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
melodic-software/claude-code-plugins#6386 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
melodic-software/claude-code-plugins の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
aws-samples/appmod-blueprints#972 ·
メンテナーはふだん 1 日以内に返信
-
status:needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
メンテナーはふだん 1 日以内に返信
-
out-of-date
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
CachyOS/CachyOS-PKGBUILDS#1965 ·
メンテナーはふだん 1 日以内に返信
-
enhancement good first issue help wanted
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
Sorogate/example-consumer#14 ·