Which architecture pattern does this skill follow?

This skill promotes Clean Architecture principles, helping you organize code into Presentation, Application, Domain, and Infrastructure layers to ensure high maintainability and testability.

What is a BE TechSpec document?

A BE TechSpec is a technical implementation blueprint for backend projects that translates product requirements (PRDs) into actionable technical designs, including data models, API contracts, and architecture patterns.

How does it handle functional requirements?

It uses the Given/When/Then (Gherkin) pattern to define functional requirements as test cases, making it easier to verify implementation through integration and unit tests.

Does this skill help with database design?

Yes, it provides a structured approach for defining tables, columns, constraints, indexes, and migration strategies as part of the backend design process.

Backend Technical Specification Architect

Name: Backend Technical Specification Architect
Author: seonghyeonkimm

byseonghyeonkimm

0•

API Development

Generates comprehensive backend technical specifications including API designs, database schemas, and structured test cases.

The Backend TechSpec skill provides a standardized framework for creating detailed technical documentation that bridges the gap between product requirements and implementation. It guides users through a structured workflow to define solutions, acceptance criteria, non-functional requirements, and architectural designs following Clean Architecture principles. By utilizing patterns like Given/When/Then for functional requirements and providing clear templates for data modeling, this skill ensures consistency, improves code quality, and establishes a robust foundation for backend development and testing.

Key Features

01Clean Architecture layout mapping across Presentation, Application, Domain, and Infrastructure layers.

02Non-functional requirement checklists for performance, security, and scalability.

03Comprehensive database schema and data modeling design guidance.

04Structured functional requirement mapping using Given/When/Then test case patterns.

050 GitHub stars

06Standardized BE TechSpec template generation based on PRDs and API specs.

Use Cases

01Designing new backend microservices or features from high-level product requirements.

02Standardizing documentation for API endpoints and database migration strategies within a team.

03Creating detailed technical design documents to facilitate architecture reviews and test-driven development.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add seonghyeonkimm/agents be-techspec

For use in Claude.ai and ChatGPT