CodeSyncer
Claude forgets everything when the session ends. CodeSyncer makes it remember.
When to use
Use this skill on ANY project where you want AI to:
- Remember decisions across sessions
- Track why code was written a certain way
- Auto-pause before touching payment/security/API code
- Never lose context again
Core Rules
1. Always Add Tags
| Situation |
Tag |
Example |
| You inferred something |
@codesyncer-inference |
// @codesyncer-inference: Page size 20 (standard UX) |
| Decision after discussion |
@codesyncer-decision |
// @codesyncer-decision: [2024-01-15] Using JWT |
| Non-standard implementation |
@codesyncer-rule |
// @codesyncer-rule: any type here (no types available) |
| Needs user confirmation |
@codesyncer-todo |
// @codesyncer-todo: Confirm API endpoint |
| Business context |
@codesyncer-context |
// @codesyncer-context: GDPR requires 30-day retention |
2. Never Infer Critical Values
ALWAYS ASK the user about:
- 💰 Prices, fees, discounts, billing
- 🔐 Auth methods, token expiry, encryption
- 🔌 API endpoints, external service URLs
- 🗄️ Database schemas, migrations
❌ Bad: "I set the shipping fee to $5"
✅ Good: "What should the shipping fee be?"
3. Auto-Pause Keywords
When you detect these keywords, STOP and discuss before coding:
- payment, billing, subscription, charge, refund
- authentication, login, permission, encrypt, token
- delete, remove, drop, migrate, schema change
- personal data, GDPR, privacy
Tag Examples
// @codesyncer-decision: [2024-01-15] Using Stripe for payments (international support)
// @codesyncer-context: Supports USD, EUR, KRW currencies
const paymentProvider = 'stripe';
// @codesyncer-inference: 5 second timeout (typical API response time)
// @codesyncer-rule: Retry max 3 times (rate limit protection)
const apiConfig = {
timeout: 5000,
retries: 3,
};
// @codesyncer-todo: Confirm discount percentage with business team
const DISCOUNT_RATE = 0.1; // 10%
Why This Matters
Next session, when AI reads your code:
- Sees
@codesyncer-decision → Knows WHY you chose Stripe
- Sees
@codesyncer-inference → Knows the reasoning behind values
- Sees
@codesyncer-todo → Knows what still needs confirmation
Context survives across sessions. No more "why did we do this?"
Quick Reference
Inferred something? → @codesyncer-inference: [reason]
Made a decision? → @codesyncer-decision: [date] [what] [why]
Special rule? → @codesyncer-rule: [explanation]
Need to confirm? → @codesyncer-todo: [what to confirm]
Business context? → @codesyncer-context: [domain knowledge]
Learn More
1---2name: codesyncer3description: AI context persistence - tags in code = permanent memory across sessions4---5
6# CodeSyncer
7
8> Claude forgets everything when the session ends. CodeSyncer makes it remember.
9
10## When to use
11
12Use this skill on ANY project where you want AI to:
13- Remember decisions across sessions
14- Track why code was written a certain way
15- Auto-pause before touching payment/security/API code
16- Never lose context again
17
18## Core Rules
19
20### 1. Always Add Tags
21
22| Situation | Tag | Example |
23|-----------|-----|---------|
24| You inferred something | `@codesyncer-inference` | `// @codesyncer-inference: Page size 20 (standard UX)` |
25| Decision after discussion | `@codesyncer-decision` | `// @codesyncer-decision: [2024-01-15] Using JWT` |
26| Non-standard implementation | `@codesyncer-rule` | `// @codesyncer-rule: any type here (no types available)` |
27| Needs user confirmation | `@codesyncer-todo` | `// @codesyncer-todo: Confirm API endpoint` |
28| Business context | `@codesyncer-context` | `// @codesyncer-context: GDPR requires 30-day retention` |
29
30### 2. Never Infer Critical Values
31
32**ALWAYS ASK the user about:**
33- 💰 Prices, fees, discounts, billing
34- 🔐 Auth methods, token expiry, encryption
35- 🔌 API endpoints, external service URLs
36- 🗄️ Database schemas, migrations
37
38```
39❌ Bad: "I set the shipping fee to $5"
40✅ Good: "What should the shipping fee be?"
41```
42
43### 3. Auto-Pause Keywords
44
45When you detect these keywords, **STOP and discuss** before coding:
46- payment, billing, subscription, charge, refund
47- authentication, login, permission, encrypt, token
48- delete, remove, drop, migrate, schema change
49- personal data, GDPR, privacy
50
51## Tag Examples
52
53```typescript
54// @codesyncer-decision: [2024-01-15] Using Stripe for payments (international support)
55// @codesyncer-context: Supports USD, EUR, KRW currencies
56const paymentProvider = 'stripe';
57
58// @codesyncer-inference: 5 second timeout (typical API response time)
59// @codesyncer-rule: Retry max 3 times (rate limit protection)
60const apiConfig = {
61 timeout: 5000,
62 retries: 3,
63};
64
65// @codesyncer-todo: Confirm discount percentage with business team
66const DISCOUNT_RATE = 0.1; // 10%
67```
68
69## Why This Matters
70
71Next session, when AI reads your code:
721. Sees `@codesyncer-decision` → Knows WHY you chose Stripe
732. Sees `@codesyncer-inference` → Knows the reasoning behind values
743. Sees `@codesyncer-todo` → Knows what still needs confirmation
75
76**Context survives across sessions. No more "why did we do this?"**
77
78## Quick Reference
79
80```
81Inferred something? → @codesyncer-inference: [reason]
82Made a decision? → @codesyncer-decision: [date] [what] [why]
83Special rule? → @codesyncer-rule: [explanation]
84Need to confirm? → @codesyncer-todo: [what to confirm]
85Business context? → @codesyncer-context: [domain knowledge]
86```
87
88## Learn More
89
90- [Full Documentation](https://github.com/bitjaru/codesyncer)
91- [Tag System Guide](https://github.com/bitjaru/codesyncer/blob/main/docs/TAGS.md)
92- [Hooks Guide](https://github.com/bitjaru/codesyncer/blob/main/docs/HOOKS.md)
majiayu000