phase-1-schema

name	phase-1-schema
context	fork
background	false
classification	capability
classification-reason	Pattern guidance may overlap with model's built-in knowledge as it improves
deprecation-risk	medium
effort	medium
description	Define project terminology, data structures, entities, and relationships. Triggers: schema, data model, entity, terminology
agent	bkit:pipeline-guide
allowed-tools	["Read","Write","Glob","Grep"]
user-invocable	false
imports	["${PLUGIN_ROOT}/templates/pipeline/phase-1-schema.template.md","${PLUGIN_ROOT}/templates/shared/naming-conventions.md"]
next-skill	phase-2-convention
pdca-phase	plan
task-template	[Phase-1] {feature}

Phase 1: Schema/Terminology Definition

Define terminology and data structures used throughout the project

Purpose

Unify the language of the project. Ensure all team members (or AI) communicate using the same terms and clearly understand data structures.

What to Do in This Phase

1. Build Glossary: Map business terms + global standards
2. Identify Entities: Determine what "things" exist
3. Define Relationships: Relationships between entities
4. Design Schema: Define data structures

Glossary

Why is it Needed?

Explaining business terms to Claude Code every time is tedious. Creating a glossary allows:

• Claude to automatically reference for context understanding
• Team communication consistency
• Reduced onboarding time for new team members/AI

Term Categories

Category	Description	Example
Business Terms	Internal proprietary terms	"Caddy" (golf booking assistant)
Global Standards	Industry common or technical standard terms	"OAuth", "REST API"
Mapping	Business ↔ Global correspondence	"Member" = User, "Payment" = Payment

Glossary Template

## Business Terms (Internal Terms)

| Term | English | Definition | Global Standard Mapping |
|------|---------|------------|------------------------|
| Caddy | Caddy | AI assistant that helps book golf rounds | Booking Assistant |
| Round | Round | One 18-hole golf play | Session, Booking |
| Green Fee | Green Fee | Golf course usage fee | Usage Fee |

## Global Standards

| Term | Definition | Reference |
|------|------------|-----------|
| OAuth 2.0 | Authentication protocol | RFC 6749 |
| REST | API architecture style | - |
| UUID | Universal Unique Identifier | RFC 4122 |

## Term Usage Rules

1. Use **English** in code (`Caddy`, `Round`)
2. Use **local language** in UI/docs (Caddy, Round)
 API responses prioritize  ()