openspec-context-docs

What problem does it solve?

This Skill addresses the challenge of maintaining clear and comprehensive documentation for OpenSpec, ensuring that normative requirements in spec.md are complemented by essential narrative context without compromising the single source of truth.

Core Features & Use Cases

• Two-Layer Documentation: Enforces a clear separation between normative requirements (spec.md) and explanatory context (e.g., context.md, rationale.md).
• Contextual Enrichment: Guides the inclusion of purpose, rationale, constraints, failure modes, examples, and operational notes within context documents.
• Organized Structure: Defines specific locations for main specs, optional context splits, and change-level notes under the openspec/ directory.
• Use Case: When updating an OpenSpec for a new API endpoint, use this Skill to ensure that the spec.md file contains only the functional requirements, while a separate context.md file explains the business rationale, potential edge cases, and provides example requests and responses.

Quick Start

Use the openspec-context-docs skill to add context to the spec.md file located in openspec/specs/user-auth/.