Didactopus/docs/domain-pack-format.md

79 lines
1.3 KiB
Markdown

# Domain Pack Format
## Purpose
A domain pack is the primary distributable artifact for Didactopus. It contains structured material describing a field, learning sequence, projects, and evaluation artifacts.
## Directory layout
```text
example-pack/
├── pack.yaml
├── concepts.yaml
├── roadmap.yaml
├── projects.yaml
├── rubrics.yaml
├── resources.md
└── LICENSE
```
## pack.yaml
The manifest should contain:
- pack name
- display name
- version
- schema version
- description
- author
- license
- tags
- didactopus compatibility
- optional dependencies
## concepts.yaml
Contains:
- concept identifiers
- descriptions
- prerequisites
- representative tasks
- mastery signals
## roadmap.yaml
Contains:
- stages
- stage goals
- concept clusters
- checkpoint criteria
- recommended pacing notes
## projects.yaml
Contains:
- project identifiers
- difficulty
- prerequisites
- deliverables
- milestone suggestions
- verification expectations
## rubrics.yaml
Contains:
- assessment criteria
- score bands
- explanation requirements
- transfer-task criteria
## Example philosophy
The pack format should separate:
- domain structure
- learning sequence
- authentic practice
- evidence standards
That separation makes contributed packs easier to compare, merge, and improve.