{ "version": "6.1.3", "title": "Apex AI-Editor VIP Notes — Permanent Memory (expert-editor-logic integrated)", "source_spec": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/Qwen-expert-Ai-editor.md", "expert_logic": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/expert-editor-logic.md", "skill": "/Users/khaledahmedmohamed/.agents/skills/apex-ai-editor/SKILL.md", "pro_tips_md": "/Users/khaledahmedmohamed/.gemini/config/permanent_memory/apex_editor_vip_pro_tips.md", "updated": "2026-07-17T10:27:38.165783+00:00", "scope": "permanent", "deploy_targets": [ "agy", "grok", "gocode", "claude", "openclaw", "zeroclaw", "mac", "servers" ], "auto_activate_on": [ "/apex-editor", "ai", "and", "animation", "apex", "apex-ai-editor", "audio", "auto", "auto-detect", "b-roll", "blur", "brain", "broll", "burns", "capcut", "caption", "captions", "clip", "clips", "cognitive", "color", "compose", "content", "create", "creation", "creative", "critique", "crossfade", "cut", "cuts", "design", "detect", "dynamic", "ebu", "edit", "editing", "editor", "editorial", "edits", "effects", "exif", "export", "extract", "face", "faceless", "ffmpeg", "ffprobe", "film", "frame", "gate", "generate", "generation", "grade", "grading", "grain", "hard", "image", "images", "j-cut", "judge", "jump", "ken", "leak", "light", "loudnorm", "make", "match", "media", "metadata", "montage", "motion", "mp4", "orchestrator", "pan", "photo", "pipeline", "png", "produce", "qa", "quality", "r128", "ramp", "reel", "render", "seed", "short", "slideshow", "speed", "storyboard", "subtitle", "sync", "theme", "thumbnail", "transition", "trim", "video", "videos", "visual", "visuals", "vlm", "voiceover", "whip" ], "directives": [ "VFR: always -framerate 30 on image inputs", "A/V: apad + -shortest; drift < 0.5s; final audio -ar 48000", "EBU R128 loudness: loudnorm=I=-14:LRA=11:TP=-1 after mux (PILLAR 15.4)", "Never claim done without master_qa_gate / final_gate PASS", "Hybrid perception: eyes for meaning, scripts for numbers only", "Never write Python only to describe an image", "Cloud vision free-first; never block pipeline on cloud fail", "H.264 delivery default; face blur when faces present", "Modes: --mode ad (5) or narrative (7); --ai-clips; --pdf-ingest", "PASS|FAIL|INCONCLUSIVE — never promote INCONCLUSIVE to done", "StateEngine checkpoints; max 3 re-render attempts", "PILLAR 12: visual_judge.py on every clip/final → FAILED|PROPER|EXCELLENT (5 axes)", "PILLAR 13: Brain orchestrator 3-pass review + intent brief before sub-agents", "PILLAR 14: Check theme_seeds.json BEFORE style; auto-capture EXCELLENT recipes", "PILLAR 15: VLM semantic critique (brief adherence/emotion) after pixel pass", "5th Deadly Sin: Blind Acceptance — never accept 'looks fine' without structured verdict", "Auto-detect media metadata with ffprobe (duration, codec, fps, audio, size) before edit", "Auto-detect image EXIF/XMP/IPTC when present; never invent durations/sizes" ], "four_deadly_sins": { "vfr": "-framerate 30", "av_drift": "apad+shortest -ar 48000", "context_decay": "state.json checkpoints", "false_positive": "5-tier QA + final_gate", "blind_acceptance": "visual_judge + VLM structured verdict REQUIRED" }, "cognitive_loop": [ "PERCEIVE — eyes + perceive metrics + auto-detect metadata (ffprobe/EXIF)", "INTERPRET — theme_seeds suggest → color/style; map beats ad(5)/narrative(7)", "COMPOSE — Ken Burns + transitions per beat", "REALIZE — render clips → visual_judge each → stitch → apad+shortest → loudnorm EBU R128", "CRITIQUE — 5-tier QA + visual_judge final + VLM semantic; EXCELLENT→save seed; FAILED→axis fix max 2" ], "pillars_12_15": { "12_visual_judge": "visual_judge.py → FAILED|PROPER|EXCELLENT", "13_brain": "brain_orchestrator.md 3-pass + intent brief", "14_theme_seeds": "theme_seeds before style; capture EXCELLENT", "15_vlm_loudnorm": "vlm_critique.py + EBU R128 loudnorm=I=-14:LRA=11:TP=-1" }, "pro_tips": [ "VFR: -framerate 30 on still-image inputs", "A/V: apad+shortest; -ar 48000; drift < 0.5s", "Dynamic captions word-by-word = highest short-form impact", "Hard cut ~90% of edits; transitions only when story needs them", "Hook cut every 1–2s first 3s; listicle: new visual every fact", "visual_judge 5 axes → FAILED/PROPER/EXCELLENT; block done on FAILED", "Brain orchestrator 3-pass: intent brief → sub-agents → editorial review", "Theme seeds: reuse EXCELLENT recipes before inventing style", "VLM critique free-first; offline → PROPER+skipped never crash", "EBU R128 loudnorm I=-14:LRA=11:TP=-1 after mux", "Never invent metadata; probe or mark INCONCLUSIVE", "Max 3 re-render attempts; checkpoint after every stage", "H.264 social default; face blur when privacy requires", "Load expert-editor-logic + brain_orchestrator + expert_tips + effects and edits + visual_judge + vlm_critique" ], "metadata_auto_detect": { "enabled": true, "video_audio": "ffprobe -show_format -show_streams (duration, codec, fps, sample_rate, channels, bitrate, size)", "images": "EXIF/XMP/IPTC when present; never invent dimensions/duration", "rule": "Before any edit/trim/render: probe inputs. Cache probe JSON next to asset. Auto-catch keywords include metadata/exif/ffprobe.", "on_missing": "INCONCLUSIVE for duration-based claims until probed" }, "auto_catch": { "enabled": true, "rule": "If ANY trigger appears in user prompt (case-insensitive substring), load apex-ai-editor skill + permanent JSON + VIP pro-tips + expert pillars BEFORE acting. Auto-detect media metadata on load.", "triggers": [ "/apex-editor", "ai editor", "animation", "apex editor", "apex-ai-editor", "audio sync", "auto detect", "auto-detect", "b-roll", "blur face", "brain orchestrator", "broll", "capcut", "caption", "clip", "clips", "cognitive editor", "color grade", "color grading", "compose", "content", "content creation", "create content", "create video", "creative", "crossfade", "cut", "design video", "ebu r128", "edit", "editing", "editor", "editorial quality", "exif", "exiff", "export", "face blur", "faceless", "ffmpeg", "ffprobe", "frame extract", "generate image", "generate images", "generate video", "image", "image generation", "images", "iptc", "jpeg", "jpg", "ken burns", "kenburns", "loudness", "loudnorm", "make image", "make video", "media", "media pipeline", "metadata", "montage", "motion", "mov", "mp4", "photo", "photo edit", "photos", "pipeline", "pipeline.py", "png", "produce content", "qa gate", "reel", "render", "render video", "short", "slideshow", "splice", "stitch", "storyboard", "subtitle", "theme seed", "theme seeds", "thumbnail", "transition", "trim", "video", "video edit", "video generation", "videos", "visual", "visual judge", "visual quality", "visuals", "vlm critique", "voice over", "voiceover", "watermark remove", "webm", "webp", "xmp" ], "priority": "high", "also_load": [ "/Users/khaledahmedmohamed/.agents/skills/apex-ai-editor/SKILL.md", "/Users/khaledahmedmohamed/.gemini/config/permanent_memory/apex_editor_vip_pro_tips.md", "/Users/khaledahmedmohamed/.gemini/config/permanent_memory/apex_editor_system_prompt_snippet.md", "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/expert-editor-logic.md" ] }, "scripts": { "visual_judge": "/Users/khaledahmedmohamed/.agents/skills/apex-ai-editor/references/visual_judge.py", "theme_seed_tracker": "/Users/khaledahmedmohamed/.agents/skills/apex-ai-editor/references/theme_seed_tracker.py", "brain_orchestrator": "/Users/khaledahmedmohamed/.agents/skills/apex-ai-editor/references/brain_orchestrator.md" }, "expert_inventory": { "source": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/expert-editor-logic.md", "lines": 848, "sections_25": 25, "code_blocks_42": 42, "pillars": [ "12_visual_judge", "13_brain_orchestrator", "14_theme_seed_tracker", "15_vlm_semantic_critique_ebu_r128" ], "production_scripts": [ "visual_judge.py", "theme_seed_tracker.py", "vlm_critique.py" ], "master_merged": true, "fifth_deadly_sin": "Blind Acceptance", "master_version": "v6.1" }, "expert_folder": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor", "expert_files": { "master_spec": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/Qwen-expert-Ai-editor.md", "expert_editor_logic": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/expert-editor-logic.md", "brain_orchestrator": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/brain_orchestrator.md", "expert_tips": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/expert_tips.md", "opus_upgrades": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/opus upgrades apex editor.md", "effects_and_edits": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/effects and edits.md", "updates_apex_agent": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/Updates to editor Qwen Apex Ai-agent.md", "visual_judge_py": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/visual_judge.py", "vlm_critique_py": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/vlm_critique.py", "theme_seed_tracker_py": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/theme_seed_tracker.py", "merged_judge_seedbank": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor/Merged_AI_Visual_Judge_Orchestrator_SeedBank_v2.md", "folder": "/Users/khaledahmedmohamed/designs-content/vip/ai-agent editor" }, "skill_functions": { "boot_check": "Load skill + permanent JSON + pro-tips BEFORE any edit/render", "perceive": "Hybrid perception: native vision for meaning; scripts only for numeric metrics", "metadata_detect": "ffprobe format+streams; image EXIF/XMP/IPTC; never invent duration/size", "vfr_guard": "Always -framerate 30 on image inputs", "av_sync": "apad + -shortest; final audio -ar 48000; drift < 0.5s", "visual_judge": "Run visual_judge.py → FAILED|PROPER|EXCELLENT; block done on FAILED", "brain_orchestrate": "3-pass brain orchestrator + intent brief (brain_orchestrator.md)", "theme_seeds": "Check theme_seeds before style; capture EXCELLENT recipes", "vlm_critique": "vlm_critique.py after pixel pass; free-first cascade", "loudnorm": "EBU R128 loudnorm=I=-14:LRA=11:TP=-1 after mux", "state_checkpoints": "StateEngine after every stage; max 3 re-render attempts", "qa_gate": "5-tier QA + final_gate; never promote INCONCLUSIVE", "effects_kit": "effects and edits.md: hard cut ~90%; tone-matched effects; cut rhythm by type", "faceless_rules": "NO EYES/NO FACE FEATURES when faceless brand content", "modes": "--mode ad (5) or narrative (7); --ai-clips before Ken Burns" }, "clean_code_rules": [ "No Python solely to describe images (use native vision)", "Scripts only for numbers: duration, fps, loudness, hashes", "Never invent ffprobe/EXIF fields — probe or INCONCLUSIVE", "Prefer fewest files; edit in place", "visual_judge + final_gate before claiming done", "State checkpoints; max 3 re-renders" ] }