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

post-merge-publish-watch.mdrules/

alwaysApply:
Yes

Post-Merge Publish Watch

A merge is not a ship

Merging a tile-repo PR puts content on main. The post-merge Review & Publish Tile workflow is what bumps tile.json and pushes the new version to the registry. If that workflow fails, the registry never sees the new contenttessl outdated reports "all up-to-date" against the prior version, and tessl update is a no-op forever.

Watch the post-merge workflow

After every gh pr merge against a tile repo:

  • Locate the post-merge Review & Publish Tile run for the merge commit's SHA. Match BOTH workflow name and head-SHA (gh run list --repo jbaruch/<tile-repo> --workflow 'Review & Publish Tile' --json headSha,databaseId,status,conclusion --jq '.[] | select(.headSha == "<merge-sha>")'; the REST API spells the same field head_sha). Don't use --limit 1 alone.
  • Wait for it to finish: gh run watch <id> --repo jbaruch/<tile-repo> --exit-status, or poll status == "completed". Don't move on while it's in_progress.
  • If the conclusion isn't success, pull the failed step's log, fix the root cause, and land the fix as a follow-up PR. Re-watch on the new run. Don't force-push to main.
  • Every gh invocation in this rule MUST pass --repo per nanoclaw-host: repo-chain.

Verify before declaring done

Two checks, both required (the bump commit lands locally before the registry POST):

  • The bumped tile.json is on the source repo's main (proves patch-version-publish ran).
  • The latest Review & Publish Tile run on main has conclusion: "success" (proves the registry POST landed too).

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