Methodology
Signal Score v1
Signal Score giúp người đọc so sánh nhanh mức độ đánh giá kỹ của từng record — không phải xếp hạng "tool tốt nhất", mà là mức độ bằng chứng và fit với bài toán VN.
Signal Score nghĩa là
- ✓ Đã review public signal (GitHub, HN, Reddit, community VN).
- ✓ Đã đánh giá fit với use case Việt Nam cụ thể.
- ✓ Đã ghi nhận ưu/nhược điểm triển khai thực tế.
- ✓ Có thể so sánh tương đối giữa các record cùng đã review.
Signal Score KHÔNG nghĩa là
- ✗ AltStack đã lab-test thực tế (đó là Evidence Level A — hiếm).
- ✗ "Tool tốt nhất" hay xếp hạng tuyệt đối.
- ✗ Bảo đảm tool chạy được trong hạ tầng của bạn.
- ✗ Score cao = nên dùng ngay; score thấp = bỏ qua.
5 cấu phần — tổng 100 điểm
Trọng số & cách chấm
| Cấu phần | Max | Loại | Tiêu chí chính |
|---|---|---|---|
| Use Case Fit | 25 | judged | ≥3 use case cụ thể, đúng ngành, có con số; workflowStepReplaced rõ. |
| Project Health | 25 | auto | Tự động từ GitHub: liveness (ngày push gần nhất), adoption (stars), momentum (sao/ngày). Archived → 3 điểm. |
| Cost Advantage | 20 | judged | Thay rõ 1 SaaS trả phí + timeOrCostSaved có số/tiền. |
| Deployment | 15 | judged | Hosted/one-click = cao nhất; cần GPU/self-host phức tạp = thấp. |
| Docs | 15 | judged | README đầy đủ + media demo + quickstart chạy được. |
auto = script tính từ GitHub API. judged = người review chấm theo rubric thống nhất.
Trọng số được khai báo một chỗ duy nhất trong src/lib/score.ts.
Evidence Level
Mức độ bằng chứng (A → D)
Mỗi record gắn một mức bằng chứng để người đọc biết đánh giá dựa trên bao nhiêu dữ liệu thực tế.
AltStack đã thử tool thực tế trong workflow nghề, có output kiểm chứng được. Hiếm — chỉ áp dụng từ Phase 2.
Đã review public signal: GitHub, HN, Reddit, community VN, báo cáo bên ngoài. Mặc định cho record đã synthesize kỹ.
Mới ở mức discovery: signal tốt nhưng chưa synthesize đầy đủ. Cần thêm review trước khi tin hoàn toàn.
Chỉ dựa trên tuyên bố của tác giả tool, chưa kiểm chứng. Đọc kỹ signalSources trước khi áp dụng.
Confidence
Độ tin cậy đánh giá
High confidence
Dữ liệu chắc, nhiều nguồn độc lập, đã synthesize kỹ. Các kết luận ít có khả năng thay đổi khi review lại.
Medium confidence
Đủ tin cậy để ra quyết định thử, nhưng một vài điểm dựa trên suy luận. Nên đọc usabilityRisk cẩn thận.
Low confidence
Dữ liệu mỏng hoặc signal chưa nhất quán. Nên đặt nextReviewDueAt gần và dùng làm điểm khởi đầu, không phải kết luận.
Review cadence
Quy trình review định kỳ
Mỗi record có lastReviewedAt (ngày review gần nhất)
và nextReviewDueAt (ngày review tiếp theo dự kiến).
Chu kỳ mặc định: ~1 quý (~90 ngày).
Khi review: chạy lại fetch-signals.mjs lấy
projectHealth mới; kiểm tra lại 4 cấu phần judged
xem có cần điều chỉnh không; cập nhật lastReviewedAt.
Record quá hạn review không tự ẩn — người đọc vẫn thấy, nhưng nên kiểm tra nextReviewDueAt
và lastReviewedAt để biết thông tin còn mới không.
Conflict of interest
Chính sách độc lập
AltStack hiện chưa nhận tài trợ, sponsor, hay affiliate từ bất kỳ tool nào được đánh giá. Khi có quan hệ thương mại trong tương lai, sẽ được ghi rõ trực tiếp trên record liên quan và tách bạch khỏi nội dung đánh giá kỹ thuật. Signal Score và Evidence Level không thay đổi vì lý do thương mại. Đây là cam kết theo PRD §8 của dự án — không phải tuyên bố marketing.