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

docs: agent-instruction files carry a few owner/machine-only lines that mislead an outside contributor's AI

Abierto Apto para principiantes
  • ¿Algo no está bien?
#1,277 4 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
70/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Área
documentation

Línea de trabajo

El issue enumera archivos y líneas específicos para editar: EigenAttic/CLAUDE.md línea 39, EigenScript/.claude/rules/test-suite.md líneas 260 y 385-389, y ouroboros/CLAUDE.md, DMG/CLAUDE.md, EigenMiniSat/CLAUDE.md para las cifras de rendimiento. Comience localizando estos archivos en el repositorio. Revise el contexto alrededor de cada línea para comprender la redacción actual. Reemplace las rutas y referencias específicas del propietario con instrucciones generales o hardware nombrado. Verifique los cambios revisando los archivos en busca de detalles específicos de máquina que queden.

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

Descripción

area:docs good first issue kind:docs-drift

The committed agent-instruction files (all */CLAUDE.md and */.claude/**: 30 files, 3,234 lines) are mostly general project knowledge. Measured 2026-09-23: about 1% (36 lines) is specific to the owner's machine and setup, and about 3% (122 lines) is incident history (dates, critic rounds, issue refs). A few lines actively mislead an outside contributor's AI:

  1. EigenAttic/CLAUDE.md:39: EIGS=${EIGENSCRIPT_BIN:-/home/jon/EigenScript/src/eigenscript}. A default path that exists only on the owner's box, and even there it is a stale clone. Default to eigenscript on PATH or the sibling ../EigenScript.
  2. EigenScript/.claude/rules/test-suite.md:260: "There is a real bash 3.2 on the dev box: ~/.local/bin/bash32. Use it." Rewrite it as "test with bash 3.2 where available; the macOS CI lane runs it regardless".
  3. EigenScript/.claude/rules/test-suite.md:385-389: relies on bash_guard (a hook that exists only on the owner's machine) to deny pkill -f. State the rule plainly: never kill by pattern; kill the pid you spawned.
  4. "this box" / "dev box" performance figures in ouroboros/CLAUDE.md, DMG/CLAUDE.md and EigenMiniSat/CLAUDE.md: name the machine ("measured on an ASUS X540NA, Celeron N3350"), or point to where the figures live.

Legitimately specific, keep as they are: EigenOS's T3200 instructions (the project's target hardware) and EigenGauntlet's "defaults run fast on the X540NA" (a stated project target).

Docs-only; ruleset repos go through a PR. Split out of the #1264/#1275 work per the out-of-scope rule.

Done when

Line numbers in the issue have drifted since it was filed: search for the quoted text. One PR per repo; docs-only, no build needed.

  • EigenAttic/CLAUDE.md defaults EIGS to eigenscript on PATH or ../EigenScript/src/eigenscript; no /home/jon path remains.
  • EigenScript/.claude/rules/test-suite.md: the "real bash 3.2 on the dev box" line says "test with bash 3.2 where available; the macOS CI lane runs it regardless", and the pkill -f passage states the rule ("never kill by pattern; kill the pid you spawned") without relying on bash_guard. Same fix for the ~/.local/bin/bash32 sentence in docs/CI.md (the [99zb] row).
  • Private-repo references: the EigenOS link in docs/FREESTANDING.md line 5 is unlinked or marked "(private)"; CLAUDE.md marks iLambdaAi and eigen-site "(private)"; the "iLambdaAi saw ~22%" claim in README.md is dropped or restated on a public workload; docs/FREESTANDING.md's "30 HAL-root symbols the EigenOS kernel owes" states the contract in the doc itself.
  • "this box" / "dev box" measurements use the worst-case-target wording (owner's decision, 2026-09-23) in docs/CI.md, docs/PERFORMANCE.md, ouroboros/CLAUDE.md, DMG/CLAUDE.md, EigenMiniSat/CLAUDE.md and EigenMiniSat/docs/EIGENSCRIPT_FEEDBACK.md. grep -niE 'this box|dev box' over those files returns nothing, apart from the kept exceptions named in the issue.
  • tools/docs_claims_check.sh (or make precheck) passes on the EigenScript PR.
Lenguaje dominante
C
Estrellas
3
Forks
7
Merge medio
4 h 7 min
PR fusionados (30 d)
112

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

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 InauguralSystems/EigenScript

Todos los issues de InauguralSystems/EigenScript

Issues similares

Más issues de C

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.