Skip to content

Releases: synaptiai/bdsk

Release list

v0.4.0 — Address all 14 plugin improvement proposals

v0.4.0 — Address all 14 plugin improvement proposals Latest
Latest

Choose a tag to compare

View all tags
@danielbentes danielbentes released this 09 Apr 20:05
v0.4.0
a2f1592

What's New in v0.4.0

This release addresses all 14 improvement proposals identified from real-world usage building a Clinical Operations Assistant (50 artifacts, 13 behavior specs, full lifecycle twice). The root cause: skills generated artifacts that didn't conform to the schemas the validator enforced. This release fixes that at every layer.

Schema Compliance (Issues #1, #7, #8)

  • All skill templates now match their JSON schemas exactly. Approval format, trace format, status enums, field names, and metadata structures are all corrected across every skill.
  • New /gate skill for creating complete review_gate artifacts with all 6 required spec fields.

Documentation (Issues #2, #3)

  • Authority matrix (5 canonical roles) documented in CLAUDE.md and every skill.
  • Edge-kind compatibility matrix with common mistakes documented everywhere skills write trace entries.

Scope Enforcement (Issues #4, #12)

  • artifacts/diffs/ and artifacts/execution-plans/ added to governance whitelist in check-scope.sh.
  • New /rescope skill to amend an active execution plan's scope with human approval, breaking the governance deadlock where you need to edit the plan but the plan blocks edits.

Validator Infrastructure (Issues #6, #9, #14)

  • Zero-dependency bundled validators via bun build (0.47MB + 0.53MB). No more npm install required after plugin installation.
  • Real-time schema validation on every artifact Write AND Edit via PostToolUse hook.
  • Phase-level validation checkpoint in /run — validates each artifact immediately after creation with max 3 retries before escalating.
  • Single-file validation via validate-single-artifact.js for quick feedback.

Lifecycle Completeness (Issues #5, #10, #11)

  • Execution log creation (Phase 3.75) added to /run, fixing BDSK-EXEC-004 warnings.
  • Integration Depth Protocol in /specify — demands exact method signatures, enum values, and response shapes when behavior involves third-party SDKs.
  • Auto-suggest review gates in /plan-execution — proposes E2E testing, security, and performance gates based on keyword analysis of behavior specs.

Bug Fixes

  • Fixed generated_diff template edge type (produced_by not depends_on for execution_plan link)
  • Fixed step numbering in bdsk-init.md and plan-execution SKILL.md
  • Fixed assumption authority role from technical_authority to product_authority for product-area assumptions
  • Added missing approval entry to execution plan artifact

Quantitative Impact

Before v0.4.0: 379 schema errors across 50 artifacts (100% error rate)
After v0.4.0: 0 errors, 0 warnings, CONFORMANT (40 artifacts validated)

New Skills

  • /gate <description> — Create review_gate artifacts
  • /rescope <paths> — Amend execution plan scope with human approval

Breaking Changes

None. All changes are backward-compatible.

Full details: bdsk-plugin-improvement-proposals.md

Assets 2
Loading