# Routing Matrix

Use this file after mandatory intake has been resolved. Load the universal
execution, run-state and QA policies, then only the relevant branch material.
Every route that creates, previews, QA-checks or renders visual output uses
HyperFrames as the primary composition/runtime path.

| Request shape | Load after foundation files | Mode guidance | Must stop when |
| --- | --- | --- | --- |
| AI News / GitHub repo / tech explainer | Selected channel from `channel-profiles.md`; matching news/tech preset from `presets.md`; `editorial-media.md` for source/proof/media choices; `template-library.md` when an existing set is requested or recommended | Default `auto-run`, respect explicit flags | Factual evidence is missing or a quality-changing fallback is needed |
| AI News with `review-first` | Same AI News branch including `editorial-media.md` | Pause for source/script/evidence review | Review is pending or factual proof is weak |
| Storytelling / personal content | Selected personal channel and story preset only | Default mode unless requested otherwise | Identity/sensitive assumptions cannot be resolved |
| Reference video / remake | Selected channel and format preset; load `editorial-media.md` for underlying-source tracing and non-reuse rules | Suggest `review-first` | Underlying primary source or rights-safe evidence cannot be verified |
| Batch request | `batch-queue.md`; selected channel and relevant preset/editorial/template references per item | Resolve shared intake once, then process linked items sequentially | A linked item needs quality-changing fallback or unsupported evidence |
| Template creation / `/navid-template` | `template-creation.md`; `template-library.md`; `quality-gates.md`; `templates/assets/required-assets.json` | Use template intake, not normal video intake, unless a public video is also requested | Required common assets are missing, three sequences cannot render independently, QA evidence is absent, or promotion lacks explicit approval |

## Vocabulary Compatibility

Accept existing prompt styles such as `AI News`, `Facebook Reels`, `TikTok`,
`YouTube Shorts`, `article-to-video`, URL input, repository input,
`remake/reference`, `batch`, `quiet`, `verbose` and `review-first`.
For reusable template authoring, also accept `navid template create`,
`/navid-template`, `template create`, `save as template`, `approve template`
and Vietnamese equivalents such as `tạo template mới`.

`quick-video-workflow.md` maps older manual invocations to these routes. It is
not a rule authority.

## Governed Template Route

When intake resolves to an existing set or automatic recommendation, read
`template-library.md`, recommend approved sets only, then record the selected
set and rationale with `scripts/run_state.py select-template`. Do not surface
candidate sets as production defaults.

## Dedicated Template Creation Route

When intent is template authoring, read `template-creation.md` before writing
files. Create or update candidate material under `templates/domains/<domain>/candidate/`
and `templates/portable/<set-id>/`; store preview evidence under
`videos/template-library-preview/<set-id>/`. Do not publish npm, reinstall
runtime skills or promote a candidate unless the user explicitly requests that
separate action.

## Delivered Batch Route

For batch intent, create the queue after mandatory intake, keep one approved
template set by default and record any justified approved item override in its
run state. Use `batch_queue.py` to resume valid items safely and write
`SUMMARY.md`; never parallelize production or make blocked fallbacks implicit.