directory changes and restructuring
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
246
custom-skills/40-jamie-brand-editor/code/docs/PLAN.md
Normal file
246
custom-skills/40-jamie-brand-editor/code/docs/PLAN.md
Normal file
@@ -0,0 +1,246 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user