Humanet Documentation
GitHub for Ideas + Notion for Structure + Obsidian’s Knowledge Graph
Welcome to Humanet, a structured collaboration platform that treats ideas like code—with versioning, lifecycle management, quality validation, and knowledge graph connections.
Note: Humanet is currently under active development. Not all features are available yet, but the core ecosystem is taking shape.
Quick Start
Get started with Humanet in under a minute:
npx create-humanet my-idea
cd my-ideaOr use our GitHub template: .humanet template
What Makes Humanet Different
Available Now
Structured Idea Repositories - Every idea follows a standardized format with required documentation
Lifecycle Management - Ideas progress through defined states (Provisional → Validated → Active → Archived)
Quality Validation - AI-powered evaluation catches vague ideas early
CLI Tooling - Quick setup and validation with create-humanet
Coming Soon
Version Control - Track how ideas evolve over time with full history
Knowledge Graphs - Visualize connections between related ideas
Collaborative Workflows - Teams can fork, merge, and discuss ideas like pull requests
Learn More
Explore the documentation to understand how Humanet works:
- Getting Started - Set up your first idea repository
- Core Concepts - Understand idea repositories and lifecycle management
- Standards - Learn about documentation and diagramming guidelines
- Guides - Step-by-step tutorials for common workflows
Core Concepts
Idea Repositories
Every idea lives in a structured repository with standardized files: problem statement, solution design, scope definition, and README. This ensures clarity and consistency across all ideas.
Lifecycle Management
Ideas progress through a well-defined lifecycle: Provisional (newly created) → AI Evaluation → Validated (clear and actionable) → Active (being worked on) → Dormant/Archived/Deprecated. Each state has specific requirements and transitions.
Standards & Quality
Humanet enforces quality through required documentation, AI validation, and standardized diagramming (using Draw.io). Ideas must be clear, scoped, and actionable before moving forward.
Why Humanet?
For Individuals: Never lose track of your ideas. Document them properly, validate their clarity, and see how they connect to your other work.
For Teams: Collaborate on ideas with the same rigor as code. Review, discuss, and evolve ideas systematically.
For Organizations: Build a knowledge graph of validated ideas. Track what’s being worked on, what’s completed, and what’s shelved.
Join the Community
- NPM Package: create-humanet
- Template: .humanet
- Documentation: humanet-docs
Start creating structured, validated, and connected ideas today.