our-claude-skills/ourdigital-custom-skills/20-jamie-brand-editor/docs/PLAN.md

# Jamie Brand Editor - Development Plan

> **Status**: Under Development
> **Current Version**: 1.0.0
> **Target Version**: 2.8.0 (sync with Guardian)
> **Last Updated**: 2025-12-11

---

## Overview

This document outlines the refactoring roadmap for jamie-brand-editor skill to align with jamie-brand-guardian v2.8 and establish clear role separation.

### Role Definition

| Skill | Role | Input | Output |
|-------|------|-------|--------|
| **jamie-brand-editor** | Content GENERATION | Topic/brief | Brand-compliant draft |
| **jamie-brand-guardian** | Content REVIEW | Existing content | Feedback/corrections |

---

## Current State Assessment

### Evaluation Score (2025-12-11)

| Area | Score | Status |
|------|-------|--------|
| SKILL.md Structure | 85/100 | OK |
| Brand Guidelines Alignment | 70/100 | Needs Work |
| Resource Completeness | 45/100 | Critical |
| Role Separation | 75/100 | Needs Work |
| **Overall** | **69/100** | Refactoring Required |

### Existing Resources

```
20-jamie-brand-editor/
├── SKILL.md (551 lines - too long)
├── README.md
├── brand_guidelines/
│   ├── brand_voice_guide_korean.md ✅
│   └── content_examples/
│       └── [4 PDF files] ✅
├── procedures_schema_dataset/
│   └── [16 JSON files] ✅
├── regulations/
│   └── medical_advertising_law_summary_korean.md ✅
├── scripts/
│   └── compliance_checker.py ✅
├── templates/ (EMPTY) ❌
└── docs/ (development docs, excluded from skill)
    └── PLAN.md
```

### Missing Resources (Referenced in SKILL.md but don't exist)

```
❌ brand_guidelines/brand_pillars_detailed.md
❌ brand_guidelines/competitive_positioning.md
❌ brand_guidelines/content_examples/approved_webpage_samples.md
❌ brand_guidelines/content_examples/successful_blog_posts.md
❌ brand_guidelines/content_examples/compliant_social_media.md
❌ regulations/compliance_checklist.md
❌ regulations/prohibited_content_examples.md
❌ regulations/required_disclaimers_templates.md
❌ templates/procedure_page_template_korean.md
❌ templates/blog_post_template.md
❌ templates/social_media_templates.md
❌ templates/advertising_copy_templates.md
❌ scripts/brand_voice_analyzer.py
❌ scripts/content_generator.py
❌ scripts/seo_optimizer.py
```

---

## Refactoring Roadmap

### Phase 1: SKILL.md Cleanup (Priority: Critical)

**Goal**: Reduce SKILL.md to <300 lines, remove non-existent features

**Tasks**:
1. [ ] Remove "Content Review" sections (Guardian's role)
2. [ ] Remove "Regulatory Compliance Checks" workflow (Guardian's role)
3. [ ] Remove references to non-existent scripts
4. [ ] Remove references to non-existent template files
5. [ ] Move detailed regulations to `regulations/` folder
6. [ ] Move usage examples to `examples/` folder
7. [ ] Keep only: Role, Core Functions, Tone Guidelines, Content Structure, Usage

**Target Structure**:
```markdown
# Jamie Brand Editor Skill
## Role Definition (Editor = Generation, Guardian = Review)
## Core Functions (Content Types Supported)
## Tone & Manner Quick Reference (sync with Guardian)
## Content Structure Templates
## Procedure Knowledge (reference to JSON dataset)
## Usage Instructions
## Available Resources
```

### Phase 2: Tone & Manner Sync (Priority: High)

**Goal**: Sync with Guardian v2.8 tone guidelines

**Tasks**:
1. [ ] Add 종결 어미 비율 (90% 격식체, 6% 서비스형, 4% 부드러운)
2. [ ] Add 호칭 가이드 (환자분 61%, 고객님 22%, 여러분 17%)
3. [ ] Add 권장 형용사 TOP 5
4. [ ] Add 비유 표현 패턴 (정기호 원장 스타일)
5. [ ] Add 브랜드 슬로건
6. [ ] Add 제이미의 약속 4가지
7. [ ] Add 브랜드 퍼스낼리티 5가지

**Source**: Copy from `../21-jamie-brand-guardian/SKILL.md` (Voice & Tone Guidelines section)

### Phase 3: Templates Implementation (Priority: High)

**Goal**: Create actual content generation templates

**Tasks**:
1. [ ] Create `templates/blog-post-template.md`
2. [ ] Create `templates/procedure-page-template.md`
3. [ ] Create `templates/social-media-templates.md`
4. [ ] Create `templates/ad-copy-templates.md`

**Template Format**:
```markdown
---
name: template-name
type: blog|procedure|social|ad
variables:
  - procedure_name
  - target_audience
  - key_benefits
---

[Template content with {{variable}} placeholders]
```

### Phase 4: Script Implementation (Priority: Medium)

**Goal**: Implement referenced scripts or remove references

**Option A - Implement**:
1. [ ] `scripts/content_generator.py` - Template-based generation using JSON data
2. [ ] `scripts/brand_voice_analyzer.py` - Simple keyword/pattern checker

**Option B - Remove**:
- Remove all script references from SKILL.md
- Keep only `compliance_checker.py`

**Recommendation**: Option B for v1.x, Option A for v2.0

### Phase 5: Resource Organization (Priority: Medium)

**Tasks**:
1. [ ] Create `examples/` folder with sample outputs
2. [ ] Move detailed regulation content to `regulations/`
3. [ ] Create `regulations/compliance_checklist.md`
4. [ ] Create `regulations/required_disclaimers.md`

### Phase 6: Version Alignment (Priority: Low)

**Goal**: Sync version with Guardian

**Tasks**:
1. [ ] Update version to 2.0.0 after Phase 1-3 complete
2. [ ] Update version to 2.8.0 after full alignment with Guardian

---

## File Structure Target

```
20-jamie-brand-editor/
├── SKILL.md (<300 lines, generation-focused)
├── brand_guidelines/
│   ├── brand_voice_guide_korean.md
│   ├── tone_manner_quick_reference.md (NEW - sync with Guardian)
│   └── content_examples/
│       └── [PDF files]
├── procedures_schema_dataset/
│   └── [16 JSON files]
├── regulations/
│   ├── medical_advertising_law_summary_korean.md
│   ├── compliance_checklist.md (NEW)
│   └── required_disclaimers.md (NEW)
├── templates/ (NEW)
│   ├── blog-post-template.md
│   ├── procedure-page-template.md
│   ├── social-media-templates.md
│   └── ad-copy-templates.md
├── examples/ (NEW)
│   ├── sample-blog-post.md
│   └── sample-procedure-page.md
├── scripts/
│   └── compliance_checker.py
└── docs/ (excluded from skill packaging)
    ├── PLAN.md
    ├── EVALUATION.md
    └── CHANGELOG.md
```

---

## Integration Notes

### Guardian Reference Pattern

Editor should reference Guardian for:
- Detailed brand guidelines: `See jamie-brand-guardian/guides/`
- Visual identity: `See jamie-brand-guardian/design/`
- Review templates: `See jamie-brand-guardian/templates/`

### Workflow Integration

```
[User Request]
    → jamie-brand-editor (generate draft)
    → jamie-brand-guardian (review & correct)
    → [Final Content]
```

---

## Version History

| Version | Date | Changes |
|---------|------|---------|
| 1.0.0 | 2025-11-18 | Initial release |
| 1.0.1 | 2025-12-10 | Role separation clarified |
| 1.1.0 | TBD | Phase 1 complete (SKILL.md cleanup) |
| 2.0.0 | TBD | Phase 1-3 complete (templates added) |
| 2.8.0 | TBD | Full alignment with Guardian v2.8 |

---

## Notes

- `/docs` folder is excluded from skill packaging
- Development documentation stays in `/docs`
- Only production-ready resources go in main skill folders