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.