fe-be-e2e-contract-agent

Generates FE/BE/E2E implementation contract documents from ringi specs and TDD sheets.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/neuthos/ldx-monorepo --skill fe-be-e2e-contract-agent-neuthos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fe-be-e2e-contract-agent
Source: https://github.com/neuthos/ldx-monorepo/tree/main/.agents/skills/fe-be-e2e-contract-agent
Command: npx skills add https://github.com/neuthos/ldx-monorepo --skill fe-be-e2e-contract-agent-neuthos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Cross-repository features spanning frontend, backend, and E2E test suites often lack a single agreed contract, causing selector mismatches, invented API fields, and brittle tests. This Skill converts a ringi's spec, test plan, and approved TDD sheet into one implementation-ready contract document that defines exactly what FE exposes, what BE provides, and what E2E consumes. ## Core Features & Use Cases - Gated contract generation: Reads the ringi's TDD Google Sheet and only proceeds when Metadata.Status is Done, then writes docs/ringi/contracts/{ringi-id}-contract.md. - Evidence-based selector contracts: Classifies every element as Existing, Proposed, PENDING, or Not applicable using read-only FE/BE/E2E repository inspection, with stable data-testid proposals for Page Object Models. - Journey and API traceability: Maps every E2E test case to journeys, pages, POM methods, and BE request/response contracts, plus owner work packets and PENDING decision tracking. - Use Case: After a ringi's test cases are approved in the TDD sheet, run this Skill to produce the contract that FE, BE, and E2E engineers implement against without inventing selectors or endpoints. ## Quick Start Use the fe-be-e2e-contract-agent skill to create the FE/BE/E2E contract for ringi R-1234 from its spec, test plan, and approved TDD sheet.

Frequently Asked Questions about fe-be-e2e-contract-agent

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

FAQPage Schema
How do I create an FE/BE/E2E contract from a test plan?▼

Provide the ringi ID so the Skill can read the spec, test-spec, and TDD sheet, then it generates docs/ringi/contracts/{ringi-id}-contract.md. The sheet's Metadata.Status must be Done before the contract is produced.

What happens if the TDD sheet status is not Done?▼

The Skill stops and reports exactly which statuses block the gate. It will not generate a contract from unapproved Testcases rows or unresolved Question/Draft items.

Does this skill write application code or E2E tests?▼

No. It produces a planning contract document only. FE, BE, and E2E repositories are kept strictly read-only, and no code, tests, dependencies, or Git state are modified.

How are data-testid selectors chosen for E2E page objects?▼

Existing selectors are used only with repository evidence; otherwise stable feature-prefixed kebab-case data-testid values are proposed and assigned to FE. CSS classes, generated IDs, and nth() position selectors are never used as primary contracts.

What happens when a requirement cannot be resolved from the documents?▼

The item is marked PENDING with the decision needed, owner, and blocking impact rather than inventing a selector or endpoint. The contract can be saved as PENDING decisions with one focused question asked.