Public Initiative

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.

Foundation Epistemics, verification, AI/tool use, measurement, systems thinking, numeracy
Household Water, food, shelter, heat/cooling, electricity, backup power, sanitation, health, communications
Productive Gardening, food preservation, carpentry, repair, plumbing, electrical, small engines, fabrication
Community Mutual aid, group decision-making, local mapping, shared infrastructure, emergency coordination
Advanced Architecture, mechanical systems, energy design, networking, manufacturing, open-source hardware

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.

concept_note Concept note Principle, model, or mental framework
skill_guide Skill guide Observable action with tools, steps, and failure modes
project_blueprint Project blueprint Applied task that creates a useful artifact
module Module Weekly curriculum unit covering multiple capabilities
assessment Assessment Evaluation rubric for a module
reference_sheet Reference sheet Specs, formulas, diagrams, checklists
learning_path Learning path Sequenced progression through a domain
field_report Field report Documented real-world application with results
teach_forward Teach-forward packet Materials for passing knowledge to someone else

Five-format publishing rule

Every core topic exists in five forms:

  1. Hook — a compelling 1–2 sentence pitch for why this matters
  2. Primer — plain-language background explanation
  3. Guide — step-by-step practical instructions
  4. Reference — specs, formulas, diagrams, checklists
  5. 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:

  1. Stay functional — verify information, store water, keep lights running, maintain heat
  2. Repair and maintain — hand tools, patching, sealing, diagnosing common failures
  3. Produce — gardening, preservation, rainwater, solar basics, local resource mapping
  4. Coordinate — shared inventories, mutual aid, tool libraries, communication plans
  5. 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.

49 Knowledge objects 25 capabilities + 12 modules + 12 assessments
175 Typed edges prerequisite, next-step, contains, assessed-by, validated-by
167+ Context facets domain, audience, settlement type, budget profile
7 Domains foundation, water, food, shelter, repair, power, community
12 Curriculum weeks complete module + assessment sequence
19 Database tables Postgres 16 + pgvector, SQLAlchemy 2 ORM

Seeded Knowledge Graph

Concept Note
Skill Guide
Project Blueprint
Module
Teach-Forward

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

Foundation

5 capability nodes

Epistemics, verification, AI/tool use, measurement, systems thinking. The foundational layer that makes every other domain learnable.

Seeded
Water

4 capability nodes

Storage, filtration, emergency supply, household resilience. Decision trees, equipment lists, and maintenance schedules.

Seeded
Food

5 capability nodes

Soil assessment, seed selection, planting calendars, preservation, cooking fundamentals. Zone-aware and season-aware.

Seeded
Shelter

3 capability nodes

Weatherization, thermal envelope, basic structural repair. Audit worksheets and cost-benefit calculators.

Seeded
Power

4 capability nodes

Load calculation, battery sizing, solar selection, off-grid fundamentals. From principles through wiring to portable systems.

Seeded
Repair + Community

4 capability nodes

Hand tools, diagnostics, patching and sealing; mutual aid logistics and group coordination.

Seeded

Working Services

Object/Version CRUD

Full lifecycle management: draft → reviewed → verified → published → deprecated.

Graph Traversal

Relational neighbor queries, prerequisite chains, membership lookups across typed edges.

Retrieval Planner

Intent-specific edge sets and sufficiency threshold for evidence-pack assembly.

Full-Text Search

Postgres full-text search across knowledge objects with chunking and ranking.

Idempotent Seed CLI

Two-pass ingestion from YAML/CSV/JSONL canonical sources. Safe to re-run.

Governance & Brand

Stewarded open-project model, contribution guidelines, lifecycle states, and naming conventions.

Roadmap

2026 Q1
Platform & Seed Graph

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.

2026 Q2
Public Artifacts & API

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.

2026 Q3
Explorer & Evidence Layer

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.

2026 Q4
Scale & Community

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.

Postgres 16 + pgvector

Single source of truth. 19 tables. Vector columns ready for embedding-based retrieval.

FastAPI + SQLAlchemy 2

Async API with v1 routes, health check, CORS, and dependency injection.

Alembic Migrations

Schema versioning for all 19 tables. Reproducible from scratch.

Docker Compose

One-command local development. Postgres on port 5433.

Typed Edge System

25 supported edge types with confidence, method, and status metadata.

Extension Points

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: DRAFTIN_REVIEWREVIEWEDVERIFIEDPUBLISHEDDEPRECATED. 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.

Ask