spectra-ingest

Merge new requirements into existing Spectra changes and validate via CLI.

1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/howie/MiniShell --skill spectra-ingest-howie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spectra-ingest
Source: https://github.com/howie/MiniShell/tree/main/.claude/skills/spectra-ingest
Command: npx skills add https://github.com/howie/MiniShell --skill spectra-ingest-howie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers need a reliable way to update an existing Spectra change when new requirements appear, without losing completed work or breaking artifact consistency.

Core Features & Use Cases

  • Parse Spectra plan files or extract requirements from conversational context.
  • Automatically select and unpark the appropriate active or parked change.
  • Merge new information into proposals, tasks, and impact artifacts while preserving completed [x] items and parallel [P] markers.
  • Run Spectra CLI validation and analysis to ensure the updated change meets all requirements.

Quick Start

Ask the assistant to run /spectra-ingest with the relevant plan name or rely on the conversation context to update the existing Spectra 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 requirements from a plan file?

To update a Spectra change, parse a plan file or extract new requirements from conversational context. The skill automatically selects the appropriate active or parked change, merges new information into proposals and tasks, and runs Spectra CLI validation to ensure consistency.

Can I merge new requirements into Spectra artifacts without losing completed tasks?

Yes, merging new information into Spectra artifacts preserves completed tasks marked with `[x]` and parallel markers marked with `[P]`. The merge process respects locale rules to maintain artifact consistency across different regions.

When do I need to unpark a parked Spectra change for artifact updates?

You need to unpark a parked Spectra change when new requirements appear and must be incorporated into existing artifacts. The skill automatically unparks the appropriate change to merge new proposals, tasks, and impact assessments before validating the update.

Does Spectra CLI validation check artifact consistency after merging changes?

Yes, Spectra CLI validation and analysis run after merging to ensure the updated change meets all requirements. This validation confirms that artifact merging respects locale rules and that the overall change remains structurally consistent.

What's the best way to incorporate conversational context into a Spectra change?

The best way to incorporate conversational context is to let the skill extract requirements directly from the ongoing chat. It then merges this information into proposals, tasks, and impact artifacts just as it would with a structured plan file.

Why does updating a Spectra change require respecting locale rules during artifact merging?

Respecting locale rules during artifact merging ensures that text formatting, sorting, and regional variations remain correct across different environments. This prevents data corruption and maintains consistency when new requirements are added to existing changes.