Write Product Spec

A product spec is a written plan that shows exactly how a new feature should work from the user's point of view. It makes the desired behavior clear and complete. This skill helps you create a PRODUCT.md file for any significant feature in Warp.

The spec focuses on what the user sees, does, and experiences. It does not include any internal implementation details. The term "user" depends on the feature type, such as a human using the app, a developer using a CLI, or another service calling an API. The goal is to describe the surface shape and invariants from that consumer's perspective.

Writing the product spec is usually the first step. After the spec is agreed upon, you can write a companion tech spec for implementation details. The spec is saved in a folder with the feature name or ticket number. You can also ask for a Figma link for UI features to capture visual states accurately.