Create Spec

This generates a specification document for features or refactors by mining existing research in your codebase and organizing it around a philosophy: a system's entrypoints are its theory of purpose. It pushes you to design APIs, routes, and handlers that reveal domain intent rather than implementation detail, then runs each through a ten-point rubric asking whether the door is honestly named, whether it makes illegal states unrepresentable, and whether a stranger could reconstruct the system's purpose from the signatures alone. The output lands in specs/ as a dated markdown file. Use it when you're about to build something non-trivial and want the design work documented before the first commit, especially if you've already done research passes and need to turn findings into a coherent plan.