harness-scaffold

Generate project-convention-compliant code boilerplates for Entity, Repository, Service, Controller, and tests.

1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/cano721/ai-harness --skill harness-scaffold
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-scaffold
Source: https://github.com/cano721/ai-harness/tree/main/skills/harness-scaffold
Command: npx skills add https://github.com/cano721/ai-harness --skill harness-scaffold

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

에이전트가 새 파일을 빈 상태에서 작성하지 않고, 프로젝트 컨벤션에 맞는 구조화된 보일러플레이트 위에서 작업하도록 돕습니다. OpenAI의 "스캐폴딩이 코드보다 중요하다" 원칙을 적용합니다.

Core Features & Use Cases

  • 컨벤션 로드: .ai-harness/teams/{team}/skills/convention-{team}.md 를 Read 하고, .ai-harness/config.yaml에서 project.base_package, project.entities 확인
  • 생성 대상 결정: 사용자에게 생성할 엔티티/기능명 확인 및 생성할 레이어 세트 선택(기본: 전체 세트)
  • 컨벤션 기반 생성: 컨벤션에서 추출한 패턴 적용 - 패키지 구조, DTO 네이밍, 공통 응답 클래스, 예외 처리 규칙 등을 코드에 반영
  • 레이어별 구성: Entity + Repository, Service(인터페이스 + 구현체 여부), Controller + DTO, 테스트 등 요구되는 모든 레이어를 규칙에 맞춰 생성
  • 아키텍처 검증: 생성된 코드의 의존성 방향 및 아키텍처 규칙 준수 여부를 사전 점검
  • 출력 안내: 생성된 파일 목록과 위치를 안내하고, 비즈니스 로직 구현은 이 구조 위에서 진행하라고 안내

Quick Start

Generate a complete boilerplate set based on the project's conventions.

Frequently Asked Questions about harness-scaffold

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

FAQPage Schema
How do I generate boilerplate code for a Spring Boot application automatically?

To generate boilerplate code for a Spring Boot application, you can use convention-based scaffolding to automate the creation of Entity, Repository, Service, Controller, and test layers. This approach reads project-wide conventions and outputs a ready-to-implement codebase.

What is convention-based scaffolding in Java code generation?

Convention-based scaffolding in Java code generation is the process of extracting architectural patterns like package structures and DTO naming from existing project files. It applies these rules to generate standardized boilerplate code rather than writing files from scratch.

Can I check architecture rules and dependency directions after generating code?

Yes, you can check architecture rules and dependency directions after generating code. The scaffolding process includes a built-in architecture verification step that pre-inspects the generated codebase for compliance with your project's architectural constraints.

How do I scaffold a complete Spring Boot REST API layer set from existing conventions?

To scaffold a complete Spring Boot REST API layer set, the tool reads configurations like base packages and entity names, then generates the required Entity, Repository, Service, Controller, and DTO files. It applies extracted patterns directly to ensure structural consistency.

Does code scaffolding work without predefined project conventions?

Code scaffolding relies heavily on predefined project conventions to function correctly. It requires reading configuration files and team-specific convention documents to apply the correct package structures, exception handling rules, and naming patterns during generation.