CHANGELOG.md

Changelog

All notable changes to Agentic Kanban will be documented here.

[1.7.3] - 2026-07-08

Added

• Project skill activation roots: Project-local .codex/skills and .antigravity/skills folders are now discovered as active project skill roots alongside .agents, skills, and .claude.
• Settings access clarity: Added a direct board Settings entry point and active workspace context in Project Skills.

Fixed

• Settings opening race: Settings command handlers now wait for board refresh and creation before opening the modal, avoiding intermittent unresponsive Settings clicks.

Changed

• Agentic Kanban reusable skill refresh: Updated the bundled reusable skill guidance for current /goal, /loop, /work, /doctor, /evidence, DoD, and production-readiness workflows.

[1.7.2] - 2026-06-30

Fixed

• Settings modal auto-close: The sidebar Settings button no longer collapses the modal when the board webview rerenders after opening. The modal now keeps its visible tab state and restores the Project Skills pane correctly during refreshes.

[1.7.0] - 2026-06-25

Added

• Screenshots: Added five product screenshots (kanban board, settings, skills, chat commands, dependency graph) to the README to give users a visual walkthrough of the extension.

Fixed

• Screenshot broken links: Screenshot image assets were not tracked in Git and displayed as broken placeholders on GitHub. Images are now committed as part of the release.

[1.6.10] - 2026-06-25

Added

• Multi-Root Workspace Support: VS Code workspaces with multiple folders are now supported as independent project contexts.
• WorkspaceRegistry: A central project context registry manages lifecycle, active project selection, and persistent workspace settings.
• Project Selector dropdown: Switch active projects directly on the Kanban board. Uninitialised projects are labeled and can be initialised independently.
• Dynamic File Watchers: Scoped file watchers are created and disposed cleanly as folders are added to or removed from the VS Code workspace.
• Context-aware Chat commands: @kanban commands and prompting templates auto-route to the active project context.

[1.6.9] - 2026-06-24

Added

• Definition of Done gate: new requireDoneChecklistForDone transition policy (Standard default on) blocks review → done until a ## Definition of Done section in the task body has all items checked. Items carry an optional (agent)/(human) owner tag; human-owned pending items prompt for human sign-off. Complements the existing evidence gate. New "Done Checklist Required for Done" toggle in Settings.

Changed

• /loop redesigned as a profile-aware lane-flow prompt driver. Instead of running shell commands and moving tasks mechanically, /loop [lane] emits the stage-driver prompt for the selected lane into chat. A "Send prompt to chat" button sends the prompt directly to the VS Code chat input with one click (no copy-paste). Clipboard copy is included as a fallback. Default lane is backlog. Lane mapping: Standard backlog -> stage-backlog-to-planning, planning/in-progress -> stage-planning-to-review, review -> stage-review-to-done; Lite backlog/in-progress -> work-on-task. Workspace prompt overrides bundled fallback. Ready-task list (non-blocked, dep-satisfied, matching any --label/--priority filters) is shown so the agent knows the scope. No lanes are moved by the command itself. Gates are still enforced when the agent performs the actual move via the board UI. /prompts remains the general manual prompt picker.

Removed

• /sweep chat command removed. It was a deprecated alias of /loop since the loop-until-dry rework. Use @kanban /loop [lane] instead.

[1.6.8] - 2026-06-24

Added

• /goal command: define a high-level goal as a hybrid epic card + structured goal artifact (.agentkanban/goals/<slug>/goal.md). Copies a profile-aware decompose prompt to clipboard so an agent can break the goal into parent-linked backlog tasks. Subcommands: /goal new <objective>, /goal (dashboard), /goal show <slug>.
• goal frontmatter field on Task: path to the goal artifact for epic tasks.
• goal-decompose.md bundled prompt scaffolded to .agentkanban/prompts/ (Standard and Lite profiles); profile-shaped via {{profile}}, {{lanes}}, {{advance}}.
• Goal artifact template at assets/goal-templates/goal.md with sections for objective, acceptance criteria, success metrics, constraints, out of scope, and decomposition.
• Evidence recording UI in task modal: lint/test/build/behavior checks with Pass/Fail buttons; status persisted to task frontmatter via TaskStore
• Evidence status indicators (✅/❌/—) shown inline in the modal for each check

Changed

• /sweep renamed to /loop (loop-until-dry, profile-aware). /loop runs multiple passes over ready tasks until no task can advance in a pass (or the 25-pass safety cap is hit). /sweep kept as a deprecated alias with a one-line notice.
• /loop is now profile-aware: Standard default lane planning, advance target review; Lite default lane in-progress, advance target done.
• /loop review is refused in Standard profile (human gate guard) with a notice pointing to /evidence and a manual move.
• Tasks carrying a blocked label are excluded from the ready set and not retried in subsequent passes.
• Loop Summary replaces Sweep Summary: shows profile, source/target lanes, passes run, total advanced, parked/blocked, remaining, and cap-hit flag.
• package.json goal chat participant command registered.

Fixed

• Restored Global Stack Templates feature: ~/.agentkanban/templates.yaml stores reusable stack packs across projects
• Settings > Skill Packs > Active Stack dropdown now lists local packs, global templates (prefixed [Global]), and a + Create New Template... option
• Selecting + Create New Template... reveals an inline form (name, stack label, skills, coverage, verify commands); Save writes to templates.yaml, merges into board config, re-scaffolds prompts, and refreshes the dropdown
• Selecting a global template as the active stack auto-merges it into config.packs so resolveVars finds it
• TaskStore now correctly serialises and deserialises evidence, parent, superseeds, supersededBy, blockerResolved fields (were silently dropped on save)
• /evidence chat command: show evidence status or record pass/fail per check
• blockerResolved flag set automatically when blocked/blocked-by labels are cleared during /sweep
• /pack, /work, /evidence commands registered in VS Code command palette

[1.6.7] - 2026-06-24

Added

• /work chat command: QuickPick of not-done tasks, copies a fully interpolated work prompt to clipboard
• work-on-task.md bundled prompt: profile-aware single-task driver (Lite/Standard)
• Profile-aware interpolation vars: {{profile}}, {{lanes}}, {{advance}} resolved from board config
• selectTask() helper refactored for reuse across /task and /work commands

Changed

• resolveVars() now emits profile-specific lane strings and advancement instructions
• Prompt arrays (STANDARD_PROMPT_FILES, LITE_PROMPT_FILES) include work-on-task.md

[1.6.6] - 2026-06-23

Added

• /prompts command now opens a QuickPick of prompt files for arrow-key selection; copies selected prompt content to clipboard
• /prompts refresh preserves the original scaffold/rewrite behavior
• Settings modal Skill Packs tab now shows discovered skills as a checkbox list (replaces free-text input)
• agentKanban.skillsDirs setting to specify additional skill directories to scan
• Settings modal (sidebar): Board Config tab (enforcement, WIP limits, worktree policy, transition policies, review-policy matrix) and Skill Packs tab (activeStack, skills, pack cards)
• labels serialised last in board.yaml for readability

Changed

• Removed "New Task" button from sidebar
• Verification commands section removed from Settings modal
• Settings modal tab buttons styled with underline indicator

[1.6.5] - 2026-06-23

• Restore Branding Assets: copied and renamed the new three-column logos and icons directly from .temp/ to their original repository and documentation locations (images/icon.png, images/kanban-icon.svg, images/kanban-icon-128x128.svg, and docs/src/assets/logo.svg).
• Standard Configuration Integration: removed all custom inline SVG components in favor of Starlight's original configuration layout path.
• Packaging Exclusions: updated .vscodeignore to exclude the docs/ workspace and .temp/ directories, reducing the packaged extension VSIX size from 44 MB to 328 KB.

[1.6.4] - 2026-06-23

• Dependency saving fix: resolved a bug where dependencies added via autocomplete dropdown in the edit/create modal were not saved/persisted because the corresponding blocked-by:<slug> label was not synchronized to the Labels list (causing backend saving logic to clear the dependencies).
• Modal layout alignment: moved Assignee and Due Date fields to the bottom of the modal, and added a dedicated Dependencies input field supporting task autocompletion and chip management synced bidirectionally with task labels.
• Workflow documentation: updated workspace instructions (assets/INSTRUCTION.md and .agentkanban/INSTRUCTION.md) to explicitly document the dependsOn frontmatter array and its bidirectional sync with blocked-by:<slug> labels.

[1.6.3] - 2026-06-23

• Dependency updates: merged Dependabot upgrades for TypeScript 6.0.3, Vitest 4.1.9, @types/node 26.0.0, @types/vscode 1.125.0, esbuild 0.28.1, and Tailwind CSS PostCSS 4.3.1
• Test robustness: resolved test state contamination by restoring mocks in afterEach
• Compiler configuration: added explicit node types dependency mapping in tsconfig.json

[1.6.2] - 2026-06-23

• Parameterized lane sweeps: @kanban /sweep [lane] now supports --label=, --priority=, and --pack=/--stack= filtering flags
• First-class Stack Packs: dynamic stack pack configurations (packs.yaml) for Odoo, Web, Python API, Go, and Frappe automatically seeded on initialize
• Always-on Project Skills: Union of project and active pack skills dynamically synced directly into the AGENTS.md managed sentinel
• Dynamic Prompt Interpolation: prompts under .agentkanban/prompts/ are now automatically populated with stack-specific coverage requirements and verify commands
• New /pack Command: command routing for listing packs (/pack list) and setting the active pack (/pack use <name>)

[1.6.1] - 2026-06-22

• Dependabot baseline (.github/dependabot.yml): weekly grouped npm + GitHub Actions updates
• Profile-aware prompt scaffolding: Lite workspace no longer receives Standard-only stage prompts; getWorkflowPrompt(), buildAgentsMdSection(), scaffoldPrompts() are now profile-aware
• Resilient board search input: debounced live search, Enter immediate commit, focus retention across re-renders
• Workflow doctor diagnostics: new @kanban /doctor command reporting lane drift, stale blockers, dependency cycles, stale worktrees, spec drift, and orphaned deps
• Structured evidence completion gates: TaskEvidence frontmatter with validator; review → done now requires evidence with ran: true, passed: true
• Task lifecycle fields: parent, superseeds, superseededBy, blockerResolved in frontmatter
• README: dependency management section added

[1.6.0] - 2026-06-17

• Add a visual dependency graph dialog to the Kanban board, rendering task connections and supporting details navigation.
• Implement configurable transition policies (requireChecklistForInProgress, requireSpecForInProgress, etc.) in board.yaml.
• Integrate automatic verification check execution (test, lint, and build commands) when moving tasks from in-progress to review on the board.
• Introduce the @kanban /sweep [lane] chat command to automatically run verification policies against all ready tasks in a lane, advancing passing tasks and marking failing ones as blocked.
• Enhance board search/filter keyboard shortcuts (Cmd/Ctrl+K to focus, Escape to clear queries).

[1.5.0] - 2026-06-17

• Bundle stage-driver prompts: written to .agentkanban/prompts/ on init (missing files only, so edits survive) and refreshable with @kanban /prompts. Includes an autonomous planning → review driver plus intake, planning, review, revise, blocked, and production-readiness prompts.
• Add a WIP limit (wipLimits in board.yaml; default in-progress: 1 for the Standard profile). Moving a task into a full lane is blocked (strict) or warned (warn), with the usual human-override path.
• Update the bundled INSTRUCTION.md: in-progress is not a separate human gate — an approved task can run hands-off to review; the human gates are plan approval and review → done. Removed a duplicate execution rule.

[1.4.0] - 2026-06-16

• Surface spec-driven checklists on the board: the checklist button now opens <change>/tasks.md when a task has a change, falling back to todo_<id>.md otherwise.
• Show a SPEC indicator, a done/total checklist-progress badge, and a ⚠ badge (missing change folder / spec file, or a lane outside the active profile) on task cards.
• Treat change, spec, and dependsOn as first-class frontmatter keys (typed, ordered) instead of opaque extras; existing files keep round-tripping.
• Realign @kanban /spec to the capability-spec model: it writes one shared .agentkanban/specs/<capability>/spec.md, links the task via both change and spec frontmatter, and no longer scaffolds a nested changes/<slug>/specs/ delta.
• Refresh the bundled spec templates (proposal / design / spec / tasks) to the behavior-and-acceptance shape; spec is a living contract, not an OpenSpec delta.
• Add @kanban /archive [slug] to move a completed change folder to changes/archive/, leaving the shared capability spec in place.
• Fold tasks with a lane outside the active profile into the last lane instead of dropping the card.

[1.3.2] - 2026-06-16

• Prepend a documented reference comment header to serialized board.yaml configuration files, detailing profile settings, enforcement rules, and reviewer roles.

[1.3.1] - 2026-06-16

• Wire enforcement and reviewPolicy configurations to make them functional in board lane transitions.
• Add strict vs. warning-based transition validation, returning structured transition blocker reasons.
• Support capture of human override reasons via input boxes, logging them as comments in task files.
• Inject live enforcement and priority-aware reviewPolicy context into managed AGENTS.md instructions.
• Add setting option for default board enforcement mode (agentKanban.enforcementMode).

[1.3.0] - 2026-06-16

• Expose board profile and worktree configuration options in VS Code settings.
• Seed new board.yaml files from user settings.
• Add "Apply Settings to Board Config" command to update existing boards with a modal confirmation safeguard for potential lane conflicts.
• Wire agentKanban.enforceWorktrees setting into the /refresh workflow as a soft gate.
• Centralize workspace settings resolution and add helper test suites.

[1.2.0] - 2026-06-15

• Add opt-in spec-driven development with @kanban /spec.
• Scaffold OpenSpec-compatible change artifacts under .agentkanban/changes/<task-slug>/.
• Persist task-to-change links through frontmatter as change: .agentkanban/changes/<task-slug>.
• Extend AGENTS.md task context so linked spec artifacts are re-read across turns.
• Add bundled spec templates and documentation for the MVP workflow.
• Publish a comprehensive source-available project README and align repository and release metadata.

[1.0.0] - 2026-06-15

• Fork release for Agentic Kanban under independent versioning.
• Standard workflow no longer uses a dedicated blocked lane. Blockers stay visible on the task card through blocked and blocked-by:<slug> labels.
• Legacy lane: blocked tasks automatically migrate back to resumeLane or backlog when reopened.
• Task frontmatter keeps unknown metadata such as dependsOn across saves, and blocked dependency labels render with warning styling on the board.

[2.0.0] - 2026-03-12

• Major change to support Git worktree based workflows, leveraging VS Code support for Git worktrees
• /plan, /todo, /implement @kanban participant commands are gone in favour of /refresh for non worktree based workflow
• Automatic commit of tasks when creating Git worktrees (for availability in new worktree)
• Documentation updated

[1.0.5] - 2026-03-11

• Bump esbuild version on dependabot alert

[1.0.4] - 2026-03-11

• Fix side bar / board focus behaviour

[1.0.3] - 2026-03-10

• Bugfix: Agent should not initialise workspace automatically - requires user action.

[1.0.2] - 2026-03-10

• Bugfix: Fix task editor close on mouse event bug.

[1.0.1] - 2026-03-10

• Chore: Bump releases.

[1.0.0] - 2026-03-09

• Feature: Directory based task / lane synchronisation to prevent a large singe tasks directory
• Feature: Layered agent instruction approach

[0.3.0] - 2026-03-09

• Feature: Major UI overhaul - board moved to editor tab from side bar

[0.2.1] - 2026-03-07

Added

• Chore: Name bump
• Feature: Release polish

[0.1.2] - 2026-03-07

Added

• Chore: Extension .gitignore under .agentkanban
• Feature: Re-ordering swimlanes with deletion rules

[0.1.1] - 2026-03-07

Added

• Feature: Initial release.