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
- Rank — /rank - Triage Scraped Jobs into a Ranked Shortlist 36.6k ★
- Resume Work From A Handoff Document — You are tasked with resuming work from a handoff document through an interactive process 10k ★
- Breach Check — HIBP k-anonymity check on a password wordlist 4.5k ★
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
Decision
You MUST record decisions when the reasoning is non-obvious or context-dependent. Future sessions lose context
Logic Reducer
Act as a Senior Formal Methods Architect and Perl SDET. Apply syllogistic logic, deductive reasoning, and bool
Build Revenue Projections
Build comprehensive revenue projections with market analysis, customer modeling, and scenario planning
Scaffold Projections
Genera el worker de proyecciones .Projections (daemon asincronico HotCold de Marten, seam de observabilidad Co
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
