Architecture · Live filesystem view
Living documentation of the canonical production pipeline, creative skills, model routes, and operational constraints behind AI Film Studio.
Last source update Source timestamp unavailable
Definition 1.2
Fourteen ordered production steps, from workspace initialization to the final synchronized render. Each node expands without client-side state.
Step 01
Creates the canonical project workspace, folders, and initial project state.
Step 02
Selects and records the source story before creative generation begins.
Step 03
Writes the final narration used by all downstream audio and visual planning steps.
Step 04
Generates the single fluid master narration audio track.
Step 05
Extracts canonical characters, locations, objects, visual style, and continuity rules.
Step 06
Critically reviews story-bible completeness, fidelity, safety, and continuity.
Step 07
Segments narration into cinematic scenes with adaptive Grid Method panel layouts.
Step 08
Reviews pacing, grid fit, camera arcs, continuity, and audience suitability.
Step 09
Creates stable visual anchors for every production character.
Step 10
Creates stable visual anchors for locations used by the scene plan.
Step 11
Generates one adaptive multi-panel image grid for each planned scene.
Step 12
Extracts individual production panels from approved scene grids.
Step 13
Animates individual panels into duration-bounded video shots.
Step 14
Conforms generated shots to the master voiceover and renders the final film.
Runtime inventory
Only registry-approved production and planned skills contribute to architecture counters. Filesystem discoveries outside the registry remain visible but separate.
ai_film_pipeline
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Network contracts
Documented provider paths, authentication variable names, streaming semantics, and known constraints. Secret values are never rendered.
https://litellm.porpamtech.com/anthropic/v1/messages
Native Anthropic SSE with ping keepalives preserved during thinking mode.
Authentication
Use cases
Provider strategy
Recommended models grouped by production use case, with routes, costs, and dated operational evidence.
claude-sonnet-4-6
Operational evidence
Empirical limits, mitigations, and open infrastructure debt affecting production routes.
Silent long-running requests to litellm.porpamtech.com are cut after approximately 100 seconds.
Evidence
Mitigation
Use LiteLLM Anthropic Passthrough so native SSE ping events keep the connection active.
Filesystem diagnostics
Read-only status of the files used to assemble this architecture snapshot. Missing or partial sources do not prevent static catalog sections from rendering.
loaded
0
missing
16
invalid
0
partial
0
| Source | Path | Status | Message | Modified |
|---|---|---|---|---|
| creative-skills-root | /home/porpam/.hermes/skills/creative | missing | ENOENT: no such file or directory, scandir '/home/porpam/.hermes/skills/creative' |
Source file
SKILL.md not present
Modified
Unknown
channel_profile_manager
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
project_workspace_manager
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
narration_writer
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
voiceover_generator
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
story_bible_extractor
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
story_bible_reviewer
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
scene_planning
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
scene_planning_reviewer
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
character_reference_sheets
version —
Registry placeholder; implementation file not present.
Model chain
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
location_reference_sheets
version —
Registry placeholder; implementation file not present.
Model chain
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
scene_grid_generation
version —
Registry placeholder; implementation file not present.
Model chain
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
panel_extraction
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
video_generation
version —
Registry placeholder; implementation file not present.
Model chain
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
final_render
version —
Registry placeholder; implementation file not present.
Model chain
No model chain extracted.
Primary endpoint
No endpoint extracted
Recognized warning codes
No warning codes extracted.
Parse notes
Source file
SKILL.md not present
Modified
Unknown
| Skill | Version | Status | Description | Primary model | Route |
|---|---|---|---|---|---|
ai_film_pipeline No source file | — | Missing SKILL.md | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
channel_profile_manager No source file | — | Missing SKILL.md | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
project_workspace_manager No source file | — | Missing SKILL.md | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
narration_writer No source file | — | Missing SKILL.md | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
voiceover_generator No source file | — | Missing SKILL.md | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
story_bible_extractor No source file | — | Missing SKILL.md | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
story_bible_reviewer No source file | — | Missing SKILL.md | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
scene_planning No source file | — | Missing SKILL.md | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
scene_planning_reviewer No source file | — | Missing SKILL.md | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
character_reference_sheets No source file | — | Planned · no file | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain
Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file |
location_reference_sheets No source file | — | Planned · no file | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain
Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file |
scene_grid_generation No source file | — | Planned · no file | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain
Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present |
panel_extraction No source file | — | Planned · no file | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
video_generation No source file | — | Planned · no file | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain
Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file |
final_render No source file | — | Planned · no file | Registry placeholder; implementation file not present. | — | — No endpoint DetailsModel chain No model chain extracted. Primary endpoint No endpoint extracted Recognized warning codes No warning codes extracted. Parse notes
Source file SKILL.md not present Modified Unknown |
Constraints
https://cliproxy.porpamtech.com/v1/chat/completions
OpenAI-compatible SSE. Sonnet-4-6 emitted content immediately in the measured Pinocchio test.
Authentication
Use cases
Constraints
https://litellm.porpamtech.com/v1/chat/completions
Unsuitable for long Azure Anthropic thinking-mode payloads because upstream ping events are not preserved.
Authentication
Use cases
Constraints
https://api.x.ai/v1/tts
Non-SSE audio generation response.
Authentication
Use cases
Constraints
https://cliproxy.porpamtech.com/v1/images/generations
Long-running image calls do not currently expose a verified keepalive path.
Authentication
Use cases
Constraints
https://cliproxy.porpamtech.com/v1/video/generations
Expected asynchronous generation and status polling workflow.
Authentication
Use cases
Constraints
TTFT · 2.7s
24.5 KB Pinocchio narration + story-bible payload via CLIproxy OpenAI SSE
gpt-5.5
Available through the multi-provider CLIproxy route
azure-viya-claude-sonnet-5
Completion time · ~171s
24 KB Pinocchio payload via Anthropic Passthrough with SSE pings preserved
azure-viya-claude-opus-4-8
Completion time · ~226s
Large reviewer-style payload via Anthropic Passthrough
gemini-3-flash-agent
Operational session history
gpt-image-2
Architecture W2 provider decision
grok-imagine-video-1.5-preview
Architecture W2 provider decision
azure-viya-claude-fable-5
Configured specialist route
Affected routes
The OpenAI-compatible route does not preserve Azure Anthropic thinking-mode ping events for large payloads.
Evidence
Mitigation
Use /anthropic/v1/messages for Azure Anthropic models.
Affected routes
Sonnet-4-6 emitted structured content quickly for the tested Pinocchio-scale payload.
Evidence
Mitigation
No mitigation recorded; observation remains under monitoring.
Affected routes
The native Codex-authenticated image tool returned token_invalidated during the Phase 2 probe.
Evidence
Mitigation
Re-authenticate the native image provider or standardize generation through the approved production route.
Affected routes
Complex image generation can remain silent long enough to hit the Cloudflare idle timeout.
Evidence
Mitigation
Requires an asynchronous, keepalive-capable, or direct-origin image generation workflow before Phase 2 production use.
Affected routes
Performance observations are initially maintained in the static architecture catalog.
Evidence
Mitigation
Future LOW-priority migration to architecture-observations.json.
| — |
| skill:ai_film_pipeline | /home/porpam/.hermes/skills/creative/ai_film_pipeline/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:channel_profile_manager | /home/porpam/.hermes/skills/creative/channel_profile_manager/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:project_workspace_manager | /home/porpam/.hermes/skills/creative/project_workspace_manager/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:narration_writer | /home/porpam/.hermes/skills/creative/narration_writer/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:voiceover_generator | /home/porpam/.hermes/skills/creative/voiceover_generator/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:story_bible_extractor | /home/porpam/.hermes/skills/creative/story_bible_extractor/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:story_bible_reviewer | /home/porpam/.hermes/skills/creative/story_bible_reviewer/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:scene_planning | /home/porpam/.hermes/skills/creative/scene_planning/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:scene_planning_reviewer | /home/porpam/.hermes/skills/creative/scene_planning_reviewer/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:character_reference_sheets | /home/porpam/.hermes/skills/creative/character_reference_sheets/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:location_reference_sheets | /home/porpam/.hermes/skills/creative/location_reference_sheets/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:scene_grid_generation | /home/porpam/.hermes/skills/creative/scene_grid_generation/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:panel_extraction | /home/porpam/.hermes/skills/creative/panel_extraction/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:video_generation | /home/porpam/.hermes/skills/creative/video_generation/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
| skill:final_render | /home/porpam/.hermes/skills/creative/final_render/SKILL.md | missing | No SKILL.md file was found for this registry entry. | — |
SKILL.md not present
Modified
Unknown
SKILL.md not present
Modified
Unknown
Modified
Unknown
SKILL.md not present
Modified
Unknown