~ / rigs / persxn / calamity-framework

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

↗ GitHub ★ 0 MIT updated 20d ago project Claude Code Claude plugin
stack: Python
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~2.8k tokens
Moderate · median rig: 2.3k · breakdown
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)

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

copied ✓