spexl-apply

Implement proposed spec deltas into codebases while preserving reference specs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides the end-to-end apply phase to implement a proposed spec delta while preserving the reference as truth, ensuring specs stay the source of truth and changes are executed in a controlled lifecycle.

Core Features & Use Cases

  • Load context from the change directory (proposal.md, deltas/*/spec.md, design.md, tasks.md, notes) to drive implementation.
  • Determine code placement and implement changes outside deltas/ per the design, tests, and project structure.
  • Verify changes against requirements and scenarios with tests and spec-critic guidance; archive upon successful validation.
  • Capture learnings and update notes to inform future iterations and prevent regressions.
  • Support both interactive and autonomous execution modes with appropriate guardrails and prompts.

Quick Start

Provide a change proposal and let spexl apply the delta, verify against requirements and tests, and capture learnings.

Frequently Asked Questions about spexl-apply

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

FAQPage Schema
How do I implement spec deltas in a monorepo while keeping specs as the source of truth?

To implement spec deltas while keeping specs as the source of truth, launch the apply phase to load context from proposal.md, design.md, and tasks.md, place code outside deltas/, run validations, and archive upon success.

What is the best way to verify spec changes end-to-end during implementation?

Verifying spec changes end-to-end involves running validations and tests against requirements and scenarios using spec-critic guidance, ensuring each requirement is covered before archiving the successful implementation.

Can I apply code changes autonomously from a proposal.md file?

Yes, you can apply code changes autonomously from a proposal.md file by using autonomous execution mode, which implements the proposed spec delta with appropriate guardrails while preserving the reference spec as truth.

How do I structure code placement when applying a spec delta?

When applying a spec delta, structure code placement outside the deltas/ directory per the design and project structure, ensuring the delta files remain separate from the actual implementation.

Why does my spec implementation fail validation in a monorepo?

Spec implementation fails validation in a monorepo when tests do not cover each requirement or the code violates design.md constraints, requiring you to capture learnings in notes to prevent regressions.

Does spexl-apply work with per-capability deltas in a monorepo?

Yes, spexl-apply works with per-capability deltas in a monorepo by loading context from deltas/*/spec.md, implementing changes, running validations, and archiving upon successful verification against requirements.