feat(cli): add asset system for commands, templates, hooks, and presets

[gpolanco]

What

Adds a full asset system to the CLI that allows users to install not just rules, but also commands, templates, hooks, and presets from the registry. Includes a settings-merge utility that correctly writes Claude Code hook settings in the expected format.

Why

The CLI previously only supported rules. This extends the asset model to cover all developer workflow primitives as defined in the v0.2/v0.2.1 specs and the internal content/ directory structure.

Also fixes a bug in the hook settings format: Claude Code expects each matcher group to have a hooks array with {type, command} objects, not a command directly.

Changes

New files:

• packages/cli/src/core/assets.ts — asset resolution, installation, and registry logic
• packages/cli/src/core/settings-merge.ts — merges hook entries into Claude Code settings.json with correct format
• packages/cli/tests/core/assets.test.ts — full test coverage for asset system
• packages/cli/tests/core/settings-merge.test.ts — tests for settings merge logic
• content/commands/build.md, learn.md, plan.md, spec.md — built-in commands
• content/hooks/auto-format.json — built-in auto-format hook (with correct format)
• content/presets/spec-driven.yml — example preset
• content/templates/feature-spec.md — feature spec template
• content/rules/workflow/spec-driven.md — spec-driven workflow rule
• docs/concepts/assets.mdx — documentation for the asset system
• .changeset/add-asset-system.md

Modified files:

• packages/cli/src/commands/add.ts — supports all asset types
• packages/cli/src/commands/list.ts — lists all asset types
• packages/cli/src/commands/doctor.ts — validates asset installations
• packages/cli/src/commands/init.ts — initializes with assets
• packages/cli/src/commands/compile.ts — compiles assets
• packages/cli/src/commands/remove.ts — removes assets
• packages/cli/src/bridges/types.ts — bridge type extensions
• packages/cli/src/utils/github.ts — updated GitHub fetching
• packages/cli/src/core/parser.ts — parser updates
• docs/commands/add.mdx, compile.mdx, doctor.mdx, init.mdx, list.mdx — updated docs
• docs/index.mdx, docs/quickstart.mdx, docs/docs.json — updated navigation and content
• README.md — updated with asset system overview

Test

pnpm install
pnpm build

# Listar assets disponibles
devw add --list

# Instalar un hook
devw add hooks/auto-format

# Verificar que el formato en .claude/settings.json sea correcto:
# hooks → PostToolUse → [{matcher, hooks: [{type, command}]}]

# Correr los tests
pnpm test

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
landing	Ready	Preview, Comment	Mar 7, 2026 10:52am