CtrlK
BlogDocsLog inGet started
Tessl Logo

jbaruch/nanoclaw-core

Core behavioral rules and skills for NanoClaw personal assistant agents. Always-on rules for communication, verification, memory, and formatting.

71

Quality

88%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Overview
Quality
Evals
Security
Files

ground-truth.mdrules/

alwaysApply:
Yes

Ground Truth — Verify Before Claiming

Any factual claim must be backed by a live check. Memory is not a source. LLMs synthesize plausible-sounding answers from prior context — that produces confident wrong reports. Whether the question is tile inventory, scheduled tasks, file contents, or past actions: the model's memory of what should be there is not the same as what is there.

Pre-claim verification

Claim typeHow to verify
Files / skills / rules existls, Glob, or Read
File contentsRead the file
Task was scheduledCheck the scheduler response / list_tasks
Tool call succeededCheck the tool return value
Calendar eventFetch from Google Calendar
Email contentFetch from Gmail
Config / state valueRead the actual file

If you can verify it, you must verify it. Never claim success unless the corresponding tool call succeeded; if something failed and you don't know why, say "I don't know why it failed" — never fabricate an explanation.

Post-action verification

Tool-call success means the tool ran — not that the outcome is what you intended. After any state-mutating call verify the outcome independently:

ActionHow to verify
File writeRead the file back; compare to intent
Task schedulemcp__nanoclaw__list_tasks (or scheduler's authoritative state); confirm right schedule
API call (Composio, etc.)Both response status AND body — a 200 doesn't mean the data is correct
Memory updateQuery/list the memory store; confirm saved content matches
IPC sendConfirm file at /workspace/ipc/messages/ with expected payload

Stale memory

Recalled values (file paths, task state, deploy freeze, config flags) are a special case of "world changed since you last looked". Verify against the live source before acting. Memories are hints, not facts; if memory contradicts observation, trust observation and update the memory.

When to check

Any "what's installed / what exists" question, any "did X happen" claim, any report on current system state, any answer that could be wrong if the world changed since you last looked. When in doubt: check first, then answer.

rules

context-recovery.md

core-behavior.md

default-silence.md

ground-truth.md

language-matching.md

post-compaction-trust.md

progress-updates.md

query-size-limits.md

read-full-content.md

telegram-protocol.md

temporal-awareness.md

tone-matching.md

README.md

tile.json