gherkin-ai 2.0.0 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -16
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
## 🌟 Strategic Capabilities (`v2.0.0
|
|
11
|
+
## 🌟 Strategic Capabilities (`v2.0.0`)
|
|
12
12
|
|
|
13
13
|
While basic AI spec tools only generate text prompts, `gherkin-ai` acts as an **executable contract and verification harness** between Product Intent, AI Agents (Cursor, Claude Code, Windsurf, Antigravity), Code Implementation, and CI/CD Quality Gates:
|
|
14
14
|
|
|
@@ -18,17 +18,19 @@ While basic AI spec tools only generate text prompts, `gherkin-ai` acts as an **
|
|
|
18
18
|
- ☕ **Enterprise Java & GraphQL Presets**: Scaffolds Cucumber-JVM, Spring Boot, GraphQL queries/mutations, and Testcontainers (PostgreSQL) fixtures.
|
|
19
19
|
- ⚛️ **Modern React & Playwright Presets**: Scaffolds Playwright E2E and React Testing Library step definitions with MSW GraphQL mocks and accessibility-first selectors (`getByRole`).
|
|
20
20
|
- 🚀 **Autopilot Multi-Agent Delivery (`ghk autopilot`)**: Decomposes product requirements into sub-agent workflows (Planner, Spec, Developer, Tester, Reviewer) and generates ready-to-merge Pull Requests.
|
|
21
|
+
- 🎯 **Caveman Mode (`ghk create --caveman`)**: Skip the wizard and generate concise `.feature` specifications instantly from a single plain-text prompt to optimize AI token consumption.
|
|
22
|
+
- 🕵️ **Interactive Stack & Pattern Detection (`ghk detect`)**: Auto-detects existing brownfield architectures and intelligently injects industry-standard design patterns (e.g., Hooks, CQRS, MVC) into Agent prompts.
|
|
21
23
|
- 📊 **Enterprise Quality Gate Index (`ghk quality`)**: Measures spec coverage, unit tests, E2E, type safety, and security score before merging.
|
|
22
24
|
|
|
23
25
|
---
|
|
24
26
|
|
|
25
|
-
## 📥 Installation & Execution (`v2.0.0
|
|
27
|
+
## 📥 Installation & Execution (`v2.0.0`)
|
|
26
28
|
|
|
27
29
|
You can use `gherkin-ai` via global `npm` installation, on-demand zero-install `npx`, or as a project local dev dependency:
|
|
28
30
|
|
|
29
31
|
### Option 1: Global Installation (`npm`)
|
|
30
32
|
```bash
|
|
31
|
-
npm install -g gherkin-ai
|
|
33
|
+
npm install -g gherkin-ai
|
|
32
34
|
```
|
|
33
35
|
Once installed globally, you can use `ghk` or `gherkin-ai` CLI commands directly:
|
|
34
36
|
```bash
|
|
@@ -42,22 +44,22 @@ ghk quality
|
|
|
42
44
|
Run any `gherkin-ai` command instantly without global installation:
|
|
43
45
|
```bash
|
|
44
46
|
# Auto-install MCP server for Cursor & Claude Desktop
|
|
45
|
-
npx -y gherkin-ai
|
|
47
|
+
npx -y gherkin-ai mcp install
|
|
46
48
|
|
|
47
49
|
# Run closed-loop verification test harness
|
|
48
|
-
npx -y gherkin-ai
|
|
50
|
+
npx -y gherkin-ai verify --auto-fix
|
|
49
51
|
|
|
50
52
|
# Build project context & guardrails (.ghe/)
|
|
51
|
-
npx -y gherkin-ai
|
|
53
|
+
npx -y gherkin-ai context build
|
|
52
54
|
|
|
53
55
|
# Calculate feature quality score index
|
|
54
|
-
npx -y gherkin-ai
|
|
56
|
+
npx -y gherkin-ai quality
|
|
55
57
|
```
|
|
56
58
|
|
|
57
59
|
### Option 3: Local Project Dev Dependency
|
|
58
60
|
Add to your project's `devDependencies`:
|
|
59
61
|
```bash
|
|
60
|
-
npm install --save-dev gherkin-ai
|
|
62
|
+
npm install --save-dev gherkin-ai
|
|
61
63
|
```
|
|
62
64
|
Then invoke via `npx` or add scripts to your `package.json`:
|
|
63
65
|
```json
|
|
@@ -75,19 +77,19 @@ Then invoke via `npx` or add scripts to your `package.json`:
|
|
|
75
77
|
|
|
76
78
|
```bash
|
|
77
79
|
# 1. Setup MCP Server for Cursor & Claude Desktop
|
|
78
|
-
ghk mcp install # (or: npx -y gherkin-ai
|
|
80
|
+
ghk mcp install # (or: npx -y gherkin-ai mcp install)
|
|
79
81
|
|
|
80
82
|
# 2. Closed-Loop Test Verification with Auto-Fix Loop
|
|
81
83
|
ghk verify --auto-fix
|
|
82
84
|
|
|
83
|
-
# 3.
|
|
84
|
-
ghk
|
|
85
|
+
# 3. Create a feature using Caveman Mode (skip wizard)
|
|
86
|
+
ghk create --caveman
|
|
85
87
|
|
|
86
|
-
# 4.
|
|
87
|
-
ghk
|
|
88
|
+
# 4. Auto-detect project stack & suggest design patterns
|
|
89
|
+
ghk detect
|
|
88
90
|
|
|
89
|
-
# 5.
|
|
90
|
-
ghk
|
|
91
|
+
# 5. Build Project Context & Policy Engine (.ghe/)
|
|
92
|
+
ghk context build
|
|
91
93
|
```
|
|
92
94
|
|
|
93
95
|
---
|
|
@@ -97,7 +99,7 @@ ghk quality
|
|
|
97
99
|
- [Model Context Protocol (MCP) Integration Guide](docs/MCP_GUIDE.md)
|
|
98
100
|
- [Closed-Loop Verification & Auto-Repair Guide](docs/USAGE_GUIDE.md)
|
|
99
101
|
- [Architecture & Agent Pipeline Design](docs/ARCHITECTURE.md)
|
|
100
|
-
- [Live Web SPA Playground](https://fennereduardo.com/pages/
|
|
102
|
+
- [Live Web SPA Playground](https://fennereduardo.com/pages/gherkin-ai-agent-architect)
|
|
101
103
|
|
|
102
104
|
---
|
|
103
105
|
|
package/package.json
CHANGED