149 lines
3.7 KiB
Markdown
149 lines
3.7 KiB
Markdown
# 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`.
|
||
|
||
### Cross-pack links
|
||
|
||
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 learner’s 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
|
||
|
||
```text
|
||
didactopus/
|
||
├── README.md
|
||
├── artwork/
|
||
├── configs/
|
||
├── docs/
|
||
├── domain-packs/
|
||
├── src/didactopus/
|
||
└── tests/
|
||
```
|