Bản gốc tiếng Anh: https://argusic.com/subject/keep-the-why
keep-the-why
Lớp "tại sao" của bộ nhớ dự án gắn với repo: lý do đằng sau codebase dưới dạng Markdown trong repo, được quản lý phiên bản bằng Git, dành cho coding agent và con người, để không điều gì đã bị từ chối lại được đề xuất lần nữa. Không cơ sở dữ liệu, không daemon, không tài khoản.
Chạy đượcnguồn: GitHubtrang chủ dự ánJavaScriptMITcommit 8268a33c00ba
JavaScript, giấy phép MIT. Dự án tự gắn nhãn: agent skills, ai agents, architecture decision records, coding agents, context engineering, developer tools, documentation và git.
keep-the-why chạy được. Trên một máy sạch không có GPU, một agent của Argusic đã cài đặt nó trong 2 phút, không gặp lỗi nào, và toàn bộ phiên làm việc được ghi lại.
keep-the-why-lint 0.20.0.0 and keep-the-why-dashboard 0.7.3 are installed and functional. The linter validates this project's context/ (0 errors, 0 warnings, schema 0.20.0). The dashboard serves its UI at localhost:8765 (HTTP 200), exports static pages, and both packages' test suites pass completely (116+61+65 = 242 tests).
Kết quả agent đạt được trên máy sạch, bằng chính lời của nó. Cách đo
Argusic đo trên một máy mới mỗi lần. Mỗi con số đều link tới bằng chứng của nó. Điểm Argusic 100 trên 100 (trung bình điểm các lần chạy của dự án này).
Tóm tắt
Dữ liệu dự án lấy từ GitHub, có link ở đầu trang, cập nhật . Dữ liệu test của Argusic (CC BY 4.0); mỗi con số đều link tới một trang run có đầy đủ log, bản ghi và mã sha256 của chúng.
Những gì đã đo
Lấy từ lần chạy quyết định kết luận này. Mỗi dòng là một giá trị được ghi lại, không phải ước tính.
- Thời gian cài đặt
- 2 phút
- Từ máy sạch đến khi xong
- 4 phút
- Lỗi gặp và đã sửa
- gặp 0, tự sửa 0 mà không cần người giúp
- Cách chứng minh kết quả
- ktw-lint . returned 0 errors, 0 warnings; ktw-dashboard --json produced valid state with 130 entries; ktw-dashboard server responded HTTP 200; pytest lint/tests/ returned 116 passed; pytest dashboard/tests/ returned 61 passed; pytest tools/evals/tests/ returned 65 passed. Export generated index.html, state.json, badge-entries.svg.
- Số token model đã dùng
- 232.871
- Commit chính xác đã test
- 8268a33c00ba
- Container image
- sha256:cdd920bce783
Những gì chưa đo
Nửa còn lại, để bạn thấy rõ bằng chứng này đi xa tới đâu. Chỗ trống được ghi là chỗ trống và không bao giờ được lấp vào.
- Bộ nhớ GPU cao nhất
- lần này chạy trên máy CPU, nên không có GPU để đo
- Hoạt động khi chạy lâu
- mỗi lần thử dùng cấu hình nhỏ nhất có trong tài liệu và một khoảng thời gian cố định, nên đây là đo xem nó có chạy hay không, không đo nó chịu tải ra sao
Đoạn cuối của bản ghi
Những dòng cuối của phiên terminal đã quyết định kết luận này, đúng như khi được ghi lại.
=== Dashboard version === ktw-dashboard 0.7.3 === Lint version === ktw-lint 0.20.0.0 === Build time calc === Started around 2026-10-29 11:00:17 Good. The total time spent is about 2 minutes. Let me calculate more precisely and compile the fina… Here is the final summary: tokens used 232,871 Good. The total time spent is about 2 minutes. Let me calculate more precisely and compile the fina… Here is the final summary:
Xem lại toàn bộ phiên, mọi lệnh từ máy sạch tới thời điểm này.
Cách test
Một agent, một container, không có người giúp. Agent cài dự án theo đúng cách tài liệu của dự án hướng dẫn, chạy nó, và sửa những gì bị hỏng. Mọi thứ bên dưới được ghi lại đúng như đã diễn ra: phiên terminal, log và commit chính xác. Toàn bộ phương pháp.
Điểm mạnh và giới hạn
Dữ kiện đo được, không phải ý kiến. Cách viết nội dung.
Những gì suôn sẻ
- Đạt trạng thái chạy được trên máy sạch, có ghi lại phiên làm việc.
- Cài đặt trong 2 phút, nhanh hơn trung vị của 106 dự án tương đương mà Argusic đã đo.
- Không có gì hỏng trên đường đi: không lỗi nào từ lúc clone đến lúc chạy.
- Chạy được không cần GPU, nên không cần GPU để khởi động.
- Giấy phép MIT, theo thông tin từ nơi lưu trữ dự án.
Những gì không suôn sẻ, hoặc chưa biết
- Mới đo một lần. Một lần thử cho thấy nó có thể chạy, chưa cho thấy nó chạy ổn định.
Trong 107 dự án agent-skills mà Argusic đã cài đặt và bấm giờ, keep-the-why đứng thứ 35 về tốc độ đạt trạng thái chạy được, và 78 trên 107 dự án đạt được trạng thái đó.
Phù hợp để dùng cho
- Thử trên laptop hoặc máy chủ nhỏ: nó đạt trạng thái chạy được mà không cần GPU.
- Đánh giá nhanh: nó đã chạy 2 phút sau khi clone.
- Làm theo README của chính dự án: cách làm trong tài liệu chạy được mà không phải sửa gì.
Cũng đã test, cùng lĩnh vực
Mỗi dự án ở đây đều được Argusic cài đặt và chạy trên máy sạch. Không có dự án nào chưa test xuất hiện ở đây.
Lịch sử chạy
Chủ đề (từ GitHub)
agent-skillsai-agentsarchitecture-decision-recordscoding-agentscontext-engineeringdeveloper-toolsdocumentationgitknowledge-managementllm-agentsproject-memoryrepo-local-memoryrepo-native
Nhúng badge
Markdown cho README của dự án. Badge link về trang này; điều khoản ở trang điều khoản.
[](https://argusic.com/subject/keep-the-why)Câu hỏi
- keep-the-why có chạy được không?
- Có. keep-the-why chạy được. Argusic đã cài đặt và khởi chạy nó trên một máy sạch trong 2 phút, gặp 0 lỗi trên đường đi, và ghi lại phiên làm việc.
- Argusic đã test keep-the-why như thế nào?
- Trên một máy mới, dùng một lần, mọi lệnh đều được ghi lại và repo được ghim ở commit 8268a33c00ba. Có một lần thử được ghi lại, và toàn bộ phương pháp nằm ở trang phương pháp.
- Test keep-the-why tốn bao nhiêu?
- Lần chạy đưa ra kết luận này tốn 0,04 USD: chi phí máy và model thật, không phải giá niêm yết theo triệu token. Con số được ghi trên trang của lần chạy đó.
- Cài đặt keep-the-why mất bao lâu?
- 2 phút trong lần chạy quyết định kết luận này, từ máy sạch đến trạng thái chạy được. Đó là một lần thử đo được, không phải số trung bình.
- keep-the-why có cần GPU không?
- Không cần để khởi động. Argusic đã đạt trạng thái chạy được trên một máy không có GPU.
- Cài đặt keep-the-why thì gặp lỗi gì?
- Không có lỗi nào trong lần chạy được ghi lại: không lỗi nào từ lúc clone đến lúc chạy.
- keep-the-why so với các lựa chọn khác thế nào?
- Trong 107 dự án agent-skills mà Argusic đã cài đặt và bấm giờ, keep-the-why đứng thứ 35 về tốc độ đạt trạng thái chạy được, và 78 trên 107 dự án đạt được trạng thái đó.
- Bằng chứng cho keep-the-why ở đâu?
- Lần chạy được ghi lại nằm trên trang này, mỗi lần link tới log đầy đủ và terminal recording, được lưu kèm dấu vân tay sha256 để không thể bị sửa lén.