iikit-04-testify

Generate hash-locked Gherkin feature files from requirements for test-driven development.

1|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/hafidzlvm/opencode --skill iikit-04-testify-hafidzlvm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: iikit-04-testify
Source: https://github.com/hafidzlvm/opencode/tree/main/.tessl/tiles/tessl-labs/intent-integrity-kit/skills/iikit-04-testify
Command: npx skills add https://github.com/hafidzlvm/opencode --skill iikit-04-testify-hafidzlvm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Teams practicing TDD often write acceptance criteria in specs but never convert them into executable tests before coding, letting requirements drift during implementation. This Skill transforms spec.md acceptance scenarios into Gherkin .feature files with traceability tags and locks them with a SHA256 integrity hash so tests cannot be silently modified. ## Core Features & Use Cases - Gherkin Generation from Specs: Converts Given/When/Then acceptance scenarios, API contracts from plan.md, and validation rules from data-model.md into organized .feature files with @TS/@FR/@SC/@US traceability tags. - Assertion Integrity Locking: Computes a SHA256 hash of generated scenarios, stores it in context.json and a git note, and lets the implement phase verify tests were not altered. - TDD Assessment & Gating: Scans the project constitution for TDD indicators (mandatory, optional, or forbidden) and halts with an error if test-after development is mandated. - Use Case: After running /iikit-02-plan for a login feature, invoke this Skill to produce login.feature with acceptance, contract, and validation scenarios before any implementation code is written. ## Quick Start Run the testify phase to generate Gherkin feature files from my current spec.md and plan.md, then lock the scenarios with an integrity hash.

Frequently Asked Questions about iikit-04-testify

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

FAQPage Schema
How do I generate Gherkin feature files from a requirements spec?▼

Run the testify phase after creating spec.md and plan.md. It scans spec.md for Given/When/Then acceptance scenarios and writes one .feature file per user story into FEATURE_DIR/tests/features/ with traceability tags.

What tags should Gherkin scenarios have for requirements traceability?▼

Each scenario carries @TS-XXX for a unique test spec ID, @FR-XXX for the functional requirement, @SC-XXX for success criteria, @US-XXX for the user story, a priority tag like @P1, and a type tag such as @acceptance, @contract, or @validation.

Does this work on Windows with PowerShell?▼

Yes. Every bash script has a PowerShell equivalent at the same path with a .ps1 extension, accepting the same flags in PascalCase, for example check-prerequisites.ps1 -Phase 04 -Json.

What happens if my spec has no acceptance scenarios?▼

The Skill halts with an error instructing you to run /iikit-clarify. It requires at least one Given/When/Then pattern in spec.md before it can produce any .feature files.

How are generated test scenarios protected from modification?▼

A SHA256 hash of the tests/features directory is stored in both context.json and a git note via the testify-tdd.sh store-all command. The implement phase verifies this hash before proceeding, and each file carries a DO NOT MODIFY header.

What happens when I re-run testify on existing feature files?▼

Re-runs are idempotent: unchanged scenarios keep their TS-XXX tags, new requirements get new scenarios, removed scenarios are commented out as deprecated, and a diff summary of all changes is shown.