Skip to content

fix(proto): close 12 critical gaps from Karpathy Protocol audit#13

Open
nimmitstar wants to merge 2 commits intomasterfrom
fix/protocol-audit-critical-fixes
Open

fix(proto): close 12 critical gaps from Karpathy Protocol audit#13
nimmitstar wants to merge 2 commits intomasterfrom
fix/protocol-audit-critical-fixes

Conversation

@nimmitstar
Copy link
Copy Markdown
Contributor

What

Self-audit via Claude Code found 38 issues (12 critical) in brain files. This PR fixes all 12 criticals.

Changes

SOUL.md — Think-Out-Loud applies to ALL multi-step tasks (no exceptions), renamed Think Before Coding→Acting, verification criteria table, fixed Caveman vs Think-Out-Loud conflict, 5 new anti-patterns, decision retrieval protocol, task abandonment protocol, emergency protocol, human handoff triggers, requires-human-review list, reserved NON-NEGOTIABLE for safety only.

AGENTS.md — Karpathy Protocol references SOUL.md as single source of truth, role handoff protocol, emergency protocol, metadata trust model, git conflict resolution, project-specific routing clarification.

HEARTBEAT.md — Workspace sync failure modes, scheduled task failure modes, role health check inline fallback, pattern definition (3x/7d), token efficiency target, urgent escalation path.

MEMORY.md — Memory type decision tree, context budget per session, Khmer review spec.

HANDOFF.md — New file. Handoff format, processing checklist, response templates, archive rules.

Trigger

Hermes Agent competitive analysis task revealed Nimmit skipped its own protocol. Audit exposed systematic gaps.

SOUL.md: Think-Out-Loud ALL multi-step tasks, Think Before Acting
(rename), verification criteria table, Caveman alignment, 5 new
anti-patterns, decision retrieval, task abandonment, emergency
protocol, human handoff triggers, requires-human-review list.

AGENTS.md: single source of truth (SOUL.md), role handoff protocol,
emergency protocol, metadata trust model, git conflict resolution.

HEARTBEAT.md: failure modes, escalation path, token budget.

MEMORY.md: memory type decision tree, context budget.

HANDOFF.md: new file — handoff format, processing, templates.
@nimmitstar nimmitstar requested a review from rithythul as a code owner April 17, 2026 05:18
After ≥5 tool calls, auto-save non-trivial workflows as reusable
skills. Covers error recovery, user corrections, first-time task
types. Skills self-improve during use.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants