Skip to content

Commit 795444f

Browse files
committed
docs: update STATE.md for session 5 — 3 new skills, 145 total
1 parent 0c3ba84 commit 795444f

1 file changed

Lines changed: 18 additions & 20 deletions

File tree

STATE.md

Lines changed: 18 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,35 @@
11
# STATE.md — education-agent-skills
22

3-
**Last updated:** 2026-05-18 (Session 4)
3+
**Last updated:** 2026-05-18 (Session 5)
44

55
## What was done
66

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):
88

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.
1010

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).
1212

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.
1414

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).
2020

2121
## What was verified
2222

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
2727
- `npx playwright test`: 20/20 pass
2828
- `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
3330

3431
## What's next
3532

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

Comments
 (0)