skills.rest
wtsi-hgi
wtsi-hgiOFFICIAL
Explore all skills by this author →
WebsiteGitHub

implementor

Guide Next.js and FastAPI development with TDD and API contract validation.

Updated Nov 27, 2025
Search Tags:#typescript#testing#tdd#full-stack#python#implementation#api contracts
One-click install
npx skills add https://github.com/wtsi-hgi/llm-knowledge-base --skill implementor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: implementor
Source: https://github.com/wtsi-hgi/llm-knowledge-base/tree/main/.github/skills/implementor
Command: npx skills add https://github.com/wtsi-hgi/llm-knowledge-base --skill implementor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive, step-by-step guide for implementing features within the Next.js + FastAPI monorepo, ensuring adherence to established development practices.

Core Features & Use Cases

  • TDD Cycle Enforcement: Guides users through writing failing tests first, then minimal implementation, refactoring, and validation for both backend and frontend.
  • Contract Workflow: Details the process for defining and testing API contracts between frontend and backend using Pydantic and Zod.
  • Implementation Workflow: Outlines a structured approach to implementing features one at a time, emphasizing testing and validation.
  • Use Case: When tasked with adding a new user authentication endpoint, this Skill ensures you follow the correct TDD cycle, define the API contract properly, and integrate it seamlessly into the existing codebase.

Quick Start

Follow the TDD cycle for backend implementation by writing a failing test in backend/tests/ and then implementing the minimal code to pass.

Frequently Asked Questions about implementor

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

FAQPage Schema
How do I implement API contracts between FastAPI and Next.js?▼

To implement API contracts, define and test data structures using Pydantic for the backend and Zod for the frontend to ensure strict validation across the full stack.

What is the best way to enforce a TDD cycle in a full-stack Python and TypeScript project?▼

The best way to enforce TDD is to follow a structured workflow of writing failing tests first, then minimal implementation, refactoring, and validation for both backend and frontend.

Do I need to write failing tests before implementing backend features in FastAPI?▼

Yes, you must write a failing test in the backend tests directory before implementing the minimal Python code required to pass it, ensuring proper test-driven development.

How does test-driven development work for frontend TypeScript integration?▼

Test-driven development for frontend TypeScript requires writing failing tests first, implementing minimal code to pass, and validating API contracts using Zod for seamless integration.

Can I use this guide to add a new user authentication endpoint to my monorepo?▼

Yes, you can use this implementation guide to add a new user authentication endpoint by following the correct TDD cycle and defining the API contract properly within your Next.js and FastAPI monorepo.

Related Skills

Explore More Software Engineering Skills→
wtsi-hgiwtsi-hgi

conventions

Document shared conventions for a Next.js and FastAPI monorepo.

Official
Basic
vikisingh23vikisingh23
4

api-testing

Generate and validate Postman/Newman test collections from OpenAPI/Swagger specs.

Community
Intermediate
gsd-buildgsd-build
7.8k

test

Detect test frameworks and generate or execute tests across Node.js, Python, and Go projects.

Official
Intermediate
kasiopeiyakasiopeiya
1

unit-test

Execute backend and frontend unit tests with Vitest and generate detailed reports.

Community
Intermediate