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.