spexl-refine

Update spexl proposal, deltas, design, or task artifacts per user instructions.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/a3lem/spexl --skill spexl-refine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spexl-refine
Source: https://github.com/a3lem/spexl/tree/main/.claude/skills/spexl-refine
Command: npx skills add https://github.com/a3lem/spexl --skill spexl-refine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides how to refine an existing spec artifact (proposal, design, deltas) by updating relevant files while maintaining the integrity of the specs and avoiding speculation.

Core Features & Use Cases

  • Routing: determine which artifact to update based on the instruction (proposal, deltas/specs, design, tasks).
  • Change management: coordinate updates across proposal, deltas, design, and tasks with cascading checks for design validity.
  • Interactive guidance: provide phase-specific guidance and templates to ensure consistent documentation.

Quick Start

Instruct the agent to refine an existing artifact within the current spexl change directory.

Frequently Asked Questions about spexl-refine

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

FAQPage Schema
How do I refine a specification proposal without breaking existing design tasks?

To refine a specification proposal safely, route updates through the spexl workflow to apply scope changes while enforcing spec ownership rules and warning about cascading effects on design validity. This coordinates changes across deltas and tasks to maintain artifact integrity.

What is the best way to update design deltas when requirements change?

Updating design deltas when requirements change involves routing the instruction to the correct spexl artifact and applying change management checks. The system coordinates updates across proposals and tasks while validating cascading design impacts to prevent inconsistencies.

Can I adjust architecture scope across multiple spec artifacts at once?

Yes, you can adjust architecture scope across multiple spec artifacts by instructing the agent within your current spexl change directory. It routes the updates across proposals, deltas, and designs while enforcing workflows and warning about cascading effects.

How does spec change management handle cascading design validity checks?

Spec change management handles cascading design validity by coordinating updates across proposals, deltas, design, and tasks. When you refine an artifact, it checks for design validity impacts and warns you about cascading effects to avoid speculation and maintain integrity.

Do I need an existing spexl change directory to modify task specifications?

Yes, you need an existing spexl change directory to modify task specifications. The refinement process applies within this directory to route instructions, update artifact files, and enforce spec ownership rules while providing phase-specific guidance and templates.