v0.3.0

Added

• vine:optimize — New command that audits skill descriptions, detects workflow chains, analyzes token efficiency, and optimizes interactivity patterns across all commands and skills.
• Reusable agents — vine-codebase-explorer (deep codebase research) and vine-verification (lint/typecheck/test + acceptance criteria checking) shipped in agents/, installed flat to .claude/agents/ by the CLI.
• Skill Workflows in CLAUDE.md — 5 named workflows (Feature Delivery, Quick Fix, Session Management, Maintenance, Contributor PR Flow) with state-based suggestions for command routing.
• Agent delegation — verify, inquire, navigate, and evolve now delegate to the reusable agents for codebase exploration and validation.
• Evolve-to-optimize chain — Evolve suggests running /vine:optimize when a cycle produces new skills or command changes.
• Trellis-to-PR chain — Trellis suggests /pr when all checks pass and command files have uncommitted changes.

Changed

• Description rewrites — 12 command/skill descriptions rewritten for Claude's ~250 char matching window (+78% matching surface).
• Token consolidation — Collaboration stance and engineer profile protocol moved from 7 command files into .vine/hooks/shared.md (~150 tokens/session saved). Commands reference shared.md instead of repeating the blocks.
• Navigate gearing — Changed from free-text response to structured AskUserQuestion with 2 options. Recommended default follows profile expertise level.
• Navigate blocker handling — Changed from prose option lists to structured AskUserQuestion with concrete resolution paths.
• Pair commit confirmation — Changed from free-text approval to structured AskUserQuestion with 3 options.
• Navigate principles trimmed — Removed principles that restated what the command steps already demonstrate.
• CLI install output — Now reports agent count alongside command count.
• Command count updated from 10 to 11 across CLAUDE.md, README, hooks, and trellis.

v0.2.0

Added

• Collaboration stance — Replaces the passive depth hint across 7 commands with a partnership model: philosophical anchor + three concrete behaviors (flag uncertainty, grow through the work, let expertise shape engagement).
• Per-slice gearing — Navigate offers "free climb" (auto-accept, lighter narration) or "walk me through this" (full partnership) per slice. Profile expertise informs the default, engineer always chooses.
• Navigate completion gate — Phase Completion now verifies every slice has a commit hash, validation status, acceptance criteria, and learnings before suggesting evolve. Lists gaps and fixes inline.
• Verify scope check — After exploring the landscape (step 3b), verify evaluates whether the full cycle is warranted or vine:pair would suffice. Off-ramp for simpler-than-expected work.
• Verify gearing note — Completion block includes a navigate gearing recommendation based on observed complexity.
• Evolve ticket creation — Follow-up items can become GitHub issues (or tickets via hook-defined workflows for Jira, Linear, etc.).
• Gear-linked check-ins — Between Slices includes a brief reflection after partnership-mode slices, skipped after free climb.
• STATE.md field markers — NAVIGATION.md template fields marked <!-- required --> or <!-- optional --> matching the gate check.
• PROJECT-MAP.md — Universal progress tracker created by verify, updated by all phases. Shows VINE phase status at a glance. For multi-PR features, inquire adds a Milestones table mapping phase groups to PRs with status markers.
• vine:status — Quick read-only progress check. Lighter than resume — no session state, no recommendations.
• vine:help — Command reference and usage guide.
• Multi-PR tracking — Inquire auto-detects larger features (>4 slices or phase groups) and offers milestone tracking. Navigate runs phase-group verification before suggesting PRs at phase boundaries.
• Evolve commit + PR flow — Evolve now commits its artifacts and suggests opening a PR after marking resolved.
• Resume PR backfill — Resume prompts to fill in missing PR numbers on shipped milestones.
• Cross-reference notes between navigate phase-group verification and evolve product verification to prevent drift.
• .vine/ artifacts tracked — Per-phase hooks and resolved project artifacts committed for contributor context.
• Artifact preview docs — Guide for rendering VINE artifacts with glow and Claude Code hooks.
• "Is VINE for you?" — README section helping users quickly determine if VINE fits their workflow.

Changed

• NAVIGATION.md update merged into step 4 — Journal update is now a commit prerequisite, not a separate step. Old step 5 removed, steps renumbered 1-8.
• Evolve user evolution reframed — "Knowledge Captured" → "Engineer Contributions" (what you brought, not what you learned). "Suggested Explorations" removed. Growth log is opt-in with skip as default.
• Navigate output is now committed changes (one commit per validated slice), not staged changes.
• Evolve reads PROJECT-MAP.md for multi-PR context and reviews prior PRs via gh CLI when available.
• Pause detects current phase from PROJECT-MAP.md before falling back to artifact detection.
• Resume displays VINE Progress and Milestones from PROJECT-MAP.md in status summary.
• README updated with partnership model, per-slice gearing, and revised Key Principles (leads with "Partnership, not delegation").
• Command count updated from 8 to 10 across CLAUDE.md, README, hooks, and trellis.

v0.1.2

Fix: Projects directory convention

• vine:init now creates .vine/projects/ during setup
• Generated shared.md template includes the project directory convention
• Prevents project artifacts from being created as siblings of hooks/ instead of under projects/

Fix: npm provenance publishing

• Fixed repository URL casing in package.json (modulomoments → moduloMoments)

v0.1.1

Fix: Projects directory convention

• vine:init now creates .vine/projects/ during setup
• Generated shared.md template includes the project directory convention
• Prevents project artifacts from being created as siblings of hooks/ instead of under projects/

v0.1.0 — Initial Release

Grow features on solid roots.

VINE is a command chain for AI-assisted feature development in Claude Code. It keeps the engineer connected, learning, and steering throughout — not watching from the sidelines while an AI codes autonomously.

Install

npx create-vine --global

What's included

8 commands:

• vine:init — Scaffold project hooks based on repo discovery
• vine:verify — Context-building spike with your codebase
• vine:inquire — Feature specification and design
• vine:navigate — Guided implementation with commit-per-slice
• vine:evolve — Triple evolution: product, agent, and engineer
• vine:pair — Lightweight pair programming for quick fixes
• vine:pause — Capture session state when stepping away
• vine:resume — Pick up where you left off

Key features:

• Project hooks (.vine/hooks/) — customize VINE for your repo's tools, conventions, and CI
• Engineer profile — tracks domain expertise so commands adjust explanation depth
• State artifacts — human-readable files that survive across sessions and handoffs
• Project lifecycle — resolve and archive completed features

Links

• README — philosophy, usage, and full documentation
• Contributing — how to get involved