videonut 1.0.1 → 1.1.0

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 (79) hide show
  1. package/.antigravity/config.toml +8 -0
  2. package/.claude/commands/archivist.toml +12 -0
  3. package/.claude/commands/director.toml +12 -0
  4. package/.claude/commands/eic.toml +12 -0
  5. package/.claude/commands/investigator.toml +12 -0
  6. package/.claude/commands/prompt.toml +12 -0
  7. package/.claude/commands/scavenger.toml +12 -0
  8. package/.claude/commands/scout.toml +12 -0
  9. package/.claude/commands/scriptwriter.toml +12 -0
  10. package/.claude/commands/seo.toml +12 -0
  11. package/.claude/commands/thumbnail.toml +12 -0
  12. package/.claude/commands/topic_scout.toml +12 -0
  13. package/.gemini/commands/archivist.toml +12 -0
  14. package/.gemini/commands/director.toml +12 -0
  15. package/.gemini/commands/eic.toml +12 -0
  16. package/.gemini/commands/investigator.toml +12 -0
  17. package/.gemini/commands/prompt.toml +12 -0
  18. package/.gemini/commands/scavenger.toml +12 -0
  19. package/.gemini/commands/scout.toml +12 -0
  20. package/.gemini/commands/scriptwriter.toml +12 -0
  21. package/.gemini/commands/seo.toml +12 -0
  22. package/.gemini/commands/thumbnail.toml +12 -0
  23. package/.gemini/commands/topic_scout.toml +12 -0
  24. package/.qwen/commands/archivist.toml +12 -0
  25. package/.qwen/commands/director.toml +12 -0
  26. package/.qwen/commands/eic.toml +12 -0
  27. package/.qwen/commands/investigator.toml +12 -0
  28. package/.qwen/commands/prompt.toml +12 -0
  29. package/.qwen/commands/scavenger.toml +12 -0
  30. package/.qwen/commands/scout.toml +12 -0
  31. package/.qwen/commands/scriptwriter.toml +12 -0
  32. package/.qwen/commands/seo.toml +12 -0
  33. package/.qwen/commands/thumbnail.toml +12 -0
  34. package/.qwen/commands/topic_scout.toml +12 -0
  35. package/USER_GUIDE.md +90 -0
  36. package/agents/core/eic.md +772 -0
  37. package/agents/core/prompt_agent.md +264 -0
  38. package/agents/core/self_review_protocol.md +143 -0
  39. package/agents/creative/director.md +247 -0
  40. package/agents/creative/scriptwriter.md +208 -0
  41. package/agents/creative/seo.md +316 -0
  42. package/agents/creative/thumbnail.md +285 -0
  43. package/agents/research/investigator.md +395 -0
  44. package/agents/research/topic_scout.md +419 -0
  45. package/agents/technical/archivist.md +289 -0
  46. package/agents/technical/scavenger.md +248 -0
  47. package/bin/videonut.js +389 -107
  48. package/config.yaml +62 -0
  49. package/docs/AUDIT_REPORT.md +364 -0
  50. package/docs/LIFECYCLE.md +651 -0
  51. package/docs/scriptwriter.md +43 -0
  52. package/file_validator.py +187 -0
  53. package/memory/short_term/asset_manifest.md +64 -0
  54. package/memory/short_term/investigation_dossier.md +31 -0
  55. package/memory/short_term/master_script.md +51 -0
  56. package/package.json +16 -3
  57. package/requirements.txt +9 -0
  58. package/scripts/setup.js +8 -0
  59. package/tools/check_env.py +77 -0
  60. package/tools/downloaders/__pycache__/caption_reader.cpython-312.pyc +0 -0
  61. package/tools/downloaders/__pycache__/image_grabber.cpython-312.pyc +0 -0
  62. package/tools/downloaders/__pycache__/pdf_reader.cpython-312.pyc +0 -0
  63. package/tools/downloaders/__pycache__/screenshotter.cpython-312.pyc +0 -0
  64. package/tools/downloaders/__pycache__/web_reader.cpython-312.pyc +0 -0
  65. package/tools/downloaders/article_screenshotter.py +388 -0
  66. package/tools/downloaders/caption_reader.py +238 -0
  67. package/tools/downloaders/clip_grabber.py +83 -0
  68. package/tools/downloaders/image_grabber.py +106 -0
  69. package/tools/downloaders/pdf_reader.py +163 -0
  70. package/tools/downloaders/pdf_screenshotter.py +240 -0
  71. package/tools/downloaders/screenshotter.py +58 -0
  72. package/tools/downloaders/web_reader.py +69 -0
  73. package/tools/downloaders/youtube_search.py +174 -0
  74. package/tools/logging/search_logger.py +334 -0
  75. package/tools/validators/__pycache__/archive_url.cpython-312.pyc +0 -0
  76. package/tools/validators/__pycache__/link_checker.cpython-312.pyc +0 -0
  77. package/tools/validators/archive_url.py +269 -0
  78. package/tools/validators/link_checker.py +45 -0
  79. package/workflow_orchestrator.py +337 -0
@@ -0,0 +1,8 @@
1
+ # Anti-Gravity Configuration
2
+ # Maps B-MAD Agents to Cursor/Anti-Gravity Rules
3
+
4
+ [rules]
5
+ investigate = ".gemini/commands/bmad-agent-research-investigator.toml"
6
+ direct = ".gemini/commands/bmad-agent-creative-director.toml"
7
+ scavenge = ".gemini/commands/bmad-agent-technical-scavenger.toml"
8
+ review = ".gemini/commands/bmad-agent-core-eic.toml"
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: archivist - The Archivist (Vault)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/technical/archivist.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: director - The Director (Spielberg)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/director.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: eic - The Editor-in-Chief (Chief)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/core/eic.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: investigator - The Investigator (Sherlock)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/research/investigator.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: prompt_agent - The Prompt Agent (Catalyst)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/core/prompt_agent.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: scavenger - The Scavenger (Hunter)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/technical/scavenger.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: scout - Alias for Topic Scout"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: scriptwriter - The Scriptwriter (Sorkin)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/scriptwriter.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: seo - The SEO Optimizer (Ranker)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/seo.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: thumbnail - The Thumbnail Designer (Canvas)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/thumbnail.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: topic_scout - The Topic Scout (Scout)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "The Archivist"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/technical/archivist.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "The Director"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/director.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "The Editor-in-Chief"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/core/eic.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "The Investigator"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/research/investigator.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: prompt_agent - The Prompt Agent (Catalyst)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/core/prompt_agent.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "The Scavenger"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/technical/scavenger.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "Alias for Topic Scout - Find trending topics"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: scriptwriter - The Scriptwriter (Sorkin)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/scriptwriter.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "The SEO Optimizer"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/seo.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "The Thumbnail Designer"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/thumbnail.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "The Topic Scout - Find trending topics and create projects"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: archivist - The Archivist (Vault)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/technical/archivist.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: director - The Director (Spielberg)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/director.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: eic - The Editor-in-Chief (Chief)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/core/eic.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: investigator - The Investigator (Sherlock)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/research/investigator.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: prompt_agent - The Prompt Agent (Catalyst)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/core/prompt_agent.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: scavenger - The Scavenger (Hunter)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/technical/scavenger.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: scout - Alias for Topic Scout"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: scriptwriter - The Scriptwriter (Sorkin)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/scriptwriter.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: seo - The SEO Optimizer (Ranker)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/seo.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: thumbnail - The Thumbnail Designer (Canvas)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/creative/thumbnail.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
@@ -0,0 +1,12 @@
1
+ description = "VideoNut Agent: topic_scout - The Topic Scout (Scout)"
2
+ prompt = """
3
+ You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
4
+
5
+ <agent-activation CRITICAL="TRUE">
6
+ 1. LOAD the FULL agent file from @_video_nut/agents/research/topic_scout.md
7
+ 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
8
+ 3. Execute ALL activation steps exactly as written in the agent file
9
+ 4. Follow the agent's persona and menu system precisely
10
+ 5. Stay in character throughout the session
11
+ </agent-activation>
12
+ """
package/USER_GUIDE.md ADDED
@@ -0,0 +1,90 @@
1
+ # The VideoNut Video Production Agency: User Guide
2
+
3
+ Welcome to your AI-powered production studio. This system transforms a simple idea into a fully researched, scripted, and asset-ready video project using five specialized AI agents.
4
+
5
+ This guide walks you through the entire lifecycle using a real-world example: **"The Irony of OpenAI using Google's Transformer."**
6
+
7
+ ---
8
+
9
+ ## 🎭 The Cast (Your AI Team)
10
+
11
+ 1. **🕵️ The Investigator:** Research & Facts. (Finds the story).
12
+ 2. **✍️ The Scriptwriter:** Narrative & Emotion. (Writes the words).
13
+ 3. **🎬 The Director:** Vision & Sourcing. (Visualizes the story).
14
+ 4. **🦅 The Scavenger:** Asset Hunting. (Finds the clips/images).
15
+ 5. **💾 The Archivist:** Asset Storage. (Downloads the files).
16
+ 6. **🧐 The Editor-in-Chief (EIC):** Quality Control. (Validates everything).
17
+
18
+ ---
19
+
20
+ ## 🚀 The Workflow: From Zero to Hero
21
+
22
+ ### Step 1: The Brief (Investigator)
23
+ ...
24
+
25
+ ### Step 2: The Soul (Scriptwriter)
26
+ **Goal:** Turn the dry dossier into a human "Narrative Script."
27
+
28
+ 1. **Type:** `/scriptwriter`
29
+ 2. **Agent Action:** Sorkin reads the `truth_dossier.md`. He crafts the hook, ensures the 360-degree perspective, and writes the emotional narration.
30
+ 3. **Result:** A file is created at `_output/narrative_script.md`.
31
+
32
+ ### Step 3: The Vision (Director)
33
+ **Goal:** Turn the narration into a cinematic "Master Script" with visual links.
34
+
35
+ 1. **Type:** `/director`
36
+ 2. **Agent Action:** Spielberg reads the `narrative_script.md`. He designs shots for every paragraph and finds the specific source URLs for the evidence.
37
+ 3. **Result:** A file is created at `_output/master_script.md`.
38
+
39
+ ---
40
+
41
+ ### Step 3: The Quality Check (Editor-in-Chief)
42
+ **Goal:** Ensure the script is accurate and entertaining before hunting for assets.
43
+
44
+ 1. **Type:** `/eic`
45
+ 2. **Agent Says:** "The desk is clear, Producer. Chief here."
46
+ 3. **You Select:** `[RV] Review Project Status` (Type `RV` or `2`).
47
+ 4. **Agent Action:** The Chief reads both the Dossier and the Script. He checks:
48
+ * **Fact Check:** Is the 2017 date correct?
49
+ * **Narrative Check:** Is the hook boring?
50
+ 5. **Result:** He gives you a Pass/Fail report.
51
+ * *If Fail:* You go back to `/director` and ask for edits.
52
+ * *If Pass:* You proceed to Step 4.
53
+ 6. **Next:** Dismiss the agent with `DA`.
54
+
55
+ ---
56
+
57
+ ### Step 4: The Hunt (Scavenger)
58
+ **Goal:** Find real URLs for every visual described in the script.
59
+
60
+ 1. **Type:** `/scavenger`
61
+ 2. **Agent Says:** "Eyes in the sky... Hunter online."
62
+ 3. **You Select:** `[FA] Find Assets` (Type `FA` or `2`).
63
+ 4. **Agent Action:** Hunter reads the `master_script.md`. For every "Visual" line, he searches YouTube, Google Images, or Twitter.
64
+ * *Script:* "Show the 'Attention Is All You Need' paper abstract."
65
+ * *Hunter:* Finds the arXiv PDF link or a screenshot URL.
66
+ 5. **Result:** A file is created at `_output/asset_manifest.md` containing a list of links.
67
+ 6. **Next:** Dismiss the agent with `DA`.
68
+
69
+ ---
70
+
71
+ ### Step 5: The Heist (Archivist)
72
+ **Goal:** Download all the files to your hard drive.
73
+
74
+ 1. **Type:** `/archivist`
75
+ 2. **Agent Says:** "Vault online."
76
+ 3. **You Select:** `[DL] Download Assets` (Type `DL` or `2`).
77
+ 4. **Agent Action:** Vault reads the `asset_manifest.md`. He uses tools (like `yt-dlp` or `wget`) to physically download the images and videos.
78
+ 5. **Result:** Your assets appear in `_output/raw_assets/` organized by scene.
79
+ 6. **Next:** Dismiss the agent with `DA`.
80
+
81
+ ---
82
+
83
+ ## 🎉 Conclusion
84
+
85
+ You now have:
86
+ 1. A researched Dossier.
87
+ 2. A cinematic Script.
88
+ 3. A folder full of Video/Image assets.
89
+
90
+ **You are ready to edit!** Open your video editor (Premiere, Davinci) and drag in the files.