ahnyongjooandClaude Sonnet 5.5
964a841de1
- Code\rebar_pipeline, review_pipeline, pier-program을 정션에서 실제 폴더로 전환 - Code\rhino_mcp 및 CLAUDE_rhino배경.md 추가, .mcp.json은 PYTHONPATH로 새 위치 사용 - pier-program 내부 .git 제거(이력은 backup\pier-program_20261028.bundle에 보관) - worktree 가이드 반영(CLAUDE.local.md, HANDOFF.md) - D:\Rhino-MCP 경로 참조를 새 위치로 치환 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
228 lines
5.1 KiB
Markdown
228 lines
5.1 KiB
Markdown
# {{PROJECT_NAME}}
|
|
|
|
> {{PROJECT_DESCRIPTION}}
|
|
|
|
---
|
|
|
|
## Core Principles
|
|
|
|
### 1. Automation First, Commands are Shortcuts
|
|
```
|
|
AI Agent automatically applies PDCA methodology.
|
|
Commands are shortcuts for power users.
|
|
```
|
|
|
|
### 2. SoR (Single Source of Truth) Priority
|
|
```
|
|
1st: Codebase (actual working code)
|
|
2nd: agents.md / Convention docs
|
|
3rd: docs/ design documents
|
|
```
|
|
|
|
### 3. No Guessing
|
|
```
|
|
Unknown → Check documentation
|
|
Not in docs → Ask user
|
|
Never guess
|
|
```
|
|
|
|
---
|
|
|
|
## Tech Stack
|
|
|
|
| Item | Value |
|
|
|------|-------|
|
|
| Language | {{LANGUAGE}} |
|
|
| Framework | {{FRAMEWORK}} |
|
|
| Package Manager | {{PACKAGE_MANAGER}} |
|
|
| Level | {{LEVEL}} |
|
|
| Tier | {{TIER}} |
|
|
|
|
### Language Tier Context (v1.3.0)
|
|
|
|
{{#if TIER_1}}
|
|
> **Tier 1 (AI-Native Essential)**
|
|
> - Full AI tool support (Copilot, AI Agent, Cursor)
|
|
> - Vibe Coding optimized
|
|
> - PDCA automation fully supported
|
|
{{/if}}
|
|
|
|
{{#if TIER_2}}
|
|
> **Tier 2 (Mainstream Recommended)**
|
|
> - Good AI tool compatibility
|
|
> - Domain-specific strengths
|
|
> - PDCA recommended
|
|
{{/if}}
|
|
|
|
{{#if TIER_3}}
|
|
> **Tier 3 (Domain Specific)**
|
|
> - Platform-specific requirements
|
|
> - Moderate AI support
|
|
> - Consider migration path for new features
|
|
{{/if}}
|
|
|
|
{{#if TIER_4}}
|
|
> **Tier 4 (Legacy/Niche)**
|
|
> - Maintenance mode
|
|
> - Migration plan recommended
|
|
> - New features should use Tier 1-2
|
|
{{/if}}
|
|
|
|
---
|
|
|
|
## Development Workflow
|
|
|
|
### Commands
|
|
```bash
|
|
# Type check
|
|
{{TYPECHECK_COMMAND}}
|
|
|
|
# Test
|
|
{{TEST_COMMAND}}
|
|
|
|
# Lint
|
|
{{LINT_COMMAND}}
|
|
|
|
# Build
|
|
{{BUILD_COMMAND}}
|
|
```
|
|
|
|
---
|
|
|
|
## Coding Conventions
|
|
|
|
### Naming Rules
|
|
|
|
| Target | Convention | Example |
|
|
|--------|-----------|---------|
|
|
| Components | PascalCase | `UserProfile`, `LoginForm` |
|
|
| Functions | camelCase | `getUserById`, `handleSubmit` |
|
|
| Constants | UPPER_SNAKE_CASE | `MAX_RETRY_COUNT`, `API_TIMEOUT` |
|
|
| Types/Interfaces | PascalCase | `UserProfile`, `ApiResponse` |
|
|
| Files (component) | PascalCase.tsx | `UserProfile.tsx` |
|
|
| Files (utility) | camelCase.ts | `formatDate.ts` |
|
|
| Folders | kebab-case | `user-profile/`, `auth-provider/` |
|
|
|
|
### Import Order
|
|
|
|
```typescript
|
|
// 1. External libraries (react, next, third-party)
|
|
import { useState, useEffect } from 'react'
|
|
import { useQuery } from '@tanstack/react-query'
|
|
|
|
// 2. Internal absolute imports (@/...)
|
|
import { Button } from '@/components/ui'
|
|
import { userService } from '@/services/user'
|
|
|
|
// 3. Relative imports (./...)
|
|
import { useLocalState } from './hooks'
|
|
import { formatData } from './utils'
|
|
|
|
// 4. Type imports
|
|
import type { User, ApiResponse } from '@/types'
|
|
|
|
// 5. Styles (last)
|
|
import './styles.css'
|
|
```
|
|
|
|
### Clean Architecture (Level: {{LEVEL}})
|
|
|
|
| Layer | Location | Responsibility | Can Import |
|
|
|-------|----------|----------------|------------|
|
|
| **Presentation** | `components/`, `hooks/`, `app/` | UI, user events | Application, Domain |
|
|
| **Application** | `services/`, `features/*/hooks/` | Business logic | Domain, Infrastructure |
|
|
| **Domain** | `types/`, `domain/` | Entities, core rules | Nothing (independent) |
|
|
| **Infrastructure** | `lib/`, `api/` | External services | Domain only |
|
|
|
|
### Environment Variables
|
|
|
|
| Prefix | Scope | Example | Notes |
|
|
|--------|-------|---------|-------|
|
|
| `NEXT_PUBLIC_` | Client (Browser) | `NEXT_PUBLIC_API_URL` | Exposed to browser |
|
|
| `DB_` | Server only | `DB_HOST`, `DB_PASSWORD` | Never expose |
|
|
| `API_` | Server only | `API_STRIPE_SECRET` | External API keys |
|
|
| `AUTH_` | Server only | `AUTH_SECRET` | Auth secrets |
|
|
|
|
### Additional Conventions
|
|
|
|
{{CONVENTIONS}}
|
|
|
|
---
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
{{FOLDER_STRUCTURE}}
|
|
```
|
|
|
|
---
|
|
|
|
## PDCA Auto Behavior
|
|
|
|
### On New Feature Request
|
|
```
|
|
User: "Create login feature"
|
|
AI Agent: 1. Check docs/02-design/ → Create design if missing
|
|
2. Generate design document using template
|
|
3. Implement based on design
|
|
4. Suggest Gap analysis after completion
|
|
```
|
|
|
|
### On Bug Fix / Refactoring
|
|
```
|
|
AI Agent: 1. Compare code with design documents
|
|
2. Identify cause and fix
|
|
3. Suggest updating documentation
|
|
```
|
|
|
|
---
|
|
|
|
## Key Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/pdca-status` | Check current PDCA status |
|
|
| `/pdca-design {feature}` | Create design document |
|
|
| `/pdca-analyze {feature}` | Run Gap analysis |
|
|
|
|
---
|
|
|
|
## Document Structure Rules
|
|
|
|
### hmcmkit-system/ (Current Implementation Reference)
|
|
```
|
|
- Update together with code changes
|
|
- Always reflects "current codebase state"
|
|
- Use this folder for implementation reference
|
|
```
|
|
|
|
### docs/pdca/ (Active Work)
|
|
```
|
|
- Active PDCA documents in progress
|
|
- Move to docs/archive/ after completion
|
|
```
|
|
|
|
### docs/archive/ (History)
|
|
```
|
|
- Completed plan/design documents
|
|
- Read-only (no modifications)
|
|
```
|
|
|
|
### Archive Trigger
|
|
```
|
|
Gap analysis completed (match rate >= 90%)
|
|
OR user explicit completion
|
|
→ Move to archive
|
|
```
|
|
|
|
---
|
|
|
|
## Reference
|
|
|
|
Use `/pdca-plan`, `/pdca-design`, `/pdca-analyze` commands for PDCA workflow.
|
|
|
|
---
|
|
|
|
**Generated by**: /setup-ai-agent-code
|
|
**Template Version**: 1.3.0 (Check-Act Iteration Loop)
|