Skip to content

chore(nix): pin the holochain agent skill to v1.0.0-rc.1 - #146

Merged
Soushi888 merged 1 commit into
devfrom
chore/pin-holochain-skill-rc1
Sep 8, 2026
Merged

chore(nix): pin the holochain agent skill to v1.0.0-rc.1#146
Soushi888 merged 1 commit into
devfrom
chore/pin-holochain-skill-rc1

Conversation

@Soushi888

Copy link
Copy Markdown
Collaborator

SoushAI analysis. Drafted by Soushi's AI assistant, reviewed and posted by @Soushi888.

Intent

The holochain-agent-skill flake input was never pinned to a tag, and flake.lock still held ab02c4f from 2026-04-06, which predates every tagged release upstream. Every nix develop in this repo has been materializing a five-month-old skill into .claude/skills/holochain/, .cursor/skills/holochain/ and .agents/skills/holochain/.

This pins the input to the newest upstream release, v1.0.0-rc.1 (2026-09-04).

Changes

The pin. url now names an explicit tag instead of tracking the default branch, so the skill an agent gets is a decision rather than whatever main happened to be that day.

Two upstream breaking changes absorbed.

  • The repository was renamed to holochain-agent-skills (plural). GitHub redirects, but a lock file should not depend on a redirect, so the URL names the new repo. The input attribute stays singular (holochain-agent-skill) so the nix flake update holochain-agent-skill command documented in CONTRIBUTING.md and the diagrams in pai/README.md keep working unchanged.
  • The skill moved from the repository root to skills/holochain/. Fetching the root used to drag book.toml, SUMMARY.md, CHANGELOG.md, CLAUDE.md, docs/ and .github/ into the installed skill directory; the src now names the subpath, so only the skill lands.

Decisions

v1.0.0-rc.1 targets Holochain 0.7 only, and dev is still on 0.6 (hdk = "^0.6.0", holochain = "=0.6.0", holonix ref=main-0.6). The release notes are explicit that 0.6 content was removed. This is a deliberate choice to land the skill ahead of the 0.7 upgrade in #130 rather than after it, and it is worth naming so a reviewer is not surprised.

Option Rejected because
Pin v0.2.0 (latest 0.6-compatible release) Matches dev's toolchain exactly, but leaves the repo one major version behind and needs a second bump the moment #130 lands.
Leave the input unpinned on main The current state. A nix flake update at an arbitrary moment silently changes what every agent in this repo reads.

Two consequences worth tracking while dev is on 0.6:

  • The installed skill teaches 0.7 APIs, including the Action model rewrite. documentation/TELOS.md and pai/claude/skills/nondominium-domain/SKILL.md both route general HDK questions to this skill.
  • It carries an UpgradeHolochain07 workflow, which is directly useful to chore(deps): upgrade to Holochain 0.7 #130.

How to test

nix develop
ls .claude/skills/holochain/            # assets  LICENSE  references  SKILL.md
grep 'version:' .claude/skills/holochain/SKILL.md   # "1.0.0-rc.1"
ls .claude/skills/holochain/ | grep -E 'book.toml|SUMMARY.md|docs'   # no match

Verified locally: the shellHook completes, all three harness paths (.claude/, .cursor/, .agents/) receive the same four-entry tree, and no workshop files leak in. The locked rev 28b00fc is the v1.0.0-rc.1 tag HEAD.

Documentation

docs: none. Branch prefix is chore/, and the two docs that reference this input (CONTRIBUTING.md line 168, pai/README.md) stay accurate because the input attribute name is unchanged.

Related

The input was unpinned and the lock held ab02c4f from 2026-04-06, which
predates every tagged release of the upstream repository. Two upstream
breaking changes had to be absorbed to move it forward:

- The repository was renamed to holochain-agent-skills (plural). The input
  attribute stays singular so `nix flake update holochain-agent-skill` and
  the references in CONTRIBUTING.md and pai/README.md keep working.
- The skill moved from the repository root to skills/holochain/. Fetching
  the root used to drag book.toml, SUMMARY.md, CHANGELOG.md, docs/ and
  .github/ into the installed skill; the src now names the subpath.

v1.0.0-rc.1 targets Holochain 0.7 only, while dev is still on hdk 0.6 /
holonix main-0.6. The 0.6-compatible release is v0.2.0. Pinning the
candidate here is deliberate: it lands the skill ahead of the 0.7 upgrade
in #130 rather than after it.
@Soushi888
Soushi888 merged commit 59808dc into dev Sep 8, 2026
7 checks passed
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.

1 participant