Pre-choice usable artifact execution

Purpose & Output Contractの最小の実成果物をmain contextで作成する。effect別のparse/open・secret・irreversible・corrupt guardだけを実行し、現物path・digest・開き方を提示してからaccept-as-is/light/standard/detailedを記録する。accept-as-isはその場でhandoff完了とし、後続sectionを実行しない。

Post-choice selected improvement execution

以下の既存workflow・goal-seek・評価・修正sectionはlight/standard/detailedが記録されてsemantic_evaluator_startedへ遷移した場合だけ実行する。release/exhaustiveは別の明示eventを必要とする。

run-prompt-create

7 層プロンプトの実物を usable-first で構築する orchestrator。parse/open・secret・破損のP0 guard後に現物を先に提示し、design/elegant/governanceは利用者が選んだ後だけ起動する。

Purpose & Output Contract

ユーザー要望 → 最尤 prompt-brief.json → 7 層プロンプト生成 → P0最小guard → 実artifact提示 → 利用者選択。accept-as-is はevaluator 0 / improver 0。その他の選択時のみ設計評価→パラダイム評価、明示release時のみgovernanceを実行する。

入力: topic (任意), mode ∈ {create, update}, --fast (任意) 出力:

• plugins/<plugin>/skills/<skill>/prompts/<R-id>-<slug>.md (skill-local-v1)
• eval-log/prompt-build-trace.json (schemas/build-trace.schema.json 準拠)
• eval-log/docs/<NN>-<timestamp>.json (schemas/findings.schema.json 準拠)
• eval-log/handoff-<step>.json (schemas/handoff.schema.json 準拠) ×7
• 完了レポート (日本語、パラメーター名のみ英語)

初回handoff完了条件: 実promptとbuild traceが存在し、P0最小guard pass、成果物path/試し方が提示済み。semantic/governance PASSはhandoff前提ではない。

起動モード

• 引数なし: Step 1 (run-prompt-elicit) が起動、対話で topic を確定。
• --fast: new_prompt でなく、diff_lines <= 30 のときのみ design-evaluate / elegant-review を skip。判定:

  python3 plugins/prompt-creator/skills/run-prompt-create/scripts/evaluate-create-gates.py \
    --prompt-name "$PROMPT_NAME" --brief eval-log/prompt-brief.json --fast
  

Key Rules

1. usable-first: briefは依頼から最尤導出し、成果物前の追加質問は行わない。artifact_created → minimal_guard_passed → artifact_presented → user_choice_recorded → semantic_evaluator_started の順を守る。
2. 選択後のみ重いゲート: design/elegantは診断選択後、governanceはrelease選択後のみ。release/exhaustiveを自動昇格しない。
3. 子スキルへの委譲: 各フェーズは独立 Skill を Skill tool で起動 (workflow-manifest.json の delegateSkill)。本スキルは制御のみ。
4. context:fork: evaluator/governance reviewer は必ず context:fork で起動 (Sycophancy 防止)。
5. handoff 保存: 各ゲート通過時に eval-log/handoff-<step>.json を schemas/handoff.schema.json 準拠で残す。
6. resource-map 先読み: references/resource-map.yaml を最初に読み、必要ファイルのみ open。
7. 日本語成果物: 本文・レビュー・完了レポートを日本語に保つ (パラメーター名・JSON キー・CLI 引数は英語)。
8. Markdown 既定: 新規 prompt は prompts/<R-id>-<slug>.md で ../run-prompt-creator-7layer/references/seven-layer-markdown-template.md 写経 (YAML は legacy のみ許容、新規禁止)。
9. Layer 依存方向不変: L7 → L6 → ... → L1。逆方向参照は C2 FAIL。
10. 質ベース判定: 数量カウント (3 つ以上等) を排し「実行可能か」「検証可能か」で判定。doc/prompt-creator/ 由来の核心原則。
11. 要素原子性: 1 フィールド=1 概念、1 値=1 短文 (50 字目安)。長文は分解。
12. 目的+背景併記: 全ルール/制約に「目的」と「背景」を必ず併記する記述スタイル。

End-to-End Flow (概観図。正本は workflow-manifest.json)

[Step 1 infer] 依頼から prompt-brief.json を最尤導出─▶
[Step 2 build]  run-prompt-creator-7layer ─→ prompt-build-trace.json
[Step 3a p0-lint] 最小guard ─▶ [artifact 提示/handoff] ─▶ [利用者choice]
  ├─ accept-as-is → evaluator=0 / improver=0 で完了
  └─ 診断選択 → design-evaluate → elegant-review
                         └─ release明示時だけ governance

ユーザー対話はartifact提示後の診断深度選択だけ。accept-as-isはそのまま試用し、semantic/governanceをhandoffの依存先にしない。

Phase 別ゴールと完了条件 (宣言核)

手順の機械正本は workflow-manifest.json (phases[].dependsOn / entryHook / exitHook / resourceIds / commands / max_retry / fatal_exit_codes / handoff)。本節は各 phase の到達状態と受入条件のみを宣言し、遷移・実行の細部は実行時に manifest とゴールから導出する (手続き列挙の二重管理をしない)。責務別の停止条件は prompts/R1-elicit.md / prompts/R2-gate-review.md / prompts/R3-governance-decide.md の「5.3 完了チェックリスト」(l5-contract v2.0.0)。

phase (step/gate)	ゴール (到達状態)	完了条件 (受入基準)
elicit (1/-)	goals・checklistを含む schema 準拠 brief が依頼から最尤導出され保存済み	成果物前の追加質問0、仮定はtraceに明記
build (2/-)	7 層プロンプトと eval-log/prompt-build-trace.json (build-trace.schema.json 準拠・Layer coverage 全 PASS/N/A/skip 理由付き) が生成済み	trace schema 検証 exit 0 (Gate 2 前提)
p0-lint (3a/G2)	manifest phases[id=p0-lint].commands (9 コマンド、ユニークスクリプト 8 本) が全 exit 0 の状態	全 exit 0。fail / TODO / 未展開 {{...}} / 英語仮文残存 (パラメーター名除く) は findings 付きで build へ差し戻し (最大 3 周)
artifact-present-handoff (3b/delivery)	実promptのpathと試し方が提示済み	semantic/governance非依存でhandoff完了
diagnostic-choice (3c/user)	提示後のchoice receiptがある	accept-as-isはevaluator/improver 0
design-evaluate (4/-)	選択時のみfork evaluatorが C1-C4 を診断	choice前の起動は順序違反
elegant-review (4/G3)	(new_prompt or diff>30 行のみ。判定 scripts/evaluate-create-gates.py) C1-C4 全 PASS	FAIL 残存時のみ停止し修正ループへ
governance (6/-)	releaseが明示選択された場合のみ承認証跡がある	auto release/exhaustive 0
report (3d/-)	usable artifact提示レポートが保存済み	design/elegant/governanceの結果を必須としない

完了レポート形式 (phase=report の出力契約)

# Prompt Creation Report: <prompt_name>
- mode: create|update
- responsibility_id: R<n>
- target_skill: <skill_name>
- delivery_events: [artifact_created, minimal_guard_passed, artifact_presented]
- user_choice: accept-as-is|light|standard|detailed
- release_event / exhaustive_event: user_choiceとは別の明示event (自動昇格なし)
- p0_lint: PASS
- evaluator_result: PASS (or not-run: accept-as-is)
- elegant_review: PASS (or not-run: accept-as-is)
- governance: approved (or not-run: release not selected)
- output_path: <path>
- residual_findings: [<未収束 finding 一覧 / 空配列なら全解消>]
- follow_up_actions: [<利用者choiceで認可された次アクション>]

Gotchas

1. delivery順序 skip 禁止: artifact created/minimal guard/presented/user choice/evaluator startの順序証跡なしにpost-choice phaseへ進めない。
2. 同一 context 評価禁止: evaluator/governance reviewer は必ず context:fork。
3. lint 失敗時の自動修正禁止: 根本原因をユーザー提示。
4. mode=update 時の改名: prompt 名変更は run-skill-rename 相当を経由 (本スキル対象外)。
5. context 予算: SKILL.md / 各 prompt 300 行以下、references/ は Phase 直前で必要分のみ読込。
6. manifest 二重管理禁止: 手書き追加後も lint-manifest-contents.py を必ず通す。

Additional Resources

references/resource-map.yaml を最初に読む。主要参照:

• workflow-manifest.json — Step/Gate/Phase の機械可読定義
• schemas/prompt-brief.schema.json — Step 1→2 渡し正本スキーマ
• schemas/handoff.schema.json — Gate 通過時 handoff 共通形式
• schemas/findings.schema.json — evaluator/elegant-review 出力形式 (C1-C4)
• schemas/build-trace.schema.json — Step 2 emit する Layer 別 coverage 形式
• prompts/R1-elicit.md / prompts/R2-gate-review.md / prompts/R3-governance-decide.md — R1/R2/R3 責務別プロンプト
• 子スキル: run-prompt-elicit, run-prompt-creator-7layer, assign-prompt-design-evaluator, run-elegant-review (harness-creator), run-skill-rubric-governance (harness-creator)