AI-powered clinical supervision automation for Applied Behavior Analysis, built on LLM + Obsidian knowledge base
29 Claude Code Skills covering the entire workflow from intake to discharge, giving every BCBA a digital supervision assistant that never clocks out.
graph TD
A[Organization Management] --> A1(org-manager)
A1 --> A2(staff-onboarding)
A2 --> A3(staff-evaluation)
A3 --> A4(supervisor-sync)
B[Clinical Pipeline] --> B1(privacy-filter)
B1 --> B2(intake-interview)
B2 --> B3(profile-builder)
B3 --> B4(assessment-logger)
B3 --> B5(fba-analyzer)
B4 --> B6(plan-generator)
B5 --> B6
B6 --> B7(program-slicer)
B7 --> B8(teacher-guide)
B8 --> C((Daily Cycle))
C --> C1(session-reviewer)
C --> C2(staff-supervision)
C --> C3(curriculum-updater)
C1 -.-> B8
C2 -.-> B8
C3 -.-> B7
C --> D1(parent-update)
C --> D2(reinforcer-tracker)
C --> D3(clinical-reflection)
D1 --> E1(milestone-report)
E1 --> E2(transfer-protocol)
F[Curriculum Development] --> F1(curriculum-builder)
F1 --> F2(lesson-planner)
F2 --> F3(group-tracker)
G[Efficiency Tools] --> G1(daily-digest)
G --> G2(case-conference)
G --> G3(quick-summary)
An AI-powered clinical workstation designed for ABA (Applied Behavior Analysis) practitioners:
- 29 Automation Skills: Covering de-identification, intake, assessment, IEP/BIP planning, teaching, daily supervision, reporting, and transition
- Obsidian Knowledge Base: 8-layer standardized directory structure + bidirectional linking = a living digital clinic
- Professional Reference Dictionaries: VB-MAPP domains, prompt hierarchy, competency matrix, and developmental sequences
- Data Analysis Scripts: Automatic PDF extraction + trend analysis + Excel export
- Safety Guardrails: Diff preview confirmation, frontmatter tracking, de-identification workflow, human-in-the-loop
| Role | What You Get |
|---|---|
| BCBA / Lead Supervisor | Auto-generated IEP/FBA/family letters/reflections, data trend analysis, operational dashboard |
| Assistant Supervisor / RBT | Auto-generated teaching guides, instant session feedback, curriculum advancement support |
| ABA Agency Director | Standardized management workflows, staff growth tracking, org chart management, case conference materials |
| Special Ed Tech Developer | Complete skill development framework, extensible professional dictionaries, assessment toolchain |
- Claude Code or another AI client supporting
.claude/skills/(Cursor, Cline, etc.) - Obsidian (recommended for visual knowledge base browsing; not required)
- Python 3.7+ (for the setup script)
git clone https://github.com/open-behavior-analysis/aba-clinical-agent.git
cd aba-clinical-agent# English
python scripts/setup.py --lang en
# Chinese (default)
python scripts/setup.py --lang zh-CNThis copies the selected language's skills, vault template, and documentation into their active locations.
cp .claude/settings.local.json.example .claude/settings.local.json
# Edit permission settings for your environmentLaunch Claude Code (or your AI client) in the project root and enter your first command:
Please read CLAUDE.md and enter the clinical supervisor role.
I have a new case named "Alex" — please run intake-interview and tell me what information you need.
Want to see it in action first? Check out the demo case at
Obsidian-Vault/01-Clients/Client-Demo-Alex/— a fully fictional case showcasing the system's end-to-end output.
| Skill | Trigger Phrases | Function |
|---|---|---|
privacy-filter |
"de-identify this" | Real name to code, prevent data leaks |
intake-interview |
"new client / intake" | New case intake + directory initialization |
profile-builder |
"build master profile" | Deepen the Master Profile |
assessment-logger |
"VB-MAPP / assessment" | Assessment data to structured report |
fba-analyzer |
"behavior analysis / ABC" | Functional behavior analysis + competing behavior model |
reinforcer-tracker |
"reinforcer / satiation" | Preference assessment + satiation alerts |
plan-generator |
"IEP / treatment plan" | Full IEP/BIP with prerequisite chains and fading plans |
program-slicer |
"break down / how to teach" | Goals to discrete teaching programs + prompt fading |
curriculum-updater |
"mastered / next target" | Mastery confirmation + curriculum change order |
session-reviewer |
"session notes" | Therapist feedback analysis + daily home extension |
staff-supervision |
"observation / supervision" | Clinical observation notes to staff growth record |
teacher-guide |
"teaching guide / cheat sheet" | One-page teaching reference sheet |
parent-update |
"family letter / parent update" | Emotionally supportive weekly family letter |
clinical-reflection |
"weekly reflection" | Weekly clinical reflection + system learning |
milestone-report |
"milestone / progress report" | Baseline vs. current comparison report |
transfer-protocol |
"transition / handover" | Full lifecycle transition protocol |
| Skill | Trigger Phrases | Function |
|---|---|---|
staff-onboarding |
"new therapist / onboarding" | Staff profile creation + growth record init |
org-manager |
"org chart / caseload" | 3-tier org structure + case assignment |
staff-evaluation |
"competency / promotion" | Competency assessment + L1-L6 promotion pathway |
supervisor-sync |
"team meeting / sync" | Supervision meeting brief + information cascade |
daily-digest |
"daily summary" | One-page operational dashboard |
| Skill | Trigger Phrases | Function |
|---|---|---|
curriculum-builder |
"design course" | Structured course outline |
lesson-planner |
"write lesson plan" | Single-session detailed lesson plan |
group-tracker |
"group session tracking" | Group session recording + outcome evaluation |
| Skill | Trigger Phrases | Function |
|---|---|---|
case-conference |
"case conference" | Full case conference materials package |
quick-summary |
"quick brief" | 5-second full-case intelligence aggregation |
data-trend |
"analyze data trends" | Session PDF to trend analysis |
aba-fusion-compare |
"inclusion data comparison" | Inclusion feedback to IEP goal attainment |
skill-creator |
"create new skill" | Skill development / evaluation / optimization framework |
CLAUDE.md -> Role definition: AI's professional boundaries and absolute directives
|
_config.md -> Global config: directory standards, naming rules, operational protocols
|
_router.md -> Skill router: user keywords -> automatic skill dispatch
|
SKILL.md (x29) -> Skill definitions: input/output/execution steps for each skill
|
references/ (x4) -> Knowledge dictionaries: VB-MAPP, prompt hierarchy, competency matrix, developmental sequences
For detailed architecture documentation, see docs/architecture.md.
The repository includes a fully fictional demo case Client-Demo-Alex (4-year-old boy, ASD Level 2), showcasing the system's end-to-end output:
Obsidian-Vault/01-Clients/Client-Demo-Alex/
├── Client-Demo-Alex - Intake Form.md <- intake-interview output
├── Client-Demo-Alex - Master Profile.md <- profile-builder output
├── Client-Demo-Alex - Skill Assessment.md <- assessment-logger output
├── Client-Demo-Alex - FBA Report.md <- fba-analyzer output
├── Client-Demo-Alex - IEP-2026-01-15.md <- plan-generator output
├── Client-Demo-Alex - Reinforcer Assessment.md <- reinforcer-tracker output
├── Client-Demo-Alex - Milestone Report.md <- milestone-report output
├── Client-Demo-Alex - Communication Log.md
└── Client-Demo-Alex - Curriculum Change Tracker.md <- curriculum-updater output
This project supports both English and Chinese (Simplified). Use the setup script to switch:
python scripts/setup.py --lang en # English
python scripts/setup.py --lang zh-CN # Chinese (default)The setup script copies the selected language's skills, vault template, CLAUDE.md, and documentation into their active locations. Your clinical data in Obsidian-Vault/ is never overwritten.
Don't want to install anything? Open the project directly in your browser with GitHub Codespaces:
Everything is pre-configured: Claude Code, Python, data analysis tools. Just set your Anthropic API key as a Codespace secret and start working.
See Hosted Quick Start Guide for step-by-step instructions.
We welcome all forms of contribution! See CONTRIBUTING.md for details.
Especially welcome:
- New skill submissions (follow skill-creator standards)
- Knowledge base concept cards (08-Knowledge/concepts/)
- Reference dictionary extensions (ABLLS-R, Vineland, etc.)
- Translations and localization
Copyright (c) 2026 Jiamei Zhang (Jiamei-Zhang-BCBA)
This project is licensed under AGPL-3.0. You may freely use and modify it, but derivative works or SaaS offerings based on this project must be open-sourced under the same license.
All contributions are subject to our Contributor License Agreement (CLA).
This system is a clinical support tool and does not constitute medical advice of any kind. All AI-generated content is for reference only. Final clinical decisions must be made by qualified, licensed professionals. See DISCLAIMER.md for details.
