spectra-propose

Generate complete Spectra change proposals with validated artifacts from requirements.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you convert a vague requirement into a complete Spectra change proposal with the required artifacts, reducing back-and-forth and missed implementation details.

Core Features & Use Cases

  • Requirement-to-proposal in one workflow: Takes a requirement description (or derives it from context/plan) and produces a structured proposal artifact.
  • Change classification: Automatically organizes the proposal using Feature, Bug Fix, or Refactor/Enhancement templates based on your requirement.
  • Spec and impact readiness: Scans for overlapping specs, generates an Impact section with correctly anchored project-relative paths, and then creates the remaining artifacts in dependency order without writing implementation code.
  • Best-fit inputs: Supports direct CLI arguments and optionally a referenced plan file to extract why, stages, and file impacts.

Quick Start

Run spectra-propose and paste your requirement after it, for example: spectra-propose add dark mode.

Frequently Asked Questions about spectra-propose

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

FAQPage Schema
How do I generate a change proposal from a requirement using Spectra CLI?

Generating a validated Spectra change proposal involves running an end-to-end workflow that parses your requirement, classifies the change type, scans for spec relevance, and builds artifacts in dependency order. It validates the proposal and parks it without applying implementation code.

What is a validated change proposal in software engineering?

A validated change proposal is a structured artifact set derived from requirements, containing change naming, type classification, and spec impact analysis. It ensures implementation readiness by passing validation checks before any code is applied.

Does spectra-propose write implementation code during the artifact generation workflow?

No, the workflow stops after spectra validate and spectra park without executing spectra-apply. It creates all required proposal artifacts in dependency order and runs validation loops, intentionally leaving implementation code unwritten.

How do I organize spec planning and impact analysis for a new feature?

You can organize spec planning by using a workflow that scans overlapping specs and generates an Impact section with correctly anchored project-relative paths. It automatically structures the proposal using Feature, Bug Fix, or Refactor/Enhancement templates.

Can I use a referenced plan file to extract requirements for change classification?

Yes, the workflow supports referencing a plan file to extract the why, stages, and file impacts for change classification. It processes this context alongside direct CLI arguments to produce the structured proposal artifacts.