Generate OpenSpec main specifications by analyzing the current project's code, documentation, issues, and pull requests.

Unlike openspec-propose (which creates a change with proposal/design/tasks artifacts for future work), this skill writes finished specs directly to openspec/specs/ based on what already exists in the project.

Input: Optionally specify which capabilities or areas to generate specs for. If omitted, analyze the full project and determine capabilities automatically.

Steps

Gather project context

Collect information from all available sources. Prioritize breadth over depth — skim first, then deep-dive into relevant areas.

a. Project documentation:
- Read AGENTS.md (or CONTRIBUTING.md, README.md) for architecture overview, conventions, and design decisions
- Read docs/ directory for feature specs, design docs, BDD features (.feature files)
- Read openspec/config.yaml for project context and rules

openspec-generate-specs