Skip to content

v0.2.5.0 — Staged-goal behaviors (repaired for Claude install)

Choose a tag to compare

View all tags
@theislampill theislampill released this 07 Jun 23:30
· 700 commits to main since this release
v0.2.5.0
b8baa63

v0.2.5.0 - Staged-goal behaviors (repaired for Claude install)

v0.2.5.0 adapts useful staged-goal behaviors into runtime contracts.

Highlights

  • Strengthened Stage 0 context/tool/memory/sidecar detection.
  • Strengthened Stage 1 routing with full greenfield category intake and brownfield 0-2 true-gap questions after recon.
  • Added namespaced run-root claiming with .IMPLEMENTAUDIT/runs/<task-slug>-<id>/ and skills/scripts/claim-run.sh.
  • Strengthened Stage 6 self-critique/review menu and Stage 6.5 red preflight discipline.
  • Added bounded continuity via CONTINUITY_DECISION.
  • Strengthened Graphify and ActiveGraph boundaries: optional, noncanonical, absent-safe, and excluded from package debris.
  • Strengthened Capability Ledger wording so entries are derived from recorded evidence, not broad competence claims.

Release assets

  • IMPLEMENTAUDIT.skill SHA256: 53b56a5dba67263ef9648289980982b75d0b037acc6ece41811346e9fe425566
  • CHECKSUMS.txt — bounded artifact-integrity evidence for the uploaded .skill asset.
  • The checksum manifest is not a signature, attestation, SBOM, license, marketplace verification, universal host support, passive update mechanism, or import proof.

Archive root shape

The .skill archive is structured for Claude Desktop import:

IMPLEMENTAUDIT.skill (ZIP):
  SKILL.md              ← at archive root
  references/
  scripts/
  templates/
  .claude-plugin/
    plugin.json
    marketplace.json

Validation (repair HEAD: 0a42476)

  • GitHub Actions validate passed for repair HEAD 0a42476.
  • Local package verification passed with bash scripts/verify-package.sh.
  • Release asset build validation passed including root-shape regression guard.
  • Codex install smoke passed (stale checksum, overbroad archive, sidecar-output rejection).
  • Claude archive smoke passed (same canaries, wrong-root-shape rejection added).
  • Live public v0.2.5.0 asset redownloaded and verified against CHECKSUMS.txt.

Boundaries

  • No root IMPLEMENTAUDIT.md behavior file is included or recreated.
  • No marketplace verification, universal host support, license claim, passive update automation, signature, attestation, SBOM, or broader provenance claim is made.

Post-release repair (2026-06-07): LIVE_V0_2_5_0_CLAUDE_INSTALL_BROKEN

Primary root cause: The original .skill archive had the wrong root shape.
Skill content was nested under skills/SKILL.md but Claude Desktop import requires
SKILL.md at archive root. The archive was accepted by the Codex installer (which
reads from skills/ explicitly) but rejected by Claude Desktop with "malformed at root."
No live Claude Desktop import was run in the original release gate.

Secondary root cause: No Claude Desktop install/import path was documented,
scripted, or smoke-tested.

What was fixed (repair HEAD: 0a42476)

Archive root shape (primary fix):

  • scripts/build-release-asset.sh: strips skills/ prefix; SKILL.md now at archive root.
  • .claude-plugin/plugin.json: skills field changed from "./skills/" to "./".
  • scripts/install-codex-from-release.sh: updated for new root shape.
  • scripts/install-claude-from-release.sh: updated for new root shape; relabeled as
    "file-copy workaround only — NOT Claude import proof."
  • tests/release-asset.test.sh: regression guard added (skills/SKILL.md in archive = hard failure).
  • scripts/verify-package.sh: plugin skills path check updated.

Claude install coverage (secondary fix):

  • Added scripts/install-claude-from-release.sh (file-copy workaround, labeled as NOT import proof).
  • Added tests/release-asset-install-claude.test.sh for Claude archive shape smoke.
  • Added Claude Desktop install path and boundaries to README.md §Install notes.
  • Added anti-repeat rule LIVE_V0_2_5_0_CLAUDE_INSTALL_BROKEN to AGENTS.md.

Tag repair

  • v0.2.5.0 tag moved to repair HEAD 0a42476 (new tag object d641275...).
  • GitHub source archives now contain the fixed builder, tests, and archive validator.
  • Original tag 8df3c07c and all intermediate repair commits documented in audit ledger.

Archive SHA

  • Repaired archive SHA256: 53b56a5dba67263ef9648289980982b75d0b037acc6ece41811346e9fe425566
  • Changed from original a4d953d... due to structural root-shape fix (not platform artifact).

Boundaries after repair

  • Live Claude Desktop import proof: pending manual verification after Claude Desktop reload.
    The archive root shape is now correct for Claude import. Verify by downloading
    IMPLEMENTAUDIT.skill from this release and importing via Claude Desktop's skill import UI.
  • scripts/install-claude-from-release.sh is a file-copy workaround only.
    It is NOT proof that Claude Desktop can import the .skill file.
  • Dogfood of /implementaudit from v0.2.5.0 release asset requires Claude Desktop restart
    after import.

Audit ledger: docs/audits/v0.2.5.0-claude-install-repair.md

Assets 4
Loading