docs: add resource evaluation process documentation

Added comprehensive documentation for resource evaluation methodology:

- Appendix C in ultimate-guide.md (line 15034)
  * 5-point scoring system with decision criteria
  * 14 documented assessments by category
  * Transparency on integration decisions
  * Links to full methodology

- Fixed methodologies.md GSD evaluation link
  * Corrected path: claudedocs → docs (public)

- Updated reference.yaml with resource evaluations metadata
  * Directory, count (14), methodology references
  * Appendix and README section line numbers

All resource-evaluations now properly documented and discoverable.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX 2026-01-26 15:10:24 +01:00
parent 893c125fa7
commit 444ce5aa6a
4 changed files with 66 additions and 3 deletions

View file

@ -15031,6 +15031,49 @@ Common misconceptions we've seen:
---
## Appendix C: Resource Evaluation Process
This guide systematically evaluates external resources (tools, methodologies, articles, frameworks) before integration to maintain quality and prevent noise.
### Evaluation Methodology
**5-Point Scoring System** (Critical → Low):
| Score | Action | Timeline |
|-------|--------|----------|
| 5 | Critical - Integrate immediately | <24h |
| 4 | High Value - Integrate within 1 week | 1 week |
| 3 | Moderate - Integrate when time available | Flexible |
| 2 | Marginal - Minimal mention or skip | - |
| 1 | Low - Reject | - |
**Full methodology**: See [`docs/resource-evaluations/README.md`](../docs/resource-evaluations/README.md)
### Current Evaluations
**14 documented assessments** in `docs/resource-evaluations/`:
- **Methodologies**: GSD (Get Shit Done), Vibe Coding patterns
- **Tools**: Worktrunk, AST-grep, SE-CoVe plugin
- **Content**: Boris Cherny Cowork video, ClawdBot Twitter analysis
- **Research**: Prompt repetition papers, self-improvement skills
- **And more**: Nick Jensen plugins, Wooldridge productivity stack
**Browse all evaluations**: [`docs/resource-evaluations/`](../docs/resource-evaluations/)
### Why Public Evaluations?
**Transparency**: Contributors can see exactly why resources were:
- ✅ **Integrated** (score 3+): Added to guide with attribution
- ⚠️ **Mentioned** (score 2): Brief reference without deep coverage
- ❌ **Rejected** (score 1): Documented reason for exclusion
**Quality Control**: Technical review + challenge phase by specialized agents ensures objectivity and prevents marketing hype from influencing decisions.
**Community Contribution**: Evaluation template available in `docs/resource-evaluations/README.md` for suggesting new resources with systematic assessment.
---
## About This Guide
**End of Guide**