codesyncer 1.0.0

package/src/templates/en/comment_guide.md

@@ -0,0 +1,324 @@
+# Comment Writing Guide
+
+> **CodeSyncer Comment System** - Permanently record all inferences and decisions
+
+---
+
+## 📋 Comment Tag Reference
+
+### 5 Essential Tags
+
+| Tag | Purpose | When to Use | Importance |
+|-----|---------|-------------|------------|
+| `@codesyncer-rule` | Special rules | Non-standard implementations | ⭐⭐⭐ |
+| `@codesyncer-inference` | Inference content | AI inferred content and rationale | ⭐⭐⭐⭐⭐ |
+| `@codesyncer-decision` | Decision made | Post-discussion decisions | ⭐⭐⭐⭐⭐ |
+| `@codesyncer-todo` | TODO | Needs user confirmation | ⭐⭐⭐⭐ |
+| `@codesyncer-context` | Business context | Domain knowledge, background | ⭐⭐⭐ |
+
+### Legacy Compatibility
+
+Existing `@claude-*` tags are fully compatible:
+```typescript
+@claude-rule        = @codesyncer-rule
+@claude-inference   = @codesyncer-inference
+@claude-decision    = @codesyncer-decision
+@claude-todo        = @codesyncer-todo
+@claude-context     = @codesyncer-context
+```
+
+---
+
+## 📝 Comment Levels
+
+### 1. 📄 File Level (JSDoc)
+
+**When**: Top of file, module-wide description
+
+```typescript
+/**
+ * User authentication service
+ *
+ * @codesyncer-context JWT-based authentication system
+ * @codesyncer-rule Store tokens in httpOnly cookies (XSS prevention)
+ * @author CodeSyncer
+ * @date 2024-10-17
+ */
+```
+
+### 2. 🔧 Function/Class/Component Level
+
+**When**: Above each function, class, component definition
+
+```tsx
+/**
+ * Order creation form
+ *
+ * @codesyncer-context 6-step order process
+ * @codesyncer-inference Auto-save at each step (common UX pattern)
+ * @codesyncer-decision [2024-10-15] Zustand for state management (complex form state)
+ */
+export default function OrderForm() {
+  // ...
+}
+```
+
+### 3. 📝 Inline Level
+
+**When**: Above or beside code lines
+
+```typescript
+// @codesyncer-inference: Page size 20 (standard table UX)
+const PAGE_SIZE = 20;
+
+// @codesyncer-todo: Need to confirm mainApi endpoint URL
+const API_URL = '/api/temp';
+
+// @codesyncer-decision: [2024-10-17] Soft Delete (30-day recovery)
+async function deleteUser(id: string) {
+  // @codesyncer-inference: Using deleted_at flag (for recovery feature)
+  return db.update(id, { deleted_at: new Date() });
+}
+
+const maxRetry = 3; // @codesyncer-inference: 3 retries (stability)
+```
+
+---
+
+## ✅ Good Comment Examples
+
+### Example 1: Business Logic
+
+```tsx
+/**
+ * Calculate shipping fee
+ *
+ * @codesyncer-context Shipping fee policy
+ * - Over $300: Free shipping
+ * - Under $300: $30
+ * - Remote areas: +$30
+ *
+ * @codesyncer-decision [2024-10-10] Policy finalized (Marketing team agreement)
+ * @codesyncer-rule Policy changes require Marketing team approval
+ */
+function calculateShippingFee(orderAmount: number, region: string): number {
+  // @codesyncer-inference: $300 threshold (industry standard)
+  const FREE_SHIPPING_THRESHOLD = 30000;
+
+  // @codesyncer-decision: [2024-10-10] Base fee $30
+  const BASIC_FEE = 3000;
+
+  // @codesyncer-todo: Confirm remote area list
+  const EXTRA_FEE_REGIONS = ['Jeju', 'Ulleungdo'];
+
+  if (orderAmount >= FREE_SHIPPING_THRESHOLD) {
+    return 0;
+  }
+
+  const baseFee = BASIC_FEE;
+  const extraFee = EXTRA_FEE_REGIONS.includes(region) ? 3000 : 0;
+
+  return baseFee + extraFee;
+}
+```
+
+### Example 2: Data Structure
+
+```tsx
+/**
+ * User interface
+ *
+ * @codesyncer-context GDPR compliance required
+ * @codesyncer-rule Personal data must be encrypted
+ */
+interface User {
+  id: string;
+
+  // @codesyncer-inference: Using email as username (common pattern)
+  email: string;
+
+  // @codesyncer-decision: [2024-10-12] bcrypt hashing (security team recommendation)
+  passwordHash: string;
+
+  // @codesyncer-context: For Soft Delete
+  // @codesyncer-decision: [2024-10-15] Permanent delete after 30 days (GDPR)
+  deletedAt?: Date;
+
+  createdAt: Date;
+  updatedAt: Date;
+}
+```
+
+### Example 3: Component
+
+```tsx
+/**
+ * Order list table component
+ *
+ * @codesyncer-context Customer order history view
+ * @codesyncer-inference Pagination needed (large dataset)
+ * @codesyncer-decision [2024-10-16] Using TanStack Table (performance)
+ */
+export function OrderListTable({ orders }: OrderListTableProps) {
+  // @codesyncer-inference: 20 items per page (UX standard)
+  const [pageSize, setPageSize] = useState(20);
+
+  // @codesyncer-todo: Add sorting options (date, amount, status)
+
+  return (
+    <Table>
+      {/* @codesyncer-rule: Switch to card layout on mobile */}
+      {/* ... */}
+    </Table>
+  );
+}
+```
+
+---
+
+## ❌ Bad Comment Examples
+
+### Comments to Avoid
+
+```tsx
+// ❌ Too vague
+// @codesyncer-inference: Did this
+const value = 10;
+
+// ❌ No rationale
+// @codesyncer-decision: Changed
+const API_URL = '/api/new';
+
+// ❌ Meaningless
+// @codesyncer-todo: Later
+function doSomething() {}
+
+// ❌ Lacks context
+// @codesyncer-context: Important
+const IMPORTANT_VALUE = 42;
+```
+
+### Improved Versions
+
+```tsx
+// ✅ Specific rationale
+// @codesyncer-inference: Default 10 (typical retry wait time)
+const RETRY_DELAY = 10;
+
+// ✅ Clear reason and date
+// @codesyncer-decision: [2024-10-17] Changed to /api/v2 (API version upgrade)
+const API_URL = '/api/v2';
+
+// ✅ Specific TODO
+// @codesyncer-todo: Add error handling (network errors, timeouts)
+function fetchData() {}
+
+// ✅ Business context explanation
+// @codesyncer-context: VAT rate (10% as of 2024)
+const TAX_RATE = 0.1;
+```
+
+---
+
+## 🔍 Comment Search
+
+### Bash Commands
+
+```bash
+# Find all inferences
+grep -r "@codesyncer-inference" ./src
+
+# Check TODO list
+grep -r "@codesyncer-todo" ./src
+
+# Discussion decisions
+grep -r "@codesyncer-decision" ./src
+
+# Special rules
+grep -r "@codesyncer-rule" ./src
+
+# Business context
+grep -r "@codesyncer-context" ./src
+```
+
+### VS Code Search
+
+1. `Cmd/Ctrl + Shift + F` (Global search)
+2. Enter search term: `@codesyncer-todo`
+3. File filter: `src/**/*.{ts,tsx,js,jsx}`
+
+---
+
+## 📊 Comment Statistics
+
+ARCHITECTURE.md automatically provides statistics:
+
+```markdown
+## Comment Tag Statistics
+- @codesyncer-inference: 45
+- @codesyncer-decision: 12
+- @codesyncer-todo: 8
+- @codesyncer-rule: 5
+- @codesyncer-context: 15
+```
+
+Manual refresh with "update stats" command
+
+---
+
+## 💡 Comment Writing Tips
+
+### 1. Always provide rationale for inferences
+
+```tsx
+// ❌ @codesyncer-inference: Using useState
+// ✅ @codesyncer-inference: Using useState (simple local state, Zustand unnecessary)
+```
+
+### 2. Include date and reason for decisions
+
+```tsx
+// ❌ @codesyncer-decision: Using Stripe
+// ✅ @codesyncer-decision: [2024-10-15] Using Stripe (international payment support needed)
+```
+
+### 3. Be specific with TODOs
+
+```tsx
+// ❌ @codesyncer-todo: Needs fix
+// ✅ @codesyncer-todo: Add error boundary (fallback UI for API failures)
+```
+
+### 4. Focus on "why" for context
+
+```tsx
+// ❌ @codesyncer-context: Authentication
+// ✅ @codesyncer-context: OAuth 2.0 authentication (Google, Kakao login support)
+```
+
+### 5. Rules only for exceptional cases
+
+```tsx
+// ❌ @codesyncer-rule: Using TypeScript (this is obvious)
+// ✅ @codesyncer-rule: This file only allows any type (external library has no types)
+```
+
+---
+
+## 🎯 Checklist
+
+After writing code, verify:
+
+- [ ] Added `@codesyncer-inference` for inferences?
+- [ ] Recorded discussion decisions with `@codesyncer-decision`?
+- [ ] Marked items needing confirmation with `@codesyncer-todo`?
+- [ ] Explained business logic with `@codesyncer-context`?
+- [ ] Specified special rules with `@codesyncer-rule`?
+- [ ] Included specific rationale in all comments?
+
+---
+
+**Version**: 1.0.0
+**Last Updated**: [TODAY]
+
+*This comment system permanently records all decisions in code.*

package/src/templates/en/decisions.md

@@ -0,0 +1,227 @@
+# DECISIONS.md - Discussion Decision Log
+
+> **Decision Log** - Permanent record of all important decisions
+>
+> Created: [TODAY]
+
+---
+
+## 📋 Record Format
+
+All discussion decisions are automatically recorded in this format:
+
+```markdown
+---
+### [Date] - [Topic]
+**Category**: [CRITICAL/IMPORTANT/MINOR]
+**Decision**: [Decision made]
+**Reason**: [Rationale for decision]
+**Alternatives**: [Other options considered]
+**Decided By**: [User name or team name]
+**Code Location**: [file path:line]
+**Related Issue**: [Issue number or link]
+---
+```
+
+---
+
+## 📝 Decision Records
+
+<!-- Auto-added here during discussions -->
+
+### Example Record
+
+---
+### 2024-10-17 - Data Deletion Method Selection
+**Category**: CRITICAL
+**Decision**: Using Soft Delete method
+**Reason**:
+- Need 30-day recovery period (customer request response)
+- Maintain statistical data
+- GDPR compliance (permanent delete after 30 days)
+**Alternatives**:
+- Hard Delete: Immediate deletion (no recovery)
+- Archive: Move to separate table (increased complexity)
+**Decided By**: Dev team + Planning team collaboration
+**Code Location**: `src/services/UserService.ts:45`
+**Related Issue**: #123
+---
+
+---
+
+## 📊 Category Statistics
+
+- **CRITICAL**: 0 (Payment, Security, Data deletion, etc.)
+- **IMPORTANT**: 0 (Business logic, Pricing, External integration, etc.)
+- **MINOR**: 0 (UI/UX, Performance optimization, etc.)
+
+**Total Decisions**: 0
+
+---
+
+## 🔍 Category Descriptions
+
+### CRITICAL (Required Discussion)
+- 💰 Payment/Billing related
+- 🔐 Authentication/Authorization/Security
+- 🗑️ Data deletion/Migration
+- 📜 Personal data/Legal regulations
+
+### IMPORTANT (Recommended Discussion)
+- 💵 Pricing/Business logic
+- 🔌 External API integration
+- 🚀 Deployment/Infrastructure changes
+
+### MINOR (Optional Discussion)
+- 🎨 UI/UX improvements
+- ⚡ Performance optimization
+- 📦 Library changes
+
+---
+
+## 🔗 Related Documents
+
+Decisions are also recorded as comments in code:
+
+```tsx
+/**
+ * @codesyncer-decision: [2024-10-17] Soft Delete method
+ * Reason: 30-day recovery, GDPR compliance
+ */
+async function deleteUser(id: string) {
+  return db.update(id, { deleted_at: new Date() });
+}
+```
+
+**Search**: `grep -r "@codesyncer-decision" ./src`
+
+---
+
+## 📅 Monthly Statistics
+
+### October 2024
+- Total Decisions: 0
+- CRITICAL: 0
+- IMPORTANT: 0
+- MINOR: 0
+
+---
+
+## 💡 Discussion Process
+
+### 1. Auto Keyword Detection
+AI automatically pauses when detecting:
+- Payment, authentication, deletion, pricing, etc.
+
+### 2. Present Options
+```
+⚠️ 'payment' keyword detected. Discussion needed.
+
+💡 Recommendation:
+Use Stripe
+
+🔄 Alternatives:
+A. Iamport
+B. Toss Payments
+C. Custom implementation
+
+How would you like to proceed?
+```
+
+### 3. User Response
+- "Proceed" → Adopt recommendation
+- "Alternative A" → Choose alternative
+- "Hold" → Decide later
+
+### 4. Auto Record
+- Add to DECISIONS.md
+- Add `@codesyncer-decision` comment to code
+- Update ARCHITECTURE.md statistics
+
+---
+
+## 🎯 Best Practices
+
+### ✅ Good Decision Record
+
+```markdown
+### 2024-10-15 - Payment System Selection
+**Category**: CRITICAL
+**Decision**: Using Stripe
+**Reason**:
+- International payment support needed
+- Built-in subscription payment feature
+- Stable service
+**Alternatives**:
+- Iamport: Korea only (no international)
+- Toss: Subscription feature still lacking
+**Decided By**: CTO + Dev team
+**Code Location**: `src/services/PaymentService.ts`
+```
+
+### ❌ Bad Decision Record
+
+```markdown
+### Yesterday - Something decided
+**Category**: Important
+**Decision**: This one
+**Reason**: Just because
+```
+
+---
+
+## 🔄 Auto-Updates
+
+This document auto-updates in these situations:
+
+1. **Discussion-required keyword** detected and decision made
+2. User explicitly requests discussion
+3. When `@codesyncer-decision` tag added
+
+**Manual Addition**: Can write directly in above format
+
+---
+
+## 📚 Search
+
+### Find Recent Decisions
+```bash
+# Last 10 decisions
+tail -n 50 .claude/DECISIONS.md
+
+# Specific category
+grep "CRITICAL" .claude/DECISIONS.md
+
+# Specific date
+grep "2024-10-" .claude/DECISIONS.md
+```
+
+### Find Decisions in Code
+```bash
+# All decision comments
+grep -r "@codesyncer-decision" ./src
+
+# Decisions in specific file
+grep "@codesyncer-decision" src/services/PaymentService.ts
+```
+
+---
+
+## 🤝 Team Collaboration
+
+### New Team Member Onboarding
+1. Read this file from start
+2. Understand key decisions
+3. Learn "why it was implemented this way"
+
+### Decision Review
+- Monthly team meeting review
+- Mark decisions needing reconsideration
+- Add changed decisions as new entries
+
+---
+
+**Version**: 1.0.0
+**Last Updated**: [TODAY]
+
+*All important decisions are permanently recorded. This is your team's knowledge asset.*

package/src/templates/en/master.md

@@ -0,0 +1,179 @@
+# 🤖 [PROJECT_NAME] Multi-Repository Auto-Switching System
+
+> Just request a feature, and your AI coding assistant will automatically find and work in the right repository.
+>
+> **Powered by CodeSyncer** - AI-agnostic multi-repository collaboration system
+
+---
+
+## 🎯 Core Operating Principle
+
+### Automatic Repository Detection & Switching
+When you request a feature, the AI assistant automatically:
+1. Analyzes request → Identifies required repositories
+2. Switches to the relevant repository
+3. Applies each repository's CLAUDE.md rules
+4. Performs the task
+
+## 📁 Project Repository Structure
+
+| Repository | Folder | Role | Rules File Location |
+|------------|--------|------|---------------------|
+[REPO_TABLE]
+
+## 🧠 Automatic Repository Selection Rules
+
+### Keyword-Based Auto Detection
+| Keywords | Target Repository | Auto Command |
+|----------|------------------|--------------|
+[KEYWORD_MAPPING]
+
+### Task Type-Based Auto Detection
+```javascript
+function auto_select_repository(user_request) {
+  // API modification needed?
+  if (request.match(/API|data|server|auth|DB/)) {
+    work_repos.push("backend repo");
+  }
+
+  // UI modification needed?
+  if (request.match(/page|screen|button|form|UI/)) {
+    work_repos.push("frontend repo");
+  }
+
+  // Multiple repos needed?
+  if (request.includes("feature") && !specific_repo_mentioned) {
+    // Backend → Frontend → Mobile order
+    return ["backend", "frontend", "mobile"];
+  }
+
+  return work_repos;
+}
+```
+
+## 🔄 Auto-Switching Protocol
+
+### Single Repository Task
+
+```bash
+User: "Create login API"
+
+AI Auto Action:
+1. Detect "API" keyword
+2. cd [backend folder]
+3. cat CLAUDE.md  # Load backend rules
+4. [Create API following backend rules]
+5. "✅ Login API created in [backend repo]"
+```
+
+### Multi-Repository Task
+
+```bash
+User: "Add payment feature"
+
+AI Auto Action:
+1. "feature" keyword → Multiple repos needed
+2. Determine work order:
+   - Step 1: [backend] - API
+   - Step 2: [frontend] - UI
+   - Step 3: [mobile] - App screen
+
+3. Sequential work:
+   cd [backend folder] && cat CLAUDE.md
+   → Create payment API
+
+   cd ../[frontend folder] && cat CLAUDE.md
+   → Create payment page
+
+   cd ../[mobile folder] && cat CLAUDE.md
+   → Create payment screen
+
+4. "✅ Payment feature fully implemented"
+```
+
+## ⚠️ Important Rules
+
+### When Switching Repositories, Always
+
+1. Check current location: `pwd`
+2. Move to target repo: `cd ../[repo name]`
+3. Load rules file: `cat CLAUDE.md || cat .claude/CLAUDE.md`
+4. Notify rules applied: "📁 [repo name] rules applied"
+5. Work following those rules
+
+### Priority Order
+
+1. User-specified repo > Auto detection
+2. Each repo's CLAUDE.md > This master document
+3. Backend work > Frontend/Mobile work (order)
+
+## 🚀 Usage
+
+### Session Start
+
+```
+"[PROJECT_NAME] multi-repo mode start"
+→ Load this document
+→ Activate auto-switching system
+```
+
+### Task Requests (User doesn't need to know repos)
+
+```
+"Add user management" → Auto work in all needed repos
+"Fix bug" → Auto explore related repos
+"Login page only" → Work only in frontend repo
+```
+
+## 📊 Work Log Format
+
+```yaml
+Request: "[User request content]"
+Analysis:
+  required_repos: [[repo1], [repo2]]
+  work_order: [backend → frontend]
+Execution:
+  [repo1]:
+    navigate: cd [folder]
+    rules: Apply CLAUDE.md
+    work: [performed task]
+    result: ✅
+  [repo2]:
+    navigate: cd [folder]
+    rules: Apply CLAUDE.md
+    work: [performed task]
+    result: ✅
+Complete: "[summary]"
+```
+
+---
+
+## 🏷️ Comment Tag System
+
+CodeSyncer supports both tag formats:
+
+- **`@codesyncer-*`** (Recommended): New standard, compatible with all AI tools
+- **`@claude-*`** (Legacy): Compatible with existing Claude Code projects
+
+### Available Tags
+
+```typescript
+@codesyncer-rule        // Special rules (@claude-rule compatible)
+@codesyncer-inference   // Inference and rationale (@claude-inference compatible)
+@codesyncer-decision    // Discussion decisions (@claude-decision compatible)
+@codesyncer-todo        // Needs confirmation (@claude-todo compatible)
+@codesyncer-context     // Business context (@claude-context compatible)
+```
+
+Both formats work identically, so use whichever you prefer!
+
+---
+
+**GitHub**: https://github.com/[GITHUB_USERNAME]/[PROJECT_NAME]
+**Version**: 1.0.0 (Powered by CodeSyncer)
+**Created**: [TODAY]
+
+---
+
+*CodeSyncer - AI-powered multi-repository collaboration system*
+*Currently Supported: Claude Code | Coming Soon: Cursor, GitHub Copilot, Continue.dev*