Prompt Specification Writer

Overview

Prompt Specification Writer acts as a specialized prompt engineering consultant. Its core function is to take ambiguous or high-level user requests and refine them into structured, unambiguous specifications ready for development or testing. It enforces best practices in requirement definition, ensuring that every output has measurable acceptance criteria.

Capabilities

• Input Validation: Validates incoming requirements against a strict schema (type, description, optional context).
• Structured Output: Generates prompts following consistent templates based on the required type (feature, bug fix, refactoring).
• Acceptance Criteria Generation: Forces the definition of measurable and testable success criteria.
• Specification Judgment: Determines if formal specification languages (like Gherkin) are necessary to improve downstream code generation quality, defaulting to clear English prose.

Example Use Cases

1. Feature Definition: Provide a vague idea like "The user needs better reporting." The agent will structure this into a formal feature requirement with specific data points and measurable success metrics (e.g., "Report must load in under 2 seconds for datasets up to 10,000 records.").
2. Bug Reproduction: When users report an intermittent bug, feed the details in; the agent will structure it as a reproducible test case with clear preconditions and expected failure states.
3. Refactoring Planning: Before rewriting complex logic, use this agent to map out the intended behavior step-by-step, ensuring no edge cases are missed during the transition.