A production-ready bibliography management system for the HUMMBL (Base120) cognitive framework. This repository maintains 260 curated academic and practitioner works organized into 13 thematic tiers, mapped to 6 cognitive transformations.
The HUMMBL cognitive framework identifies six fundamental thinking operations:
- P (Perspective/Identity): Frame and name what is. Anchor or shift point of view.
- IN (Inversion): Reverse assumptions. Examine opposites, edges, negations.
- CO (Composition): Combine parts into coherent wholes.
- DE (Decomposition): Break complex systems into constituent parts.
- RE (Recursion): Apply operations iteratively, with outputs becoming inputs.
- SY (Meta-Systems): Understand systems of systems, coordination, and emergent dynamics.
This bibliography provides the theoretical foundation and empirical evidence for these transformations through carefully selected works spanning systems thinking, cognitive psychology, design, and organizational learning.
| Tier | Domain | Examples |
|---|---|---|
| T1: Canonical | Foundational theoretical works | Meadows, Kahneman, Simon, Pearl |
| T2: Empirical | Peer-reviewed research | Tversky & Kahneman, Klein, Gigerenzer |
| T3: Applied | Practitioner texts | Lean Startup, Design Thinking, DevOps |
| T4: Agentic | AI safety & multi-agent systems | Russell, Amodei, Constitutional AI |
| T5: Engineering | Software patterns for agents | Circuit breakers, stigmergy, BDI, DbC |
| T6: Governance | AI regulation & assurance | EU AI Act, NIST RMF, OWASP LLM Top 10 |
| T7: Emerging | Cutting-edge agent research | ReAct, CoT, RAG, SWE-bench, ToT |
| T8: Cognition | Mental models & knowledge | Craik, Piaget, Zettelkasten, CoP |
| T9: Economics | AI economics & platforms | Coase, Tirole, scaling laws, auctions |
| T10: Collaboration | Human-AI teaming | Licklider, CSCW, shared mental models |
| T11: Security | Adversarial ML & defense | Goodfellow, zero trust, formal verification |
| T12: Complexity | Complex adaptive systems | Holland, Kauffman, networks, cybernetics |
| T13: Reasoning | Advanced reasoning systems | o-series model cards, AlphaCode, Claude |
All 260 entries have abstracts (150-300 words) and HUMMBL transformation tags.
# Clone the repository
git clone https://github.com/hummbl-dev/hummbl-bibliography.git
cd hummbl-bibliography
# Install toolkit dependencies
cd toolkit
npm install
# Validate bibliography
npm run validate
# View statistics
npm run statsThe root package.json is a private delegation shim. After installing
toolkit/ dependencies, root commands such as npm test, npm run validate,
and npm run stats delegate to the toolkit package.
# Validate all bibliography files
npm run validate
# Check for duplicates
npm run check-dups
# Generate statistics report
npm run stats
# Extract HUMMBL transformation keywords
npm run keywords
# Find missing DOIs
npm run find-dois
# Run full test suite
npm testBased on latest analysis (April 2026):
- Total Entries: 260 unique works across 13 tiers
- Transformation Coverage (tag count across all entries):
- SY (Synthesis): 152
- CO (Composition): 119
- RE (Recursion): 117
- DE (Decomposition): 108
- IN (Inversion): 101
- P (Perspective): 80
- Quality Metrics:
- 100% have abstracts (150-300 word scholarly annotations)
- 100% have HUMMBL transformation mappings
- 70.8% have DOIs (184/260)
- 27.7% have ISBNs (72/260)
- 0 validation errors, 0 duplicates
Each bibliography entry is tagged with one or more HUMMBL transformations based on its primary cognitive contributions:
@book{Meadows2008ThinkingSystems,
title = {Thinking in Systems: A Primer},
author = {Meadows, Donella H.},
year = {2008},
publisher = {Chelsea Green Publishing},
isbn = {978-1603580557},
abstract = {...},
keywords = {systems thinking, HUMMBL:SY, HUMMBL:RE, HUMMBL:CO}
}For detailed guidance on mapping new entries, see docs/TRANSFORMATION_GUIDE.md.
The repository includes a comprehensive Node.js toolkit for bibliography management:
| Script | Purpose |
|---|---|
validate.js |
Full validation with error/warning reports |
check-duplicates.js |
Cross-file duplicate detection |
fix-duplicates.js |
Automatic duplicate removal |
find-missing-dois.js |
DOI enrichment via CrossRef API |
stats.js |
Analytics dashboard with transformation coverage |
extract-keywords.js |
HUMMBL transformation keyword extraction |
merge-entries.js |
Interactive entry consolidation |
See toolkit/README.md for detailed documentation.
- CONTRIBUTING.md - How to propose new entries
- TRANSFORMATION_GUIDE.md - HUMMBL transformation mapping guidelines
- QUALITY_STANDARDS.md - Citation and metadata standards
- GAP_ANALYSIS.md - Current coverage gaps and priorities
- REPO_HEALTH.md - Owner, lifecycle, validation, and branch-protection contract
We welcome contributions! To add a new bibliography entry:
- Check docs/GAP_ANALYSIS.md for priority areas
- Use the new-entry issue template
- Follow QUALITY_STANDARDS.md for formatting
- Map to appropriate HUMMBL transformations
- Submit a pull request
All submissions are automatically validated via pre-commit hooks and CI/CD.
Current priorities for quality improvement:
- Perspective (P): 80 tags (11.8%) -- underrepresented vs. 16.7% ideal
- Inversion (IN): 101 tags -- below the current average of 112.8
- Decomposition (DE): 108 tags -- slightly below the current average of 112.8
- DOI coverage: 70.8% overall
- ISBN coverage: 27.7% overall; strongest in book-heavy tiers
See docs/GAP_ANALYSIS.md for detailed analysis.
Automatically runs validation on modified .bib files:
cd toolkit
npm run setup- Validation: Runs on every PR
- Stats Report: Generated weekly
- DOI Enrichment: Manual trigger for batch updates
To cite this bibliography:
@misc{hummbl-bibliography,
title = {HUMMBL Bibliography: Curated Works on Cognitive Transformations},
author = {{HUMMBL Team}},
year = {2025},
howpublished = {\url{https://github.com/hummbl-dev/hummbl-bibliography}},
note = {Version 1.0}
}This project is licensed under the MIT License - see the LICENSE file for details.
Special thanks to the researchers, authors, and practitioners whose work forms the foundation of the HUMMBL cognitive framework.
Maintained by: HUMMBL Team
Last Updated: 2026-04-08
Version: 2.0.0
See docs/REPO_HEALTH.md for validation and branch-protection expectations.