claude

predictive-mind

FEP/World-Models scaffolding for stable LLM coding agents: predict-before-act, inspectable belief state, and surprise-triggered reflection.

0 on GitHubby predictive-mind contributorsv0.1.1MITupdated 6 months agoagent-workflow
/

Plugin predictive-mind from marketplace jasonhch-plugins in jason-hchsieh/marketplace. Commands read from the repo's manifest — 1 month ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (5)

  • checkpoint

    Snapshot the current belief state (and optionally git-stash the working tree) under a label, so a risky action can be rolled back if it produces high surprise or breaks acceptance tests.

  • plan-efe

    Given a goal and a set of candidate next actions, rank them by Expected Free Energy (pragmatic + epistemic value) using past similar episodes, and pick the winner. Delegates scoring to the policy-selector subagent.

  • predict

    Record an explicit predicted observation before a side-effecting tool call. Use whenever you are about to run a command, edit a file, or invoke any tool whose outcome you have not already observed. Upholds the predict-before-act invariant.

  • probe

    Run a cheap, reversible real probe to ground a belief instead of hallucinating. Use when dreamer confidence is low or when you catch yourself guessing about repository state.

  • reflect

    Surprise-triggered reflection. When a PostToolUse hook reports high prediction error (surprise >= 0.6), invoke /reflect to update beliefs via the belief-reviser and decide whether to continue, replan, reclarify, or ask the user.

Subagents (5)

  • belief-reviser

    Perceptual-update role. Given a surprise report (prediction vs actual observation) and the current beliefs, revises the belief entries for the task. Has NO filesystem or shell access — it can only read predictions and write beliefs via the belief-store MCP server.

  • cartographer

    Builds the initial task card (z_0) for a coding task by mapping the repo, identifying in-scope files, and enumerating relevant tests. Invoke at task start or after a major scope change. Read-only; does not modify files.

  • dreamer

    Counterfactual prediction for a proposed action. Given a task card and a candidate action (diff, command, or tool call), predicts the next observation — which tests will pass/fail, what errors appear, and the blast radius. Read-only; does NOT execute actions.

  • hierarchy-arbiter

    Decides whether a string of unresolved prediction errors should stay at the edit-level (keep trying), escalate to re-planning, or escalate to asking the user. Pure judgment — no file, shell, or belief-write access.

  • policy-selector

    Scores a set of candidate next actions by Expected Free Energy (EFE) — pragmatic value (goal progress) plus epistemic value (information gain) — using the current belief state and past similar episodes. Returns a ranked list with rationale. Has NO filesystem access; only calls belief-store MCP tools

Hooks (2)

  • SessionStart

    bash "${CLAUDE_PLUGIN_ROOT}/scripts/bootstrap.sh"

  • PostToolUse

    node "${CLAUDE_PLUGIN_DATA}/belief-store/dist/post-tool-use.js"

View source on GitHub

More from jason-hchsieh/marketplace

All 3 plugins →

Inline code review with MCP integration — add comments in the browser via SSH port forward, let Claude Code read and fix them via MCP tools.

3 skills · 1 MCP server · hooks

0

Developer toolkit for auditing harness maturity (L0-L4), setting up AGENTS.md, configuring linters, hooks, CI, and skill creation workflows.

1 skill

0

Similar plugins

把本地文件夹建成 Agent 可稳定查找、收录和维护的知识库,并支持导航、版本判断、健康检查及 SOT 分层治理。用户要求搭建、查询、更新、整理或瘦身知识库时使用。

1 skill

dontbesilent2025/dbskill 11,416

Builder Skills

claudecodex

Public Builder skills for docs-first discipline, autonomous execution, cross-agent review, local-first Rewind memory, efficient agent workflows, clear status recaps, Agent-Native workflow apps, and experimental configurable software factory workflows.

26 skills · 1 command · 1 MCP server

BuilderIO/skills 4,668

Official br (beads_rust) skill: create, triage, and unblock issues; find ready work; keep SQLite and issues.jsonl in sync. Agent instructions only — the br binary is installed separately.

2 skills

Dicklesworthstone/beads_rust 1,154

Fable-style Codex workflow with source-section coverage, goal and findings gates, verification grounding, VFF routing, and optional provider bridge guidance.

1 skill

baskduf/FableCodex 437

entire

claudecodex

Cross-agent skills and commands powered by Entire

12 skills

entireio/skills 240

MCP server for Agent SOP integration providing Standard Operating Procedures (SOPs) for AI agents with markdown-based workflow definitions, RFC 2119 compliance, and comprehensive SOP authoring skills.

6 skills · 1 MCP server

TheBushidoCollective/han 200

Maintain predictive-mind?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins3 plugins