spec-writing

Write or update Gherkin specifications in pandahrms-spec before implementation.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/pandaworks-software-plt/pandahrms-skills --skill spec-writing-pandaworks-software-plt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/pandaworks-software-plt/pandahrms-skills/tree/main/skills/spec-writing
Command: npx skills add https://github.com/pandaworks-software-plt/pandahrms-skills --skill spec-writing-pandaworks-software-plt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gherkin specifications must be written or updated in the pandahrms-spec repository before any Pandahrms work proceeds. This creates a hard gate that prevents implementation from starting without agreed-upon specs.

Core Features & Use Cases

  • Writes or updates Gherkin specs for Pandahrms projects before implementation.
  • Guides teams to ensure alignment between design, requirements, and tests.
  • Supports non-Pandahrms projects by guiding specs to be stored in the project's own repository if Pandahrms workspace constraints apply.

Quick Start

Write or update the Gherkin specs in pandahrms-spec before starting implementation.

Frequently Asked Questions about spec-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write Gherkin specs before starting code implementation?

To write Gherkin specs before implementation, you create or update feature files in the pandahrms-spec repository, establishing a hard gate that prevents any code changes from proceeding without agreed-upon specifications.

What is a spec-first workflow and how does it enforce a hard gate for development?

A spec-first workflow requires Gherkin specifications to be written or updated in pandahrms-spec before any work proceeds, enforcing a hard gate that blocks code changes until specs are established and agreed upon.

Does the spec-writing workflow work for non-Pandahrms projects?

For non-Pandahrms projects, Gherkin specs are guided to be stored directly in the project's own repository rather than pandahrms-spec, provided the workspace constraints are met.

How do I set up the workspace directory for writing Gherkin specifications?

You must set up the pandahrms-spec repository as a sibling directory within your workspace environment so the spec-writing process can correctly locate and update the Gherkin feature files.

Why does my development workflow require specs before implementation?

Your workflow requires specs before implementation to ensure alignment between design, requirements, and tests, creating a hard gate that prevents untracked code changes from proceeding without agreed-upon Gherkin specifications.

Can I update existing Gherkin specifications instead of writing new ones?

You can update existing Gherkin specifications in the pandahrms-spec repository before proceeding with new implementation, ensuring the feature files reflect current requirements and maintaining the hard-gate rule.