Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

docs(agents): keep one-off investigation tooling and raw data out of the repository

Abierto Apto para principiantes
  • ¿Algo no está bien?
#6,535 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
76/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Área
documentation

Línea de trabajo

Lee las directrices existentes de AGENTS.md y la sección sobre la economía de instrucciones en docs/plugin-philosophy.md; el issue identifica las pruebas pertinentes en ADR 0056 y en ## Gotchas de la skill de Playwright. Decide si incluir la regla en AGENTS.md o en otra ubicación y, después, añade una regla de una sola línea con la excepción de volver a ejecutar el harness y una cita a las pruebas de este issue. Se considera terminado cuando se cumplan ambos criterios de aceptación.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

needs-triage

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: none changelog 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.md the right surface, or should a CI check also flag new non-shipped directories (such as benchmarks/) under plugins/*/?
  • 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

Lenguaje dominante
Shell
Estrellas
22
Forks
2
Merge medio
5 h 11 min
PR fusionados (30 d)
838

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de melodic-software/claude-code-plugins

Todos los issues de melodic-software/claude-code-plugins

Issues similares

Más issues de Shell/Bash

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.