Didactopus/README.md

3.7 KiB
Raw Blame History

Didactopus

Didactopus is a local-first AI-assisted autodidactic mastery platform for building genuine expertise through concept graphs, adaptive curriculum planning, evidence-driven mastery, Socratic mentoring, and project-based learning.

Tagline: Many arms, one goal — mastery.

Complete overview to this point

Didactopus is designed to support both human learners and, potentially, agentic AI students that use the same mastery infrastructure to become competent in a target domain.

The current architecture includes:

  • Domain packs for contributed concepts, projects, rubrics, and mastery profiles
  • Dependency resolution across packs
  • Merged learning graph generation
  • Adaptive learner engine that identifies ready, blocked, and mastered concepts
  • Evidence engine with weighted, recency-aware, multi-dimensional mastery inference
  • Concept-specific mastery profiles with template inheritance
  • Concept graph engine for cross-pack prerequisite reasoning, concept linking, pathfinding, and graph export

Core philosophy

Didactopus assumes that real expertise is built through:

  • explanation
  • problem solving
  • transfer
  • critique
  • project execution

The AI layer should function as a mentor, evaluator, and curriculum partner, not an answer vending machine.

Domain packs

Knowledge enters the system through versioned, shareable domain packs. Each pack can contribute:

  • concepts
  • prerequisites
  • learning stages
  • projects
  • rubrics
  • mastery profiles
  • profile templates
  • cross-pack concept links

Concept graph engine

This revision implements a concept graph engine with:

  • prerequisite reasoning across packs
  • cross-pack concept linking
  • semantic concept similarity hooks
  • automatic curriculum pathfinding
  • visualization export for mastery graphs

Concepts are namespaced as pack-name::concept-id.

Domain packs may declare conceptual links such as:

  • equivalent_to
  • related_to
  • extends
  • depends_on

These links enable Didactopus to reason across pack boundaries rather than treating each pack as an isolated island.

Semantic similarity

A semantic similarity layer is included as a hook for:

  • token overlap similarity
  • future embedding-based similarity
  • future ontology and LLM-assisted concept alignment

Curriculum pathfinding

The concept graph engine supports:

  • prerequisite chains
  • shortest dependency paths
  • next-ready concept discovery
  • reachability analysis
  • curriculum path generation from a learners mastery state to a target concept

Visualization

Graphs can be exported to:

  • Graphviz DOT
  • Cytoscape-style JSON

Evidence-driven mastery

Mastery is inferred from evidence such as:

  • explanations
  • problem solutions
  • transfer tasks
  • project artifacts

Evidence is:

  • weighted by type
  • optionally up-weighted for recency
  • summarized by competence dimension
  • compared against concept-specific mastery profiles

Multi-dimensional mastery

Current dimensions include:

  • correctness
  • explanation
  • transfer
  • project_execution
  • critique

Different concepts can require different subsets of these dimensions.

Agentic AI students

Didactopus is also architecturally suitable for AI learner agents.

An agentic AI student could:

  1. ingest domain packs
  2. traverse the concept graph
  3. generate explanations and answers
  4. attempt practice tasks
  5. critique model outputs
  6. complete simulated projects
  7. accumulate evidence
  8. advance only when concept-specific mastery criteria are satisfied

Repository structure

didactopus/
├── README.md
├── artwork/
├── configs/
├── docs/
├── domain-packs/
├── src/didactopus/
└── tests/