Task Unblocker

Task Unblocker is a Markdown-first Codex plugin for people who cannot complete a task, assignment, or challenge and need a structured way to understand why.

It starts with the user's problem statement, builds a recursive Blocker-Graph, chooses an appropriate working mode, and produces a German step-by-step Markdown action plan.

The plugin is intentionally small in v1. It does not provide a browser UI or MCP app. Instead, it creates clean Markdown artifacts that can later be rendered by a graphical interface.

What It Does

• Captures the task, problem, or challenge.
• Captures a short session profile: role, context, energy/load, constraints, and preferred support style.
• Proposes one working mode and asks the user to confirm it:
  • Business-Consulting
  • Task-Coaching
  • therapy-near reflection
• Builds a recursive top-down and bottom-up Blocker-Graph.
• Shows graph changes and open questions after each round.
• Writes a final German action plan once the user accepts the graph and plan.

LLM-Wiki Pattern

Task Unblocker follows Andrej Karpathy's LLM-Wiki pattern: a persistent Markdown wiki sits between the user and the raw conversation. The wiki accumulates structure instead of rediscovering the problem from scratch on every question.

For each workspace, the plugin writes to .task-unblocker/:

.task-unblocker/
+-- index.md
+-- log.md
+-- cases/
    +-- <date>-<slug>/
        +-- session-profile.md
        +-- problem.md
        +-- graph.md
        +-- timeline.md
        +-- final-plan.md

graph.md contains a Mermaid Blocker-Graph. timeline.md contains the story/history. final-plan.md is the user-facing step-by-step guide.

Safety Boundary

Task Unblocker is not therapy, diagnosis, medical advice, legal advice, or crisis support.

The therapy-near mode is limited to reflection, stabilization, and practical task support. If the user describes self-harm, harm to others, acute crisis, abuse, a diagnosis request, or a treatment request, the skill stops the coaching flow and directs the user toward professional or urgent help.

Local Development

The Codex plugin manifest is at .codex-plugin/plugin.json, and the main skill is at skills/task-unblocker/SKILL.md.

Install In Codex

This repository is also a Codex marketplace. Add the public GitHub repo as a marketplace:

[marketplaces.moinsen-task-unblocker]
source_type = "git"
source = "https://github.com/moinsen-dev/task-unblocker.git"

The marketplace manifest lives at .agents/plugins/marketplace.json and points Codex at this repository root, where .codex-plugin/plugin.json defines the plugin.

Validate the plugin from this repo root:

python3 /Users/udi/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py /Users/udi/work/moinsen/opensource/task-unblocker

The plugin has no runtime dependencies in v1.