spectra-ingest

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires spectra.

What problem does it solve?

It updates an existing Spectra change safely using either a referenced plan file or the current conversation context, so you don’t have to recreate proposals and tasks from scratch.

Core Features & Use Cases

  • Ingest from plan file or context: Updates artifacts using a plan file path/name when provided, otherwise derives the update from conversation context.
  • Update-only safety guard: Requires an existing active or parked change and stops when none exists.
  • Artifact-consistent merging: Preserves completed tasks and existing markers while merging new proposal context and tasks.
  • Spectra CLI orchestration: Uses Spectra commands to list changes, select the target, fetch artifact instructions, update artifacts, analyze, validate, and produce a completion summary.

Quick Start

Run spectra-ingest with the plan name or file path you want to ingest into an existing 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 with new plan content?

You can update an existing Spectra change by providing a plan file path or using conversation context to merge new artifact proposals and tasks incrementally.

Can I ingest changes into a Spectra project that has no active changes?

No, you cannot ingest changes without an existing active or parked Spectra change. The update-only safety guard requires an existing change and stops when none is found.

Does updating Spectra artifacts preserve my completed tasks?

Yes, updating Spectra artifacts preserves completed tasks and existing markers while merging new proposal context and tasks through an artifact-consistent incremental merging process.

Do I need the spectra CLI to ingest plan files into my changes?

Yes, you need the spectra CLI installed because the ingestion process orchestrates spectra list, instructions, status, analyze, and validate commands to update and verify changes.

What is the best way to select a specific active change for context ingestion?

The best way to select a specific active change for context ingestion is using the targeted change selection workflow, which lists active or parked changes before merging new plan data.

Why does my plan parsing workflow stop before updating artifacts?

Your plan parsing workflow stops before updating artifacts because the update-only safety guard halts the process when no existing active or parked Spectra change is found.