v0.3.0

[0.3.0] - 2026-05-20

Added

• Orchestration CLI — aps next resolves the next ready work item across
  modules, honouring work-item and module-level dependencies (ORCH-001).
• State-machine commands — aps start <ID> and aps complete <ID> enforce
  the Ready → In Progress → Complete lifecycle. start validates that every
  dependency is Complete; complete requires the item to be In Progress and
  stamps Status with the UTC date (ORCH-002).
• Context packaging — aps start writes .aps/context/<ID>.md with the
  work item, module scope, decisions, dependency learnings, and related files
  (ORCH-003). Gitignored, regenerated on each start.
• Dependency graph — aps graph [module] renders work items with their
  upstream dependencies and per-item status (ORCH-004).
• Learning capture — aps complete --learning "..." inserts a
  - **Learning:** line after - **Validation:** (per ORCH D-002). Learnings
  travel with the work item and surface as "Dependency Learnings" in downstream
  context packages.
• v2 layout migration — aps migrate converts existing projects to the
  .aps/ consolidated tooling root, with shell-prompt wizard.
• TUI init wizard — first Ratatui-based onboarding flow for aps init
  (TUI-001).
• Multi-agent ports — APS agents ported to Codex, GitHub Copilot, OpenCode,
  and Gemini in addition to Claude Code; added APS planner, librarian, and
  conductor agents.
• Global install — --global flag for system-wide CLI installation.
• Designs folder — designs/ added as a standard APS artifact for design
  documents alongside specs and plans.
• Wave-based execution — action plans support wave-based parallel execution
  guidance for concurrent agents.

Changed

• Scaffold renamed steps.template.md → actions.template.md end-to-end to
  match the "Actions" terminology used in Work Items and prompts.
• Skill install decoupled from aps init — install once globally, opt in per
  project.
• /plan skill auto-bootstraps aps init and performs a version check.
• Canonical primary branch promoted from dev to main; CI updated.
• TUI framework decision: Rust + Ratatui (replacing earlier OpenTUI/Bun
  exploration).

Fixed

• Installer: only matching runtime files installed; legacy init runtime files
  included; piped installs prompt correctly; APS orchestration library
  installed; PowerShell variant includes orchestrate library.
• PowerShell scripts write BOM-free session baseline files.
• Module status row parsing skips the markdown separator row.
• Scaffold backs up aps-rules.md and hook scripts during migration.

v0.2.0

First release of Anvil Plan Spec (APS).

Added

• Templates — Index, Module, Simple, Actions, and Quickstart templates in templates/
• Scaffold — One-command setup via curl | bash with --update support
• Validation CLI — aps lint command to validate APS documents with CI integration
• Hooks system — SessionStart, PreToolUse, PostToolUse, Stop hooks with install script and hook configuration
• PowerShell port — Full PS CLI (aps.ps1), scaffold module, all hook scripts ported to PS, one-liner PS install/update
• CLI improvements — init and update subcommands, improved validation rules (field checks, ID regex), issues tracker rule
• Docs restructure — Extracted installation guide, CLI usage guide, AI agent guide from README; README refocused as landing page
• Prompts — Tool-agnostic and OpenCode/Claude variants in docs/ai/prompting/
• Examples — User Authentication and OpenCode Companion worked examples
• Planning specs — v0.3 install and agents module specs (meta: APS plans its own development)
• Documentation — Getting started guide, workflow guide, ADR template, project structure
• Roadmap — Planned features and direction
• Claude Code Tasks — Integration guidance in aps-rules.md

Changed

• Renamed "Leaf" template to "Module" for clarity
• Renamed "Steps" template to "Actions" for clarity
• Changed SCOPE placeholder to ID in templates to avoid confusion with In/Out Scope sections