spec-research

Translate Codex change requests into structured research briefs for OpenSpec proposals.

5|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/Catsofsuffering/ccsm --skill spec-research-catsofsuffering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-research
Source: https://github.com/Catsofsuffering/ccsm/tree/main/templates/codex-skills/spec-research
Command: npx skills add https://github.com/Catsofsuffering/ccsm --skill spec-research-catsofsuffering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bounded discovery for change requests by turning vague asks into precise, constraint-driven briefs that feed planning.

Core Features & Use Cases

  • Translate Codex change requests into structured research briefs with goals, boundaries, dependencies, risks, and questions.
  • Update or generate OpenSpec proposal context and support constraint synthesis for planning.
  • Optional collaboration with Claude to gain alternative perspectives while preserving ownership of the research brief.

Quick Start

Prompt Codex for bounded discovery on a requested change and have spec-research produce proposal-ready constraints.

Frequently Asked Questions about spec-research

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

FAQPage Schema
How do I convert a vague change request into a structured research brief?

To convert a vague change request into a structured research brief, use constraint-driven discovery to translate user asks into precise goals, boundaries, dependencies, and risks. This process bounds the request and outputs proposal-ready constraints for planning.

What is the best way to update OpenSpec proposal context without altering product code?

Updating OpenSpec proposal context without altering product code involves applying a focused research brief to capture constraints and synthesis outputs. This enforces that research outputs strictly update the proposal context while documenting risks and questions.

How does constraint synthesis work for Codex change requests?

Constraint synthesis for Codex change requests works by bounding the request with a focused discovery brief. It translates the initial request into explicit constraints, synthesis outputs, and a clear path to planning.

Can I collaborate with Claude to gain alternative perspectives on a research proposal?

You can collaborate with Claude to gain alternative perspectives on a research proposal while preserving your ownership of the research brief. This optional collaboration helps refine constraints and questions without losing authorship control.

When do I need bounded discovery for a product change request?

You need bounded discovery for a product change request when facing vague asks that require precise, constraint-driven briefs to feed planning. It captures risks, dependencies, and questions to ensure the proposal context is fully prepared.

Does spec-research work with OpenSpec proposals to generate planning constraints?

Spec-research works with OpenSpec proposals to generate planning constraints by translating user requests into bounded research briefs. It updates the proposal context with goals, boundaries, and synthesis outputs without modifying product code.