agentleFS
mocchaleramocchalera/video-os-v2/.agents/skills/build-blueprint/SKILL.md

build-blueprint

Skill4 starsChanged 2 months agoMITView on GitHub

Use when selects_candidates.yaml exists and the user asks to design structure, build an edit blueprint, or create 04_plan/edit_blueprint.yaml.

The file

Files
SKILL.md

build-blueprint

いつ使うか

  • 「構成を設計して」「ブループリントを作って」と言われたとき。
  • 04_plan/selects_candidates.yaml があり、rough cut 前の設計を固めるとき。

前提条件

  • schemas/edit-blueprint.schema.json と schemas/uncertainty-register.schema.json を守ること。
  • runtime/commands/blueprint.ts の narrative loop に従うこと。 frame → read → draft → evaluate → confirm → promote
  • 入力は creative_brief.yaml, unresolved_blockers.yaml, selects_candidates.yaml, 任意で STYLE.md。
  • 04_plan/edit_blueprint.yaml は authoring intent、05_timeline/timeline.json は compiled canonical truth とする。 caption text/timing/approval は caption review/finalize と FFmpeg/libass speech route が所有し、 Remotion/HyperFrames は登録済み content element だけを描画する。visual treatment patch、platform profile、SFX rights、shared AudioRenderPlan、agent QA、human approval、platform preview は別の契約とする。

やること(ステップ)

  1. brief の autonomy を見て、full か collaborative かを決める。
  2. 04_plan/edit_blueprint.yaml を作る。 必須の核は sequence_goals, beats, pacing, music_policy, dialogue_policy, transition_policy, ending_policy, rejection_rules。
  3. beats[].target_duration_frames と required_roles を明確にし、候補素材との対応が読めるようにする。
  4. 必要なら caption_policy, timeline_order, duration_policy, quality_targets, trim_policy, active_editing_skills も書く。
  5. 04_plan/uncertainty_register.yaml を作る。 各 uncertainty は id, type, question, status, evidence, alternatives, escalation_required を持つ。
  6. collaborative の場合は beat proposal と pacing を readback し、pacing.confirmed_preferences を入れる。
  7. speech-led / interview では promotion 前に first-pass quality audit を行う。
    • 各 dialogue primary は質問テロップなしでも主語または指示対象、比較の両側、原因と結果、結論が範囲内で回収できる
    • 推薦・受講推奨・CTA は単独で置かず、直前または同じ回答に理由、判断問題、具体的な不利益のいずれかを残す
    • dialogue_policy.cut_tail_hold_sec と cut_audio_fade_out_sec は project の timing policy/profile から解決する
    • ending_policy は完全な最終発言後の動く元素材を policy が要求する tail だけ残し、音声と映像をフェードする。静止フレームで終端を延ばさない
    • 字幕は speech caption 1レイヤーとし、質問・章ラベルに発話本文を重複させない audit に失敗した場合は、尺を優先して通さず、完全な fallback の昇格または候補範囲の再選択を行う。
  8. 明示的な短尺SNS delivery profile では retention audit も行う。
    • hook_priority: aggressive または brief がコールドオープンを要求する場合、最強の実在payoff/reactionを profile が定める opening window だけ先出しし、setupへ戻って完全版を configured start window 内に開始する
    • 同じ素材へ意図的に戻る場合は別source rangeを優先し、必要なら allow_revisit にcallback理由を残す
    • beat.id / beat.label は構造用、画面表示文言は beat.viewer_label に視聴者の言葉で書く。HOOK / LEVEL 1 / PAYOFF / ENDING を brief 指定なしに画面へ出さない
    • talking-head / low-motion素材では policy が定める refresh interval ごとの意味的な転換点に、実在リアクション、 登録済みreframe/punch-in、登録済み強調overlayのいずれかを計画する。無意味なzoomやflashで埋めない
    • credibility_first / 高い信用優先では断片的なspoilerを強制せず、根拠を伴う完全な主張をhookにする
    • このauditは短尺SNS以外へ適用しない
  9. brief がBGMを要求する場合だけ、music_policy にレビュー済みライブラリ/BGM Packからの選曲を明記する。 利用可能な候補がなければ uncertainty_register.yaml に blocker を作り、通常BGMを案件内生成して仮置きしない。 短い単純音を明示的に求める場合だけ usage_class: simple_sound を例外として扱う。

出力 artifact

  • 04_plan/edit_blueprint.yaml
  • 04_plan/uncertainty_register.yaml

注意事項

  • uncertainty_register.yaml の status: blocker は planning 上の blocker。compile gate の hard stop は unresolved_blockers.yaml 側で管理される。
  • beat の role は hero, support, transition, texture, dialogue の enum に合わせる。
  • timeline_order を省略した場合は schema default は editorial。chronological にしたいときだけ明示する。
  • speech-led の first-pass quality audit はユーザーレビューの代替ではなく、明白な意味欠落と終端事故を人間へ出す前に自動修復するための必須ゲートとする。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.