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:

# 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:

---
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