Capability Commons
Capability Commons turns scattered know-how into structured, searchable, teachable capability objects. The goal is simple: help people move from not knowing the words to being able to act, verify, and teach forward.
What it is
Most people do not need more information. They need clearer paths from understanding to action. The internet has more information than anyone could consume. The problem is not content — it is structure. Knowledge exists, but it is not organized for a beginner who needs to act, does not know the vocabulary, and cannot afford to get it wrong.
Capability Commons takes knowledge that is normally trapped inside trades, institutions, guilds, paywalls, jargon, and credential barriers, and converts it into structured, searchable, teachable objects that anyone can use.
AI is not the product. AI is the compiler. It takes source material and helps transform it into structured, plain-language capability objects. Human review and field testing decide what becomes canon.
Three interlocking graphs
The system is not a document library. It is three graphs working together:
- Concept graph — what things mean and how ideas relate. "What is thermal mass?" "How does soil pH affect nutrient availability?"
- Skill graph — what people can do, in what order, with what prerequisites. "What can I do next?" "What must I know first?"
- Deployment graph — where, when, and under what constraints something is useful. "Does this work in my apartment?" "What's the low-budget version?"
That combination is what lowers the barrier to entry. Not just explanation, but explanation tied to action and context.
Capability domains
The corpus is organized by civilizational function, not academic discipline.
Knowledge object model
Every node uses the same structure: a typed knowledge object with a canonical title, plain-language explanation, structured payload, prerequisite logic, context-aware facets, and durable output artifacts.
Five-format publishing rule
Every core topic exists in five forms:
- Hook — a compelling 1–2 sentence pitch for why this matters
- Primer — plain-language background explanation
- Guide — step-by-step practical instructions
- Reference — specs, formulas, diagrams, checklists
- Teach-forward kit — how to pass it on (3-minute version, 10-minute outline, discussion prompts)
Entry model
People start with immediate needs and expand outward through concentric rings:
- Stay functional — verify information, store water, keep lights running, maintain heat
- Repair and maintain — hand tools, patching, sealing, diagnosing common failures
- Produce — gardening, preservation, rainwater, solar basics, local resource mapping
- Coordinate — shared inventories, mutual aid, tool libraries, communication plans
- Steward and transmit — documentation, teaching methods, archives, offline kits
Every module includes a plain-language version and zero-jargon glossary, cheap / better / best paths, renter / homeowner / rural / urban adaptation, what you can do with minimal tools, common mistakes, how to verify your work, and what to learn next.
Why now
Practical competence has become fragmented, gated, outsourced, or trapped behind institutions, jargon, and disappearing local memory.
The point of Capability Commons is not nostalgia. It is public capacity. The metric is not attention — it is replicated competence: modules completed by real people, tasks performed in the physical world, people who teach another person what they learned, local variants documented, offline kits distributed.
What is live now
The platform is being built in public. The following is operational.
Seeded Knowledge Graph
Each node is a versioned knowledge object with provenance, evidence links, revision history, and context-aware facets (domain, audience, settlement type, budget profile, climate zone). Edges carry confidence, method, and status. The graph is loaded via two seed passes — 25 capability nodes and 24 curriculum nodes — and is idempotent on re-run.
Seeded Domains
5 capability nodes
Epistemics, verification, AI/tool use, measurement, systems thinking. The foundational layer that makes every other domain learnable.
Seeded4 capability nodes
Storage, filtration, emergency supply, household resilience. Decision trees, equipment lists, and maintenance schedules.
Seeded5 capability nodes
Soil assessment, seed selection, planting calendars, preservation, cooking fundamentals. Zone-aware and season-aware.
Seeded3 capability nodes
Weatherization, thermal envelope, basic structural repair. Audit worksheets and cost-benefit calculators.
Seeded4 capability nodes
Load calculation, battery sizing, solar selection, off-grid fundamentals. From principles through wiring to portable systems.
Seeded4 capability nodes
Hand tools, diagnostics, patching and sealing; mutual aid logistics and group coordination.
SeededWorking Services
Full lifecycle management: draft → reviewed → verified → published → deprecated.
Relational neighbor queries, prerequisite chains, membership lookups across typed edges.
Intent-specific edge sets and sufficiency threshold for evidence-pack assembly.
Postgres full-text search across knowledge objects with chunking and ranking.
Two-pass ingestion from YAML/CSV/JSONL canonical sources. Safe to re-run.
Stewarded open-project model, contribution guidelines, lifecycle states, and naming conventions.
Roadmap
Postgres 16 + pgvector, FastAPI async API, SQLAlchemy 2 ORM (19 tables), Alembic migrations, Docker Compose. Seeded 49 knowledge objects (25 capabilities + 12 modules + 12 assessments), 175 typed edges, 167+ context facets across 7 domains. Object/version CRUD, graph traversal, retrieval planner, full-text search. Governance, brand, and public landing page.
Fully populated modules with downloadable worksheets and reference sheets. Public graph API endpoints. Vector embeddings active (pgvector). First published learning path. Developer documentation site. Community contribution workflow.
Interactive knowledge graph explorer. Evidence-pack assembly and contradiction workflows via Agentic Data Lite. Public review workflows. Expanded domain coverage into Productive and Advanced layers.
Field report submission and local adaptation framework. Community review board. Entity merge and advanced contradiction detection. 50+ published objects across all domain layers. Offline kit generation.
Architecture
Capability Commons is built on the Agentic Data Lite architecture — a trimmed version of the enterprise AgenticData stack focused on versioned knowledge objects, typed edges, evidence provenance, and retrieval planning.
Single source of truth. 19 tables. Vector columns ready for embedding-based retrieval.
Async API with v1 routes, health check, CORS, and dependency injection.
Schema versioning for all 19 tables. Reproducible from scratch.
One-command local development. Postgres on port 5433.
25 supported edge types with confidence, method, and status metadata.
Neo4j and OpenSearch adapter interfaces defined. Outbox, static export, and object storage stubs.
Stewardship
Capability Commons is founded and stewarded by Jason St George.
The public initiative sits under a larger body of work on truth, coordination, verification, and resilient systems under adversarial conditions. The technical substrate — Agentic Data Lite — provides versioned knowledge objects, typed edges with provenance, evidence-pack assembly, contradiction workflows, and retrieval planning for long-horizon maintenance.
Lifecycle states for all objects: DRAFT → IN_REVIEW →
REVIEWED → VERIFIED → PUBLISHED →
DEPRECATED. Transparent version history, editorial standards, and subject-matter review.
No black-box canonical truth claims.
Contribute
There are three ways to contribute:
- Platform — FastAPI routes, graph adapters, search, embeddings, UI components
- Content — capability nodes, modules, assessments, worksheets, reference sheets
- Field work — field reports, local adaptations, review notes, teach-forward feedback
Seed data is in YAML (canonical), CSV (relational), and JSONL (document) formats. The CLI is
idempotent. Start with docker compose up -d, run migrations, seed, and you have the
full graph locally.
Open knowledge is not enough.
The goal is usable capability.