persxn/calamity-framework
🧠 Your AI study engine inside Claude Code: an adaptive tutor across 150 skills, a GATE CS/DA companion and a Codeforces coach. FSRS-6 spaced repetition, every question blind-checked by a second AI before you see it, a daily finish line inst
field: Education workflow: Planning & specsPR / code reviewTesting & TDDFrontend & designCI/CD & deploy
stack: Python
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
GUARDRAILS
3/5
Protects secrets · No YOLO mode · Sandbox or ask-first rules · details
Quality 17/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code
$ npx degit persxn/calamity-framework/.claude ./rig-calamity-framework # inspect, then merge into .claude/ MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.
$ npx degit persxn/calamity-framework/.claude/skills/boss .claude/skills/boss $ npx degit persxn/calamity-framework/.claude/skills/bridge .claude/skills/bridge $ npx degit persxn/calamity-framework/.claude/skills/build-it-yourself .claude/skills/build-it-yourself $ npx degit persxn/calamity-framework/.claude/skills/career .claude/skills/career $ npx degit persxn/calamity-framework/.claude/skills/coach .claude/skills/coach $ npx degit persxn/calamity-framework/.claude/skills/cp .claude/skills/cp $ npx degit persxn/calamity-framework/.claude/skills/dash .claude/skills/dash $ npx degit persxn/calamity-framework/.claude/skills/day .claude/skills/day $ npx degit persxn/calamity-framework/.claude/skills/gate .claude/skills/gate $ npx degit persxn/calamity-framework/.claude/skills/log .claude/skills/log $ npx degit persxn/calamity-framework/.claude/skills/mastery-coach .claude/skills/mastery-coach $ npx degit persxn/calamity-framework/.claude/skills/mastery-textbook .claude/skills/mastery-textbook $ npx degit persxn/calamity-framework/.claude/skills/notes .claude/skills/notes $ npx degit persxn/calamity-framework/.claude/skills/onboard .claude/skills/onboard $ npx degit persxn/calamity-framework/.claude/skills/practice .claude/skills/practice $ npx degit persxn/calamity-framework/.claude/skills/recall .claude/skills/recall $ npx degit persxn/calamity-framework/.claude/skills/remind .claude/skills/remind $ npx degit persxn/calamity-framework/.claude/skills/stock .claude/skills/stock $ npx degit persxn/calamity-framework/.claude/skills/study .claude/skills/study $ npx degit persxn/calamity-framework/.claude/skills/sync .claude/skills/sync $ npx degit persxn/calamity-framework/.claude/skills/teach-deep .claude/skills/teach-deep $ npx degit persxn/calamity-framework/.claude/skills/today .claude/skills/today $ npx degit persxn/calamity-framework/.claude/skills/tree .claude/skills/tree $ npx degit persxn/calamity-framework/.claude/skills/update-framework .claude/skills/update-framework
$ curl -fsSL --create-dirs -o .claude/agents/book-builder.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/book-builder.md $ curl -fsSL --create-dirs -o .claude/agents/bridge-engineer.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/bridge-engineer.md $ curl -fsSL --create-dirs -o .claude/agents/career-advisor.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/career-advisor.md $ curl -fsSL --create-dirs -o .claude/agents/checker.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/checker.md $ curl -fsSL --create-dirs -o .claude/agents/cp-coach.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/cp-coach.md $ curl -fsSL --create-dirs -o .claude/agents/curriculum-architect.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/curriculum-architect.md $ curl -fsSL --create-dirs -o .claude/agents/drill-smith.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/drill-smith.md $ curl -fsSL --create-dirs -o .claude/agents/examiner.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/examiner.md $ curl -fsSL --create-dirs -o .claude/agents/gate-strategist.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/gate-strategist.md $ curl -fsSL --create-dirs -o .claude/agents/learning-analyst.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/learning-analyst.md $ curl -fsSL --create-dirs -o .claude/agents/notes-writer.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/notes-writer.md $ curl -fsSL --create-dirs -o .claude/agents/opportunity-scout.md https://raw.githubusercontent.com/persxn/calamity-framework/main/.claude/agents/opportunity-scout.md
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"permissions": {
"deny": [
"Edit(/learner/events/**)",
"Read(/learner/items/**)",
"Edit(/learner/items/**)",
"Edit(/learner/PROGRESS.md)",
"Edit(/learner/journal/**)",
"Edit(/.claude/settings.json)",
"Edit(/.claude/settings.local.json)",
"Read(**/.env)",
"Read(**/.env.local)",
"Read(**/cookies.txt)",
"Read(**/*.har)"
],
"ask": [
"Bash(python3 engine/calamity.py setup *)",
"Bash(python engine/calamity.py setup *)",
"Bash(py -3 engine/calamity.py setup *)",
"PowerShell(python3 engine/calamity.py setup *)",
"PowerShell(python engine/calamity.py setup *)",
"PowerShell(py -3 engine/calamity.py setup *)",
"Edit(/engine/**)",
"Edit(/framework/**)",
"Edit(/CLAUDE.md)"
]
}
} Skills (24)
bossbridgebuild-it-yourselfcareercoachcpdashdaygatelogmastery-coachmastery-textbooknotesonboardpracticerecallremindstockstudysyncteach-deeptodaytreeupdate-framework
Subagents (12)
| book-builder model: inherit | Writes and builds a learner's study book for one topic, chapter by chapter, from what was taught: Markdown by default, a typeset PDF edition when the learner chose it. Runs the mastery-textbook skill |
| bridge-engineer model: inherit | Builds the one-off tool that connects a study source by a route its terms allow: an export parser, a client for a documented API with the learner's own key, a paste formatter, or a read-only script fo |
| career-advisor model: inherit | Turns the career records into at most three actions (apply now, prepare the named gap skills, or hold until a date) from the engine's computed readiness, the learner model and the plans; drafts résumé |
| checker model: inherit | Verifies drafted practice items blind, without their keys: solves each, by computation wherever possible, and submits its own answer for the engine to compare. Use after the examiner returns item ids, |
| cp-coach model: inherit | Plans competitive programming: reads the learner's Codeforces record, finds the real weaknesses, and writes or revises the training plan toward their rating target. Use for a first plan after linking |
| curriculum-architect model: inherit | Designs what a learner studies: a skill's syllabus from its scope and current official documentation, placement tests, new skill-tree nodes, lecture-to-topic mappings, routes to a goal. Use when a ski |
| drill-smith model: inherit | Writes developer drills as sealed drafts for the checker: debug and debug-docs repositories with a seeded bug, timed read drills on a real repository at a pinned commit, audits of AI-style code, promp |
| examiner model: inherit | Writes practice items (questions and hands-on exercises) and stores them as drafts for the checker. Use whenever verified items are missing for upcoming topics (item needs, NEED_ITEM), and for placeme |
| gate-strategist model: inherit | Plans GATE preparation back from the exam date: hours available against needed, subject order by marks per hour, possible cuts, mock calendar, the marks target with sources, test series when asked. Us |
| learning-analyst model: inherit | Reads how the learner actually learns and works — habits, hours and sleep, the learner model (first-try accuracy, retention, teaching patterns, fatigue, ROI per track), running experiments — and propo |
| notes-writer model: inherit | Writes long-form study notes: turns a topic's Markdown fragment into a complete, accurate section, in Markdown by default or in LaTeX for a learner who chose PDF. Use from the notes skill for topics m |
| opportunity-scout model: inherit | Searches the web for opportunities the learner's plan needs and records each with its source, fetch date and the site's terms. One beat per run: gate-mocks (the official mock interface, all-India seri |
Permissions
deny (11)
Edit(/learner/events/**)
Read(/learner/items/**)
Edit(/learner/items/**)
Edit(/learner/PROGRESS.md)
Edit(/learner/journal/**)
Edit(/.claude/settings.json)
Edit(/.claude/settings.local.json)
Read(**/.env)
Read(**/.env.local)
Read(**/cookies.txt)
Read(**/*.har)
ask (9)
Bash(python3 engine/calamity.py setup *)
Bash(python engine/calamity.py setup *)
Bash(py -3 engine/calamity.py setup *)
PowerShell(python3 engine/calamity.py setup *)
PowerShell(python engine/calamity.py setup *)
PowerShell(py -3 engine/calamity.py setup *)
Edit(/engine/**)
Edit(/framework/**)
Edit(/CLAUDE.md)
allow (23)
Bash(python3 engine/calamity.py *)
Bash(python engine/calamity.py *)
Bash(py -3 engine/calamity.py *)
PowerShell(python3 engine/calamity.py *)
PowerShell(python engine/calamity.py *)
PowerShell(py -3 engine/calamity.py *)
Edit(/learner/profile.md)
Edit(/learner/schedule.md)
Edit(/learner/notes/**)
Edit(/learner/syllabus/**)
Edit(/learner/tree/**)
Edit(/learner/sources/**)
Edit(/learner/work/**)
Edit(/learner/cp/**)
Edit(/learner/gate/**)
Edit(/learner/bridges/**)
Edit(/learner/coach/**)
Edit(/learner/books/**)
Edit(/learner/projects/**)
Edit(/learner/timetable.json)
Edit(/learner/practice/**)
Edit(/learner/career/**)
Edit(/.calamity/tmp/**)
Similar rigs
x-mesh/xm
Plugin toolkit for Claude Code — grounds plans in repository evidence, gates the result before it merges
Skill Collector 6.8k tok · · Q29
serafim-builds/PersonaOS
An open-source AI that quietly remembers who you are — in plain markdown you fully own. Works with Claude Code, Codex CLI, opencode, and any other agent that reads AGENTS.md.
Skill Collector 13.4k tok · · Q15
foliveira/harmonia
Thin lifecycle commands that orchestrate an agent roster bound by the Four Karpathy Rules, hooks that enforce everything a machine can check, and captured knowledge that compounds across sessions and projects.
Skill Collector 677 tok · · Q0
serionist/docket
A personal memory and task manager that Claude works in: raw and processed, in your own git repo, local first.
Skill Collector 8.0k tok · · Q19