Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở Phù hợp với người mới
#1,277 4 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
70/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Lĩnh vực
documentation

Hướng nghiên cứu

Issue liệt kê các tệp và dòng cụ thể cần chỉnh sửa: EigenAttic/CLAUDE.md dòng 39, EigenScript/.claude/rules/test-suite.md dòng 260 và 385-389, và ouroboros/CLAUDE.md, DMG/CLAUDE.md, EigenMiniSat/CLAUDE.md cho các con số hiệu suất. Bắt đầu bằng cách định vị các tệp này trong kho lưu trữ. Xem xét ngữ cảnh xung quanh mỗi dòng để hiểu cách diễn đạt hiện tại. Thay thế các đường dẫn và tham chiếu cụ thể của chủ sở hữu bằng hướng dẫn chung hoặc phần cứng được đặt tên. Xác minh các thay đổi bằng cách kiểm tra các tệp xem có còn chi tiết cụ thể về máy nào không.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
C
Star
3
Fork
7
Merge trung bình
4 giờ 15 phút
Pull request đã merge (30 ngày)
106

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của InauguralSystems/EigenScript

Tất cả issue của InauguralSystems/EigenScript

Issue tương tự

Thêm issue về C

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.