Skip to content

About

Agent Teacher: a pedagogy knowledge library with open review status, a local teaching rehearsal on 3 authored fraction cases, and an audited Grade 1 Vietnamese maths course. Python, no model calls. FREE + source-available.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

5 stars

Watchers

0 watching

Forks

Latest commit

 

History

61 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DESIGN:OS Agent Teacher

design:os by Jang

Agent Teacher (design-os-pedagogy) is three things in one Python repository: a pedagogy knowledge library where every record carries its review status, a local app for rehearsing one teaching move on authored fraction cases, and a Grade 1 Vietnamese mathematics course that is checked by an executable audit. Nothing in it calls a language model.

It is early work. Of the 117 library records, 106 are still unreviewed, 11 are source-checked and none has had expert review. The rehearsal has 3 cases and has not been piloted with real teachers. Passing tests and a clean graph do not show that the teaching works.

FREE + source-available (PolyForm Shield 1.0.0). Tiếng Việt · Docs site

Quickstart · What's in the repo · Rehearsal · Library · Course · Checks · Limits

Quickstart

The rehearsal app and scripts/self_check.py use only the Python standard library. The registry, coverage, course and publication tools need the two packages in requirements.txt (PyYAML and markdown-it-py). Python 3.10 or later.

git clone https://github.com/jangtrinh/design-os-pedagogy.git
cd design-os-pedagogy

# Open the rehearsal app (prints a local URL; --port 0 picks a free port, the default is 8876)
python3 run_rehearsal.py --port 0

# Tools that read the library and the course
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/python -B tools/knowledge_registry.py
.venv/bin/python -B tools/knowledge_coverage.py --stage S2
.venv/bin/python -B tools/course_audit.py courses/vi-vn-grade-1-math

What's in the repo

design:os by Jang

Part Where State
Knowledge library 00-system to 90-agent-runtime, mapped from 00-navigation/MOC-Master.md 117 records, 376 links, registry errors 0. Mostly unreviewed
Rehearsal app rehearsal/, run_rehearsal.py Implemented. 3 Vietnamese fraction cases
Grade 1 course courses/vi-vn-grade-1-math/ Audit passes. Status draft-for-teacher-review
Publication pipeline tools/pedagogy_pipeline.py Implemented. Drafts stay unreviewed
Tutor runtime 90-agent-runtime/ Specification only. Not built

The rehearsal

You play the teacher. A simulated Grade 6 student gives an answer, and you choose what to do next and write what you would say. The app has 3 authored cases in rehearsal/data/fractions.vi.json: comparing fraction size, checking the reasoning behind a correct answer, and notation versus explanation. Each case runs through 8 steps: probe, interpret, teach, check, review, transfer, reflect, complete.

design:os by Jang

design:os by Jang

design:os by Jang

design:os by Jang

  • The student lines and the coaching feedback follow authored branches. Your free text is saved but not graded.
  • Sessions are stored in SQLite (.data/rehearsal.sqlite3, or a folder you pass with --data-dir). They keep revisions, handle duplicate submits, and can be reopened, replayed and exported as Markdown or JSON. The list shows the latest 100 sessions.
  • Each session records the version and fingerprint of the case pack. If the pack changes, older sessions can still be read and exported but not continued.
  • It is a local, single-user service, not a hosted multi-account system. It does not certify teaching skill.

The full behaviour is in docs/rehearsal-contract.md.

The library

Start at 00-navigation/MOC-Master.md. Records are Markdown with YAML front matter.

Area What is there
00-system Ontology, schemas, evidence policy and authoring contracts
10-foundations, 20-stages Foundations, and guidance by education stage S0 to S7
30-pedagogy, 40-disciplines Methods, assessment and subject practice
50-practice-library, 60-evidence Cases, source records (30 of them), claims and estimates
70-capabilities, 80-professor-development Teaching capabilities CAP-01 to CAP-06, and professional development
90-agent-runtime Runtime specification, prompts and evaluation proposals

tools/knowledge_registry.py checks metadata, canonical IDs, explicit aliases and link types. Today it reports 117 records, 376 links, 0 errors, 0 unresolved links and 62 legacy warnings. tools/knowledge_coverage.py filters by stage, axis (AX-01 to AX-08) or capability, and reports review status without granting it.

New modules go through tools/pedagogy_pipeline.py: a --dry-run preview, an import with --input, then a separate --apply. Imports stay unreviewed, nothing is committed for you, and --inspect-publication and --recover-publication handle an interrupted apply. See docs/publication.md.

The Grade 1 course

courses/vi-vn-grade-1-math/ is a Grade 1 mathematics course written against the Vietnamese 2018 general education programme: 35 weeks, 3 periods a week, 105 sessions and 24 outcomes. tools/course_audit.py recomputes 111 answer keys, counts 14 observational tasks and checks strand coverage (number 84, geometry 16, experience 5 sessions). tools/render_course.py turns the audited data into teacher-facing Markdown. The course is a draft for teacher review and has not been taught. See docs/course-audit.md.

Checks

python3 scripts/self_check.py                    # required files and manifests are present
.venv/bin/python -B -m unittest discover -s tests # 98 tests
.venv/bin/python -B tools/knowledge_registry.py
.venv/bin/python -B tools/verify_links.py

Tests use their own temporary corpus and database. verify_links.py checks local paths and anchors only; it does not fetch external links or check that a source supports a claim. There is no CI workflow, so run these before you commit. docs/implementation-status.md lists where the evidence for each part lives.

Use it from an agent

The repo ships plugin manifests for Claude Code, Codex, Factory and .agents, plus a /doctor command:

/plugin marketplace add jangtrinh/design-os-pedagogy
/plugin install design-os-pedagogy@design-os-pedagogy

The skill text in skills/design-os-pedagogy/SKILL.md still describes a broader tutoring runtime than the code implements. Trust this README and the code over it.

Limits

  • 106 of 117 records are unreviewed and none has expert review. Older grades or validated flags do not replace review.
  • The rehearsal covers fractions only, in Vietnamese, with 3 cases. It has not been piloted with real teachers or learners; see docs/fraction-pilot.md.
  • Free-text answers are stored, not assessed.
  • The tutor runtime in 90-agent-runtime is a specification.
  • The publisher writes two files in sequence, not as one atomic transaction.

DESIGN:OS

Agent Teacher is one of the DESIGN:OS tools. The others: Studio, CLI, Bridge, SVG Animation, 3D Blender, Knowledge Builder and mcp-bridge-go. More on jangtrinh.github.io.

Changelog: CHANGELOG.md · Index for AI agents: llms.txt · Art direction: ART-DIRECTION.md

Contributing and license

If design-os-pedagogy saves you time, a star on GitHub helps other engineers and AI agents find it.

Buy Me a Coffee

Built by Jang Trịnh, creative technologist and autonomous system architect. More projects and writing at jang.work.

GitHub · LinkedIn · Hub · YouTube · X

About

Agent Teacher: a pedagogy knowledge library with open review status, a local teaching rehearsal on 3 authored fraction cases, and an audited Grade 1 Vietnamese maths course. Python, no model calls. FREE + source-available.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages