|
1 | 1 | # STATE.md — education-agent-skills |
2 | 2 |
|
3 | | -**Last updated:** 2026-05-18 (Session 4) |
| 3 | +**Last updated:** 2026-05-18 (Session 5) |
4 | 4 |
|
5 | 5 | ## What was done |
6 | 6 |
|
7 | | -Added the `inclusive-design` domain with 3 Universal Design for Learning (UDL) skills: |
| 7 | +Added 3 new skills across 2 existing domains (no new domains): |
8 | 8 |
|
9 | | -1. **udl-lesson-auditor** — Audits an existing lesson against all three UDL principles (engagement, representation, action/expression). Identifies specific access barriers, suggests concrete modifications ranked by impact, and respects stated teacher constraints. |
| 9 | +1. **systems-thinking/leverage-and-response-design** — Fills the action gap in the systems-thinking domain. Given a systems analysis (iceberg, mental models, agency circles), helps students and educators design a wise intervention using Meadows' 12 leverage points hierarchy. Checks for unintended consequences using systems archetypes (shifting the burden, fixes that fail), generates 2-3 alternative responses at different leverage levels, includes a proportionality check (systemic burdens should not fall on young people), and explicitly asks whether doing nothing or less is the wisest response. evidence_strength: moderate. |
10 | 10 |
|
11 | | -2. **udl-options-designer** — Generates 2-3 specific alternatives per UDL principle for a given learning goal. Emphasises specificity (not "add visual supports" but the exact representation). Includes a minimum viable UDL recommendation — the one highest-impact change. |
| 11 | +2. **systems-thinking/systems-wellbeing-impact-mapper** — Maps systemic forces shaping a wellbeing concern at school or community level using Bronfenbrenner's ecological model (nested systems) and social determinants of health thinking. Explicitly redirects individual explanations ("students lack resilience") to systemic framings ("the transition process provides no relationship continuity"). Generates structural interventions at multiple system levels. Includes a surveillance warning: mapping systemic forces is not the same as measuring individual students' wellbeing. evidence_strength: emerging (practitioner synthesis of established frameworks). |
12 | 12 |
|
13 | | -3. **udl-barrier-anticipator** — Predicts access barriers before delivery given a learner variability profile. Analyses engagement, representation, action/expression, environmental, and assessment barriers. Distinguishes barriers addressable through design from barriers requiring specialist support. |
| 13 | +3. **questioning-discussion/perspective-taking-designer** — Designs structured perspective-taking activities with anti-projection guardrails. Distinguishes contextual perspective-taking (investigating what someone actually thought/felt, using evidence) from projection (imagining what we would feel in their situation). Four-phase sequence: context-building, perspective identification, exploration, synthesis. Assessment criteria focus on reasoning quality, not emotional performance. Safety check for perpetrator empathy. Developmental calibration via Selman's stages. evidence_strength: moderate. |
14 | 14 |
|
15 | | -All three skills: |
16 | | -- evidence_strength: moderate (UDL is well-established as a design framework; implementation evidence is mostly quasi-experimental — no large RCTs for the complete framework) |
17 | | -- Cite: Rose & Meyer (2002), CAST (2018) UDL Guidelines v2.2, Meyer Rose & Gordon (2014), Ok et al. (2017) systematic review, Rao & Meo (2016), Edyburn (2010) |
18 | | -- No claims that UDL "ensures" or "guarantees" inclusion |
19 | | -- chains_well_with: all three UDL skills cross-link plus curriculum-assessment/differentiation-adapter, curriculum-assessment/formative-assessment-technique-selector, self-regulated-learning/self-regulation-scaffold-generator (all verified to exist on disk) |
| 15 | +Also: |
| 16 | +- Restored `systems-wellbeing-impact-mapper` chain reference in `mental-model-mapper/SKILL.md` (the chain had been removed as a ghost reference in a previous session; the skill now exists). |
| 17 | +- CI workflow updated: 142 → 145. |
| 18 | +- CLAUDE.md updated: 145 skills. |
| 19 | +- README updated: badge, description, MCP tool/prompt counts (149 tools, 145 prompts). |
20 | 20 |
|
21 | 21 | ## What was verified |
22 | 22 |
|
23 | | -- All 3 description fields verified ≤250 characters via Python: 199, 219, 195 chars |
24 | | -- All chains_well_with targets confirmed to exist on disk |
25 | | -- `python3 scripts/validate-skills.py`: 142 skills, 0 errors, 4 pre-existing warnings (line-length) |
26 | | -- `python3 scripts/validate-registry.py`: 142 skills, 19 domains — valid |
| 23 | +- All 3 description fields verified ≤250 characters via Python: 181, 185, 198 chars |
| 24 | +- All chains_well_with targets confirmed to exist on disk before writing |
| 25 | +- `python3 scripts/validate-skills.py`: 145 skills, 0 errors, 4 pre-existing warnings (line-length on unrelated skills) |
| 26 | +- `python3 scripts/validate-registry.py`: 145 skills, 19 domains — valid |
27 | 27 | - `npx playwright test`: 20/20 pass |
28 | 28 | - `cd mcp-server && npm run build && npm test`: 16/16 pass |
29 | | -- CI workflow updated: 139 → 142 |
30 | | -- CLAUDE.md updated: 142 skills, 19 domains, inclusive-design added to domain list |
31 | | -- README updated: badge, description count, domain table (19 domains), MCP tool count (146 tools, 142 prompts) |
32 | | -- Committed and pushed: 129d584 |
| 29 | +- Committed and pushed: 0c3ba84 |
33 | 30 |
|
34 | 31 | ## What's next |
35 | 32 |
|
36 | | -- Session 5 candidates: another domain, or composite orchestrator linking UDL skills with differentiation-adapter and self-regulation-scaffold-generator |
37 | | -- EAL domain has natural overlap with UDL representation barriers — potential cross-domain chains worth documenting |
| 33 | +- Systems-thinking domain now has 7 skills: iceberg, aspirational iceberg, mental model mapper, ladder of inference, agency circles, leverage-response design, wellbeing impact mapper. A composite orchestrator linking these into a full inquiry arc is a logical next step. |
| 34 | +- Perspective-taking designer is the only skill in questioning-discussion that deals with historical/cultural empathy — cross-domain with historical-thinking domain is a natural chain to explore. |
| 35 | +- The wellbeing mapper's "do not individualise" principle has natural overlap with trauma-informed-practice-designer in wellbeing-motivation-agency — worth documenting as a cross-domain pair. |
0 commit comments