devspecs

Changelog

Release notes stay close to the CLI.

The website summarizes everyday commands. GitHub remains the source for binaries, release assets, issues, and code changes.

v1.3.0: Cleaner task and workspace command surface

  • `ds apply` with no argument emits the unambiguous next one-slice prompt, so the happy path is task, apply, checkpoint.
  • `ds task --quick` creates a compact task workspace for smaller changes.
  • `ds task slice add --after <slice> --reason <gate>` creates A01-1 style follow-up slices after improve or rework decisions.
  • Help now emphasizes `ds apply`, `ds task checkpoint`, and `ds task refresh` for the everyday task lifecycle.
  • Docs and examples now use `ds workspace ...` for umbrella-repo coordination instead of top-level workspace aliases.

v1.2.0: First-run trust and workspace coordination

  • `ds recent` merges overlapping recent topics, demotes generic maintenance noise, and includes boundary hints for follow-up context.
  • `ds map` indexes the repository before identifying system boundaries, so the first result uses the same local evidence as later runs.
  • Cold indexing progress is visible on stderr while `--quiet` and `--json` remain result-safe for scripts and adapters.
  • Experimental `ds workspace ...` commands coordinate umbrella-repo changes while keeping normal single-repo work on `ds task`, `ds apply`, and checkpoints.

v1.1.0: Bounded agent workflow

  • `ds task` is the primary workflow for packed, repo-grounded task slices with plan/result artifacts, checkpoints, and decision gates.
  • `ds apply` emits the next bounded one-slice agent prompt without mutating task state.
  • `ds init` can generate Codex, Cursor, Claude, and Windsurf adapter files for `ds task` and `ds apply`.
  • `ds tldr` provides LLM-oriented quickstarts grouped by setup, hotfix, epic, incident, handoff, and repo deep-dive workflows.
  • `ds find` builds packed context by default; use `ds find --plain` for the older flat result list.
  • `ds map` focuses on architecture/system boundaries, while `ds recent` covers recently active local git topics.
  • `ds update` reports the active binary, likely install source, latest release status, and recommended update command.

v1.0.1: Focused command set

  • Tightened the visible command surface around task, map, find, recent, update, and agent-facing workflows.
  • Reduced confusing legacy commands in help output before broader use.
  • Hardened task-artifact preservation so CLI lifecycle updates avoid rewriting authored planning content.

v1.0.0: Local task workspace baseline

  • Introduced local task workspaces with indexed plans, slice prompts, result artifacts, and checkpoints.
  • Established local SQLite indexing for intent artifacts and repository context.
  • Included map/find/recent workflows for repo orientation and evidence inspection.

Current caveats

  • `ds apply` is prompt-only; it does not launch an external coding agent.
  • Generated adapter files are thin wrappers over the local CLI, not a hosted service.
  • Cold indexing can still take seconds in large repositories; the CLI shows progress while it builds the local index.
  • `ds workspace ...` is experimental and explicit. Use normal repo-local `ds task`, `ds apply`, and checkpoints for single-repo work.
  • `ds adopt` is planned, not included in v1.3.0.

Release links

Use GitHub Releases for binary downloads and version notes. Use the CLI repository for source, issues, and public docs.