openspec-proposal

Formalize requested changes into OpenSpec proposal, tasks, design, and spec delta documents.

151|20|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/Arman-Kudaibergenov/1c-ai-development-kit --skill openspec-proposal-arman-kudaibergenov
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-proposal
Source: https://github.com/Arman-Kudaibergenov/1c-ai-development-kit/tree/main/.claude/skills/openspec-proposal
Command: npx skills add https://github.com/Arman-Kudaibergenov/1c-ai-development-kit --skill openspec-proposal-arman-kudaibergenov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It turns requested product or architecture changes into a formal, traceable OpenSpec proposal so teams can coordinate safely and verify outcomes instead of debating vague ideas.

Core Features & Use Cases

  • Change proposal scaffolding: creates a dedicated change folder with proposal.md, tasks.md, and design.md when required.
  • Requirement-to-delta mapping: breaks the change into spec deltas aligned to specific OpenSpec capabilities.
  • Verification-ready tasks: produces an ordered checklist of verifiable tasks and validates with strict OpenSpec rules.

Quick Start

Use openspec-proposal when you need a formal change specification for an architectural or cross-cutting update by asking: "Create an OpenSpec proposal for the change: <describe the change> with tasks and spec deltas."

Frequently Asked Questions about openspec-proposal

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

FAQPage Schema
How do I create formal specification proposals for architecture changes?▼

To create formal specification proposals for architecture changes, you formalize the requested update into OpenSpec proposal documents. This generates proposal.md, tasks.md, and design.md files to ensure formal traceability and cross-cutting alignment.

What is the best way to track cross-cutting updates with formal traceability?▼

Tracking cross-cutting updates with formal traceability involves scaffolding a dedicated change folder with proposal, task, and design documents. This approach aligns spec deltas to specific capabilities for safe team coordination and outcome verification.

How do I map requirement deltas to existing OpenSpec capabilities?▼

Mapping requirement deltas to existing OpenSpec capabilities is done by reading existing project specifications and generating scenario-based requirements. This breaks the requested change into capability-aligned spec deltas for strict validation.

Does OpenSpec validate strict rules for scenario-based requirements?▼

Yes, OpenSpec validates strict rules for scenario-based requirements by applying manual checks or strict validation commands. This ensures the generated proposal, tasks, and design notes satisfy guardrails and verify outcomes correctly.

When do I need an OpenSpec proposal for task planning?▼

You need an OpenSpec proposal for task planning when coordinating architectural updates that require verifiable outcomes. It transforms vague change ideas into a formal, ordered checklist of verification-ready tasks to prevent team debate.

Can I use openspec-proposal without existing project specifications?▼

No, using openspec-proposal requires existing project specifications because it reads openspec/project.md and existing change specs. It selects a unique change-id based on this context to generate valid proposal deltas.