@yeongjaeyou/claude-code-config 0.18.5 → 0.18.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/.claude/commands/gh/auto-review-loop.md +2 -2
  2. package/.claude/commands/gh/decompose-issue.md +12 -12
  3. package/.claude/commands/gh/resolve-and-review.md +1 -1
  4. package/.claude/guidelines/id-reference.md +2 -2
  5. package/.claude/guidelines/prd-guide.md +13 -13
  6. package/.claude/guidelines/work-guidelines.md +7 -3
  7. package/.claude/hooks/inject-guidelines.sh +2 -1
  8. package/.claude/hooks/notify_osc.sh +7 -7
  9. package/.claude/skills/code-explorer/SKILL.md +21 -21
  10. package/.claude/skills/midjourney-imagineapi/SKILL.md +260 -0
  11. package/.claude/skills/midjourney-imagineapi/references/imagineapi-integration.md +197 -0
  12. package/.claude/skills/midjourney-imagineapi/references/midjourney-parameters.md +393 -0
  13. package/.claude/skills/midjourney-imagineapi/references/midjourney-style-guide.md +296 -0
  14. package/.claude/skills/midjourney-imagineapi/references/prompt-examples.md +428 -0
  15. package/.claude/skills/notion-md-uploader/scripts/__pycache__/markdown_parser.cpython-311.pyc +0 -0
  16. package/.claude/skills/notion-md-uploader/scripts/__pycache__/notion_client.cpython-311.pyc +0 -0
  17. package/.claude/skills/notion-md-uploader/scripts/__pycache__/notion_converter.cpython-311.pyc +0 -0
  18. package/.claude/skills/notion-md-uploader/scripts/__pycache__/upload_md.cpython-311.pyc +0 -0
  19. package/package.json +1 -1
  20. package/.claude/skills/youtube-collector/README.md +0 -107
  21. package/.claude/skills/youtube-collector/SKILL.md +0 -158
  22. package/.claude/skills/youtube-collector/references/data-schema.md +0 -110
  23. package/.claude/skills/youtube-collector/scripts/collect_videos.py +0 -304
  24. package/.claude/skills/youtube-collector/scripts/fetch_transcript.py +0 -138
  25. package/.claude/skills/youtube-collector/scripts/fetch_videos.py +0 -229
  26. package/.claude/skills/youtube-collector/scripts/register_channel.py +0 -247
  27. package/.claude/skills/youtube-collector/scripts/setup_api_key.py +0 -151
@@ -51,7 +51,7 @@ MAX_ITERATIONS=10
51
51
 
52
52
  ### Step 2: Wait for All Checks
53
53
 
54
- `gh pr checks`로 CodeRabbit과 Actions 상태를 번에 확인.
54
+ Check CodeRabbit and Actions status at once with `gh pr checks`.
55
55
 
56
56
  ```bash
57
57
  wait_for_all_checks() {
@@ -81,7 +81,7 @@ wait_for_all_checks() {
81
81
 
82
82
  ### Step 3: Check Unresolved Threads (GraphQL)
83
83
 
84
- CodeRabbit 리뷰 코멘트 미해결 건수 확인. This is the ground truth.
84
+ Check unresolved CodeRabbit review comment count. This is the ground truth.
85
85
 
86
86
  ```bash
87
87
  check_unresolved_threads() {
@@ -14,9 +14,9 @@ Break down large work items into manageable, independent issues. Follow project
14
14
  - Detect test frameworks (jest.config.*, pytest.ini, vitest.config.*, pyproject.toml, etc.)
15
15
  3. **Check TDD applicability** (if user hasn't specified):
16
16
  - Analyze work type: code implementation vs docs/infra/config
17
- - If test framework detected + code work → Ask: "TDD 기반으로 이슈 생성하시겠어요?"
18
- - If no test framework → Inform: "TDD 반영이 필요없습니다. (이유: 테스트 프레임워크 미감지)"
19
- - If non-code work (docs/infra) → Inform: "TDD 반영이 필요없습니다. (이유: 비코드 작업)"
17
+ - If test framework detected + code work → Ask: "Create issues with TDD approach?"
18
+ - If no test framework → Inform: "TDD not required. (Reason: No test framework detected)"
19
+ - If non-code work (docs/infra) → Inform: "TDD not required. (Reason: Non-code work)"
20
20
  - If TDD selected: Add `<!-- TDD: enabled -->` marker to each issue body
21
21
  4. Analyze work: Understand core requirements and objectives
22
22
  5. Decompose work: Split major tasks into smaller, manageable sub-tasks or issues. **Aim for optimal count over excessive issues (keep it manageable)**
@@ -164,14 +164,14 @@ Always include an ASCII diagram in the issue body to visualize the execution flo
164
164
 
165
165
  ## Verification Guidelines
166
166
 
167
- 이슈 작업 완료 반드시 실행 검증 수행:
167
+ Verification is mandatory when issue work is complete:
168
168
 
169
- | 작업 유형 | 검증 방법 |
170
- |-----------|-----------|
171
- | Python 코드 | `python -m py_compile file.py` + 실제 실행 |
172
- | TypeScript/JS | `tsc --noEmit` 또는 빌드 |
173
- | API/서버 | 엔드포인트 호출 테스트 |
174
- | CLI 도구 | 기본 명령어 실행 |
175
- | 설정 파일 | 관련 도구로 로드 확인 |
169
+ | Work Type | Verification Method |
170
+ |-----------|---------------------|
171
+ | Python code | `python -m py_compile file.py` + actual execution |
172
+ | TypeScript/JS | `tsc --noEmit` or build |
173
+ | API/Server | Endpoint call test |
174
+ | CLI tools | Run basic commands |
175
+ | Config files | Verify loading with related tools |
176
176
 
177
- **파일만 생성하고 실행 검증 없이 완료 처리 금지**
177
+ **Never mark complete if only files are created without execution verification**
@@ -4,7 +4,7 @@ description: Full issue resolution pipeline with automated code review
4
4
 
5
5
  # Resolve and Review
6
6
 
7
- Issue 해결부터 CodeRabbit 리뷰 처리까지 자동화된 전체 파이프라인.
7
+ Automated full pipeline from issue resolution to CodeRabbit review handling.
8
8
 
9
9
  ## Arguments
10
10
 
@@ -20,7 +20,7 @@ Reference for different ID formats used across GitHub and TaskMaster.
20
20
 
21
21
  ## Linking GitHub and TaskMaster
22
22
 
23
- - PR body: `Task Master 참조: task N` or `TaskMaster: task N`
23
+ - PR body: `TaskMaster: task N` or `Task Master ref: task N`
24
24
  - Issue closing: `Closes #N` (GitHub Issue)
25
25
 
26
26
  ## Example
@@ -28,7 +28,7 @@ Reference for different ID formats used across GitHub and TaskMaster.
28
28
  ```
29
29
  PR #13: "feat: Add authentication"
30
30
  ├── Closes #1 (GitHub Issue)
31
- └── Task Master 참조: task 1
31
+ └── TaskMaster: task 1
32
32
  ├── task 1.1 (subtask)
33
33
  └── task 1.2 (subtask)
34
34
  ```
@@ -1,36 +1,36 @@
1
- # PRD 초안 템플릿
1
+ # PRD Draft Template
2
2
 
3
- 여기에 아이디어를 자유롭게 작성하세요.
4
- `/tm:convert-prd` 커맨드로 TaskMaster PRD 포맷으로 변환됩니다.
3
+ Write your ideas freely here.
4
+ Use `/tm:convert-prd` command to convert to TaskMaster PRD format.
5
5
 
6
6
  ---
7
7
 
8
- ## 만들고 싶은지
8
+ ## What to Build
9
9
 
10
- (프로젝트 목적, 해결하려는 문제)
10
+ (Project purpose, problem to solve)
11
11
 
12
12
 
13
13
 
14
- ## 주요 기능
14
+ ## Key Features
15
15
 
16
- (만들고 싶은 기능들 나열)
16
+ (List of features to build)
17
17
 
18
18
 
19
19
 
20
- ## 기술 스택
20
+ ## Tech Stack
21
21
 
22
- (사용할 기술, 프레임워크 )
22
+ (Technologies, frameworks to use)
23
23
 
24
24
 
25
25
 
26
- ## 만드는 순서
26
+ ## Build Order
27
27
 
28
- (먼저 만들 것, 나중에 만들 )
28
+ (What to build first, what to build later)
29
29
 
30
30
 
31
31
 
32
- ## 기타
32
+ ## Notes
33
33
 
34
- (걱정되는 점, 참고사항 등)
34
+ (Concerns, references, etc.)
35
35
 
36
36
 
@@ -23,7 +23,7 @@ Write like a human, not a chatbot. Applies to ALL text: responses, documentation
23
23
  - Over-explanation: Explaining obvious things, restating the question
24
24
  - Hedging phrases: "I think maybe...", "It might be possible that..."
25
25
  - Hollow transitions: "Now, let's...", "Moving on to...", "Next, we'll..."
26
- - Colon headers: "**항목:** 설명", "**Topic:** content" - just write naturally without label-colon-content structure
26
+ - Colon headers: "**Item:** description", "**Topic:** content" - just write naturally without label-colon-content structure
27
27
 
28
28
  **DO:**
29
29
  - Get to the point immediately
@@ -94,8 +94,8 @@ Utilize MCP servers whenever possible:
94
94
  - `firecrawl` - Web scraping and search
95
95
 
96
96
  ### Agent & Skill Usage
97
- - 작업에 적합한 agent 또는 skill 있다면 적극 활용
98
- - 의도가 명확하면 바로 사용, 불명확하면 제안 승인 받기
97
+ - Use appropriate agent or skill when available
98
+ - If intent is clear, use directly; if unclear, propose and get approval
99
99
 
100
100
  ### Code Exploration Strategy
101
101
 
@@ -220,6 +220,10 @@ If pip install errors occur, try in order:
220
220
  - **Minimal Output**: Avoid unnecessary print statements in code - only include meaningful debug output when explicitly requested
221
221
  - **No Emojis**: Never use emojis anywhere, whether in documentation or code
222
222
 
223
+ ### Code Documentation Language
224
+ - **Docstrings**: English (for API docs, IDE tooltips, type checker integration)
225
+ - **Inline/block comments**: Korean (for quick understanding and clarity)
226
+
223
227
  ---
224
228
 
225
229
  ## File Organization
@@ -10,11 +10,12 @@ GUIDELINES_DIR="$PROJECT_DIR/.claude/guidelines"
10
10
 
11
11
  # Primary guideline file to always inject
12
12
  PRIMARY_GUIDELINE="$GUIDELINES_DIR/work-guidelines.md"
13
+ RELATIVE_GUIDELINE=".claude/guidelines/work-guidelines.md"
13
14
 
14
15
  # Output as system-reminder for Claude to process
15
16
  if [ -f "$PRIMARY_GUIDELINE" ]; then
16
17
  echo "<system-reminder>"
17
- echo "Called the Read tool with the following input: {\"file_path\":\"$PRIMARY_GUIDELINE\"}"
18
+ echo "Called the Read tool with the following input: {\"file_path\":\"$RELATIVE_GUIDELINE\"}"
18
19
  echo "</system-reminder>"
19
20
  echo "<system-reminder>"
20
21
  echo "Result of calling the Read tool:"
@@ -1,11 +1,11 @@
1
1
  #!/bin/bash
2
2
  # Claude Code OSC Notification Script
3
- # /dev/tty 출력하여 터미널에 직접 전달
3
+ # Output to /dev/tty to deliver directly to terminal
4
4
 
5
- # stdin에서 JSON 읽기 (timeout으로 blocking 방지)
5
+ # Read JSON from stdin (prevent blocking with timeout)
6
6
  INPUT=$(timeout 1 cat 2>/dev/null || true)
7
7
 
8
- # JSON 파싱
8
+ # JSON parsing
9
9
  if command -v jq &>/dev/null && [ -n "$INPUT" ]; then
10
10
  SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null)
11
11
  CWD=$(echo "$INPUT" | jq -r '.cwd // empty' 2>/dev/null)
@@ -16,12 +16,12 @@ if command -v jq &>/dev/null && [ -n "$INPUT" ]; then
16
16
  FOLDER=$(basename "${CWD:-$PWD}" 2>/dev/null)
17
17
  SHORT_ID="${SESSION_ID:0:8}"
18
18
 
19
- # 제목 구성
19
+ # Title construction
20
20
  TITLE="Claude"
21
21
  [ -n "$FOLDER" ] && TITLE="$TITLE - $FOLDER"
22
22
  [ -n "$SHORT_ID" ] && TITLE="$TITLE [$SHORT_ID]"
23
23
 
24
- # 본문 구성
24
+ # Message body construction
25
25
  case "$EVENT" in
26
26
  "Stop")
27
27
  BODY="Task completed"
@@ -42,8 +42,8 @@ else
42
42
  BODY="${2:-Task completed}"
43
43
  fi
44
44
 
45
- # OSC 777 알림 출력 (OSC 9 중복 알림 발생하므로 제외)
46
- # /dev/tty 사용 가능 직접 출력, 아니면 stdout
45
+ # OSC 777 notification output (excluding OSC 9 as it causes duplicate notifications)
46
+ # Output directly to /dev/tty if available, otherwise stdout
47
47
  {
48
48
  printf '\033]777;notify;%s;%s\007' "$TITLE" "$BODY"
49
49
  } > /dev/tty 2>/dev/null || {
@@ -16,53 +16,53 @@ To search and analyze code repositories across GitHub and Hugging Face platforms
16
16
  | **GitHub** | Repositories, Code | `gh` CLI |
17
17
  | **Hugging Face** | Models, Datasets, Spaces | `uvx hf` CLI + `huggingface_hub` API |
18
18
 
19
- ## 검색 품질 원칙 (필수)
19
+ ## Search Quality Principles (Required)
20
20
 
21
- ### 1. 현재 날짜 확인
21
+ ### 1. Verify Current Date
22
22
 
23
23
  ```bash
24
24
  date +%Y-%m-%d
25
25
  ```
26
- 아래 예시의 연도는 참고용. 실제 검색 **현재 연도** 사용.
26
+ Years in examples below are for reference. Use **current year** in actual searches.
27
27
 
28
- ### 2. Long-tail Keywords 적용
28
+ ### 2. Apply Long-tail Keywords
29
29
 
30
- 예시의 Short-tail 그대로 쓰지 말고 확장:
30
+ Don't use short-tail examples as-is, expand them:
31
31
 
32
- | 예시 (참고용) | 실제 검색 (Long-tail) |
33
- |---------------|----------------------|
34
- | `"object detection"` | `"open vocabulary object detection pytorch inference {현재연도}"` |
32
+ | Example (Reference) | Actual Search (Long-tail) |
33
+ |---------------------|---------------------------|
34
+ | `"object detection"` | `"open vocabulary object detection pytorch inference {current_year}"` |
35
35
  | `"gradio demo"` | `"gradio image segmentation interactive demo huggingface"` |
36
36
  | `"qwen vl"` | `"qwen2-vl vision language model zero-shot example code"` |
37
37
 
38
- ### 3. Multi-Query 적용
38
+ ### 3. Apply Multi-Query
39
39
 
40
- 번에 찾기 어려우면 **2-3 관점**으로 검색:
40
+ If hard to find at once, search from **2-3 perspectives**:
41
41
 
42
42
  ```bash
43
- # 모델명 중심
43
+ # Model name focus
44
44
  gh search repos "qwen2-vl" --sort stars
45
45
 
46
- # 기능 중심
46
+ # Feature focus
47
47
  gh search repos "vision language open vocabulary detection" --sort stars
48
48
 
49
- # 구현 중심
49
+ # Implementation focus
50
50
  gh search repos "vl model gradio demo inference" --sort stars
51
51
  ```
52
52
 
53
- ### 4. 필터 활용
53
+ ### 4. Use Filters
54
54
 
55
55
  ```bash
56
- # 최신 + 품질 필터 (현재 연도 적용)
57
- gh search repos "keyword" stars:>50 pushed:>{현재연도-1}-01-01 --language python
56
+ # Recent + quality filter (apply current year)
57
+ gh search repos "keyword" stars:>50 pushed:>{current_year-1}-01-01 --language python
58
58
  ```
59
59
 
60
- ### 5. 검색 전 체크리스트
60
+ ### 5. Pre-Search Checklist
61
61
 
62
- - [ ] 현재 날짜 확인했는가?
63
- - [ ] Short-tail Long-tail로 변환했는가?
64
- - [ ] 필요시 2-3 변형 쿼리로 검색했는가?
65
- - [ ] 적절한 필터(언어, 스타, 날짜) 적용했는가?
62
+ - [ ] Verified current date?
63
+ - [ ] Converted short-tail to long-tail?
64
+ - [ ] Searched with 2-3 query variations if needed?
65
+ - [ ] Applied appropriate filters (language, stars, date)?
66
66
 
67
67
  ---
68
68
 
@@ -0,0 +1,260 @@
1
+ ---
2
+ name: midjourney-imagineapi
3
+ description: Generate optimized Midjourney V7 prompts and create images via ImagineAPI MCP server. Transform basic user requests into professional, cinematic prompts using 5-layer structure. Use when users request (1) Midjourney image generation, (2) prompt optimization for V7, (3) character/style reference usage, (4) professional photography prompts. Trigger phrases include "generate image", "create photo", "Midjourney", "make picture", "image generation".
4
+ ---
5
+
6
+ # Midjourney Prompt Optimizer for ImagineAPI
7
+
8
+ Transform user image requests into optimized Midjourney V7 prompts and generate images through ImagineAPI MCP.
9
+
10
+ ## Workflow Overview
11
+
12
+ ```
13
+ User Request -> Clarify (if needed) -> Build Prompt -> Present Options -> Generate Image -> Return Results
14
+ ```
15
+
16
+ ## Step 1: Analyze User Request
17
+
18
+ Determine what the user wants:
19
+ - Main subject and concept
20
+ - Implied style or mood
21
+ - Any specific requirements mentioned
22
+
23
+ If the request is clear and specific, proceed to Step 3.
24
+ If the request is vague or generic (e.g., "make me a cat picture"), proceed to Step 2.
25
+
26
+ ## Step 2: Clarify with User (When Needed)
27
+
28
+ For vague requests, use AskUserQuestion to clarify:
29
+
30
+ **Style Clarification:**
31
+ ```
32
+ AskUserQuestion:
33
+ header: "Style"
34
+ question: "What style do you want for this image?"
35
+ options:
36
+ - label: "Photorealistic"
37
+ description: "Looks like a real photograph"
38
+ - label: "Cinematic"
39
+ description: "Movie-like, dramatic lighting"
40
+ - label: "Artistic/Illustration"
41
+ description: "Stylized, artistic interpretation"
42
+ - label: "Minimal/Clean"
43
+ description: "Simple, clean aesthetic"
44
+ ```
45
+
46
+ **Mood Clarification:**
47
+ ```
48
+ AskUserQuestion:
49
+ header: "Mood"
50
+ question: "What mood or atmosphere?"
51
+ options:
52
+ - label: "Bright & Cheerful"
53
+ description: "Warm, optimistic feeling"
54
+ - label: "Moody & Dramatic"
55
+ description: "Dark, atmospheric, cinematic"
56
+ - label: "Calm & Serene"
57
+ description: "Peaceful, tranquil"
58
+ - label: "Energetic & Dynamic"
59
+ description: "Action, movement, excitement"
60
+ ```
61
+
62
+ **Aspect Ratio:**
63
+ ```
64
+ AskUserQuestion:
65
+ header: "Format"
66
+ question: "What format do you need?"
67
+ options:
68
+ - label: "Widescreen (16:9)"
69
+ description: "Cinematic, landscape, desktop"
70
+ - label: "Portrait (4:5)"
71
+ description: "Vertical, mobile, Instagram"
72
+ - label: "Square (1:1)"
73
+ description: "Social media, profile"
74
+ - label: "Ultra-wide (21:9)"
75
+ description: "Panoramic, banner"
76
+ ```
77
+
78
+ ## Step 3: Build Optimized Prompt
79
+
80
+ Use the 5-layer structure from `references/midjourney-style-guide.md`:
81
+
82
+ **Layer 1 (Required):** Subject & Composition
83
+ ```
84
+ [Subject] [action/pose], [composition]
85
+ ```
86
+
87
+ **Layer 2 (Required):** Style & Aesthetic
88
+ ```
89
+ [style], [mood], [color treatment]
90
+ ```
91
+
92
+ **Layer 3 (Recommended):** Lighting & Environment
93
+ ```
94
+ [lighting], [time of day], [atmosphere]
95
+ ```
96
+
97
+ **Layer 4 (Recommended):** Technical Details
98
+ ```
99
+ [camera] [lens] [aperture], [depth of field], [quality terms]
100
+ ```
101
+
102
+ **Layer 5 (Optional):** Artistic Reference
103
+ ```
104
+ [artist/style reference]
105
+ ```
106
+
107
+ Consult `references/prompt-examples.md` for transformation patterns.
108
+
109
+ ## Step 4: Select Parameters
110
+
111
+ Based on the image type, select appropriate parameters from `references/midjourney-parameters.md`:
112
+
113
+ **Portrait:**
114
+ ```
115
+ --ar 4:5 --s 100-150 --q 2
116
+ ```
117
+
118
+ **Landscape/Cinematic:**
119
+ ```
120
+ --ar 16:9 --s 150-250 --q 2
121
+ ```
122
+
123
+ **Product:**
124
+ ```
125
+ --ar 1:1 --s 50-100
126
+ ```
127
+
128
+ **Artistic:**
129
+ ```
130
+ --ar varies --s 300-500 --exp 10-25
131
+ ```
132
+
133
+ **Quick Iteration:**
134
+ ```
135
+ --draft --c 25-50
136
+ ```
137
+
138
+ ## Step 5: Present Options to User
139
+
140
+ Before generating, present 2-3 prompt variations using AskUserQuestion:
141
+
142
+ ```
143
+ AskUserQuestion:
144
+ header: "Prompt"
145
+ question: "Which prompt direction do you prefer?"
146
+ options:
147
+ - label: "Option A: Dramatic"
148
+ description: "[show key differences - lighting, mood]"
149
+ - label: "Option B: Natural"
150
+ description: "[show key differences]"
151
+ - label: "Option C: Artistic"
152
+ description: "[show key differences]"
153
+ ```
154
+
155
+ Show the full prompts in the response text, then ask for selection.
156
+
157
+ ## Step 6: Generate Image
158
+
159
+ Use the midjourney-proxy-mcp MCP tools directly. See `references/imagineapi-integration.md` for details.
160
+
161
+ **Generate:**
162
+ Call the `midjourney_imagine` MCP tool with the optimized prompt:
163
+ - `prompt`: The complete prompt string including all parameters
164
+
165
+ **Check Status:**
166
+ Call the `midjourney_get_status` MCP tool:
167
+ - `image_id`: The ID returned from midjourney_imagine
168
+
169
+ Poll every 10-15 seconds until status is "completed".
170
+
171
+ ## Step 7: Return Results
172
+
173
+ Provide to user:
174
+ 1. Generated image URL
175
+ 2. Upscaled versions (if available in upscaled_urls)
176
+ 3. The prompt used (for user's reference)
177
+ 4. Offer to create variations if needed
178
+
179
+ ---
180
+
181
+ ## Reference Files
182
+
183
+ ### midjourney-parameters.md
184
+ Complete V7 parameter reference. Consult when:
185
+ - Selecting appropriate parameters
186
+ - Explaining parameter effects to user
187
+ - Troubleshooting parameter combinations
188
+
189
+ Search patterns:
190
+ - "Quick Reference Table" - All parameters at a glance
191
+ - "V7-Specific Parameters" - Draft, exp, oref
192
+ - "Reference System" - Style and character references
193
+
194
+ ### midjourney-style-guide.md
195
+ Prompt structure and vocabulary. Consult when:
196
+ - Building prompts from scratch
197
+ - Selecting descriptive vocabulary
198
+ - Checking quality guidelines
199
+
200
+ Search patterns:
201
+ - "5-Layer Prompt Structure" - Building prompts
202
+ - "Descriptive Vocabulary" - Lighting, mood, color terms
203
+ - "Genre-Specific Patterns" - Templates by category
204
+
205
+ ### prompt-examples.md
206
+ Before/after transformations. Consult when:
207
+ - Learning transformation patterns
208
+ - Finding inspiration for specific genres
209
+ - Understanding enhancement techniques
210
+
211
+ Search patterns:
212
+ - "Portrait Photography" - People, characters
213
+ - "Landscape/Environment" - Nature, cities
214
+ - "Product Photography" - Objects, commercial
215
+ - "Character Consistency" - Using references
216
+
217
+ ### imagineapi-integration.md
218
+ MCP tool usage. Consult when:
219
+ - Calling imagine tool
220
+ - Checking generation status
221
+ - Handling errors
222
+
223
+ ---
224
+
225
+ ## Quick Reference
226
+
227
+ ### Minimum Viable Prompt
228
+ ```
229
+ [subject], [style], [lighting], [camera spec] --ar [ratio] --s [value]
230
+ ```
231
+
232
+ ### Full Prompt Template
233
+ ```
234
+ [Subject description], [composition], [style category], [lighting type],
235
+ [mood/atmosphere], shot on [camera] [lens], [color treatment],
236
+ [quality markers] --ar [ratio] --s [value] --q [value]
237
+ ```
238
+
239
+ ### Common Parameter Combos
240
+
241
+ | Purpose | Parameters |
242
+ |---------|------------|
243
+ | Quick test | `--draft` |
244
+ | Standard quality | `--ar 16:9 --s 100` |
245
+ | High quality | `--ar 16:9 --s 150 --q 2` |
246
+ | Artistic | `--s 400 --exp 25` |
247
+ | Character lock | `--oref <url> --ow 200` |
248
+ | Style lock | `--sref <url> --sw 300` |
249
+ | Both locks | `--oref <url> --ow 150 --sref <url> --sw 200` |
250
+
251
+ ---
252
+
253
+ ## Important Notes
254
+
255
+ 1. V7 does not support multi-prompting (`::` syntax)
256
+ 2. Use natural language - V7 understands creative intent
257
+ 3. Keep prompts 20-75 words for best results
258
+ 4. Always append parameters after the descriptive text
259
+ 5. Use --draft for rapid iteration, then enhance winners
260
+ 6. Combine --oref and --sref for maximum consistency