spec-research

Create OpenSpec proposal.md documents with required sections and output path.

1|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/komluk/scaffolding.template --skill spec-research-komluk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-research
Source: https://github.com/komluk/scaffolding.template/tree/main/stacks/_common/.claude/skills/spec-research
Command: npx skills add https://github.com/komluk/scaffolding.template --skill spec-research-komluk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured guide for creating OpenSpec proposal.md documents, ensuring all necessary components are included to define the 'why' behind a proposed change.

Core Features & Use Cases

  • Standardized Proposal Structure: Enforces required sections like Why, What Changes, Capabilities, Impact, Agent Assignment, and Rollback Plan.
  • Contract Definition: Clearly outlines new and modified capabilities, forming the basis for the design phase.
  • Use Case: When proposing a new feature for a software project, use this Skill to generate a proposal.md that clearly articulates the problem, the proposed solution's scope, its impact, and the agents responsible for its implementation.

Quick Start

Use the spec-research skill to write a proposal.md artifact for a new user authentication capability.

Frequently Asked Questions about spec-research

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

FAQPage Schema
How do I write an OpenSpec proposal.md for a new feature?

To write an OpenSpec proposal.md, define the motivation, scope, capabilities, impact, agent assignments, and rollback plans. This structure ensures all necessary components are included to clearly articulate the 'why' behind a proposed software development change.

What should be included in a software development proposal specification?

A software development proposal specification should include sections for Why, What Changes, Capabilities, Impact, Agent Assignment, and Rollback Plan. Clearly outlining new and modified capabilities forms the basis for the subsequent design phase.

When do I need to create a proposal.md document for a project?

You need to create a proposal.md document when proposing a new feature or capability for a software project. It clearly articulates the problem, the proposed solution's scope, its impact, and the agents responsible for its implementation.

Does this OpenSpec proposal guide enforce a specific markdown structure?

Yes, this OpenSpec proposal guide enforces adherence to a defined markdown structure and a specific output path. This ensures clarity and consistency across project proposals by requiring standardized sections like Capabilities and Rollback Plans.

Can I define rollback plans and agent assignments in my project requirements documentation?

Yes, you can define rollback plans and agent assignments within your project requirements documentation. The proposal structure explicitly requires these sections to ensure implementation responsibilities and recovery procedures are established upfront.