spectra-ingest

Update an existing Spectra change from a plan file or conversation context.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/kaochenlong/handshake --skill spectra-ingest-kaochenlong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spectra-ingest
Source: https://github.com/kaochenlong/handshake/tree/main/.claude/skills/spectra-ingest
Command: npx skills add https://github.com/kaochenlong/handshake --skill spectra-ingest-kaochenlong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Update an existing Spectra change by ingesting updates from a plan file or conversation context, reducing manual rework and maintaining artifact integrity.

Core Features & Use Cases

  • Update an existing change using a plan file reference or conversation context, depending on availability.
  • Validate and preserve existing progress while merging new tasks and context into artifacts.
  • Ensure prerequisites: the spectra CLI must be installed; handle missing changes gracefully.

Quick Start

Provide a plan file path or rely on conversation context to update the change.

Frequently Asked Questions about spectra-ingest

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update an existing Spectra change from a plan file?

To update a Spectra change, provide a plan file path from ~/.claude/plans/ to ingest updates into existing artifacts. The process validates active changes and merges new tasks while preserving progress.

Can I update Spectra artifacts using conversation context instead of a plan file?

Yes, you can update Spectra artifacts using conversation context when no plan file is available. The system directly applies context-based updates to merge new tasks into existing changes.

Do I need the spectra CLI to ingest plan file updates?

Yes, the spectra CLI is a required prerequisite to ingest plan file or conversation context updates. The CLI validates active changes before applying artifact updates to ensure data integrity.

How does Spectra change management handle existing progress when ingesting updates?

Spectra change management preserves existing progress when ingesting updates by merging new tasks and context into artifacts. It validates active changes before applying updates to prevent data loss.

What happens if the spectra CLI cannot find an active change during artifact updates?

When the spectra CLI cannot find an active change during artifact updates, it handles the missing change gracefully. This prevents errors and ensures the ingestion process stops safely without corrupting artifacts.