Black Box — Development skill for Claude Code
A local ledger coding agents write their reasoning into and read back before they act.
How to install Black Box
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open nathanmauro/black-box and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Black Box does
A local ledger coding agents write their reasoning into and read back before they act. Codex and Claude Code share one store: typed decisions, handoffs, and ranked future projections, recalled by repo, topic, or event id.
Alternatives in Development
- Resume Work From A Handoff Document — You are tasked with resuming work from a handoff document through an interactive process 10k ★
- Htb Writeups — The most comprehensive Hack The Box writeup collection - 500+ machines, 400+ challenges, interactive knowledge 244 ★
- Lofp — Legends of Future Past, the classic commercial MUD form the 1990's 180 ★
README
Black Box
Local-first memory and coordination for coding agents.
Preserve decisions. Claim work atomically. Leave typed handoffs.
Let the next agent start with context instead of archaeology.
Black Box is a writable memory bus and coordination ledger for Codex, Claude Code, and other MCP clients. Agents commit the reasoning worth preserving, coordinate through a durable task queue, and recall exact or semantically related structured decisions and completion handoffs in later sessions.
The Black Box server is deliberately not an agent runner. It records intent, arbitrates ownership, and exposes state; your agents and orchestrators still execute the work.
| Remember | Coordinate | Observe | Stay local-first |
|---|---|---|---|
| Typed Decisions, Handoffs, Observations, alternatives, confidence, and open loops | Frozen specs, exact-lane queues, atomic claims, lifecycle rules, and completion Handoffs | Activity, logical Projects, project-aware Board, semantic structured Recall, search, SSE updates, and stats | SQLite by default; optional PostgreSQL for a shared server; search indexes and models remain op |
Related Skills
Notary
A black-box recorder and approval gate for any Claude skill. Tamper-evident, human-approved execution receipts
Binary
Black-box binary investigation — autonomous ranking, map, parser tracing, fuzz, graph, report, handoff, diagra
Map Buy Box
Map a buy box to a ranked list of off-market companies — the full five-step run, with an approval gate before
Decision
You MUST record decisions when the reasoning is non-obvious or context-dependent. Future sessions lose context
Session Pickup
Resume a paused session from a docs/handoffs/ .md file — loads the goal, in-flight reasoning, and next step
Regroup
Regroup — find the plans, handoffs and branches about this work, and name the one thing in them ready to ship;
Related Agents
Worker Validator
Black-box runtime validator (#256). Given a PR + its validation-contract.md, RE-RUNS each assertion's command
Smoke Test Writer
Escribe smoke tests black-box contra el entorno dev desplegado. Asume que el proyecto SmokeTests ya existe.
Blackbox Contract
Black Box Architecture Agents Contract v2.0
