albertobasaloacademy/generating-specs

Generating Specs Skill

Write the specification to implement a feature, bug correction, or enhancement.

Include the problem definition, solution overview, and acceptance criteria.

Keep the problem definition clear, concise, and focused.

Do not enter implementation details.

Make the acceptance criteria specific, and testable.

Do not write any code or tests, just the specification.

Context

• Product Requirements Document

The feature, bug correction, or enhancement must be provided in the input.

If not, ask for it before proceeding.

Types of specifications to generate include:

• New or current feature : feat
• Bug correction : bug
• Enhancement or refactor : chore

Specification output template

Read and follow the specific spec template to generate the document.

Steps to follow:

Step 1: Capture inputs:

• [ ] Confirm feat/bug/chore to specify; if missing, ask.
• [ ] Draft the issue title from the request; if unclear, ask.

Step 2: Review PRD (if applicable):

• [ ] Check if the feature, bug correction, or enhancement is already in PRD.
• [ ] If it is, use that information to help you write the specification.
• [ ] If not, update the PRD documentation with it.

Step 3: Define the Problem:

• [ ] Clearly outline the problem that we aim to solve.

Step 4: List User Stories:

• [ ] Up to 3 US that describe the problem from the user's perspective.

Step 5: Outline the Solution:

• [ ] Describe the simplest approach without technical details for:
  • User/App interface
  • Model and logic
  • Persistence

Step 6: Set Acceptance Criteria:

• [ ] Up to 9 criteria in EARS format that define when the spec is complete.
• [ ] Follow the EARS format guide.

Step 7: Generate an spec-slug-id:

• [ ] Create a short-name identifier for the spec based on the type and title.
• [ ] Example: feat-booking-management.

Step 8: Write the Specification:

• [ ] Use short sentences and bullet points where possible.
• [ ] Keep the specification concise but complete.
• [ ] Follow the spec template
• [ ] Write it in markdown format at {Specs_Folder}/<spec-slug-id>.spec.md.

Output Checklist

• [ ] A specification markdown file named {Specs_Folder}/<spec-slug-id>.spec.md.
• [ ] The PRD requirements status must be updated if needed.