Groove

Workflow primitives for autonomous software development.

Groove is a collection of small, independently installable tools that help you run LLM coding agents reliably — with better issues going in, and a clear audit trail coming out.

Packages

issue-standards

A Claude Code skill that teaches agents (and humans) how to write issues that autonomous developers can actually finish. Covers required sections, acceptance criteria discipline, the human-handoff pattern, and complexity estimation.

npx issue-standards setup

linear-agent-hooks

Claude Code and Codex hooks that automatically post a provenance comment back to every Linear issue your agent creates — capturing which session created it, what you asked for, and when.

npx linear-agent-hooks setup

llm-cost-attribution

Per-issue token, turn, and quota analytics for Claude Code and Codex CLI sessions. Reads the CLIs' own session JSONLs — no custom telemetry pipeline required. Works out of the box with any orchestrator that follows OpenAI Symphony's per-issue workspace convention.

npx llm-cost-attribution EPAC-1940

Optionally bake transcripts into a compact usage.jsonl (40× smaller) so you can delete ~/.claude/projects and ~/.codex/sessions without losing cost history. The bake file follows the Symphony Coding-Agent Cost Telemetry Extension spec so other tools can read it too — but that interop is purely optional.

---

These tools are independent. Install one, both, or neither — there's no coupling between them.