CtrlK
BlogDocsLog inGet started
Tessl Logo

jbaruch/nanoclaw-host

Skills and rules for the NanoClaw host agent (Claude Code on Mac). Tile promotion, container management, staging checks, repo chain safety, and public sync.

77

Quality

97%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

cross-tier-skill-state.mdrules/

alwaysApply:
Yes

Cross-Tier Skill State

Cross-trust-tier skills — those that may run in untrusted, trusted, AND main containers — must persist state under /workspace/state/<skill-name>/. Tier-pinned skills (admin-only, trusted-only) may use /workspace/group/.

Mount semantics

  • /workspace/state/<skill-name>/ is RW in every container regardless of trust tier
  • /workspace/group/ is RW for trusted/main and RO for untrusted
  • The mount is wired in src/container-runner.ts of jbaruch/nanoclaw (search for '/workspace/state')

When to persist vs compute

  • Persist under /workspace/state/<skill-name>/ when the skill needs continuity across runs
  • Skip persistence when the value is derivable on demand — e.g., nanoclaw-core/status computes container uptime from /.dockerenv mtime

Reference implementations

  • nanoclaw-core/check-unanswered/scripts/unanswered-precheck.py reads/writes /workspace/state/check-unanswered/
  • nanoclaw-admin/brief-cleanup writes /workspace/state/brief-cleanup/
  • nanoclaw-core/status avoids persistence entirely

Both patterns are valid — pick the simpler one for the skill.

rules

boyscout-host.md

copilot-nudge-after-10min.md

cross-tier-skill-state.md

dual-agent-coexistence.md

host-conventions.md

no-deferral.md

no-error-suppression.md

nuke-semantics.md

orchestrator-dep-refresh.md

overlay-tile-authoring.md

post-merge-publish-watch.md

repo-chain.md

staging-diff-protocol.md

tessl-version-floating.md

tile-content-pipeline.md

README.md

tile.json