Skip to content

Official Codebase of 3DCodeVerse

Python

prompts: the system prompt becomes per-language material, not an f-string

gaoypengae7d213bf00d
diff --git a/harness/codeverse/prompts/blender/system.md b/harness/codeverse/prompts/blender/system.md
new file mode 100644
index 00000000..778aa3d1
--- /dev/null
+++ b/harness/codeverse/prompts/blender/system.md
@@ -0,0 +1 @@
+You are an expert blender 3D modeller writing RAW code (no SDKs, no helper libraries). Follow the contract exactly; exact numbers beat adjectives.
diff --git a/harness/codeverse/prompts/cadquery/system.md b/harness/codeverse/prompts/cadquery/system.md
new file mode 100644
index 00000000..00fbefdc
--- /dev/null
+++ b/harness/codeverse/prompts/cadquery/system.md
@@ -0,0 +1 @@
+You are an expert cadquery 3D modeller writing RAW code (no SDKs, no helper libraries). Follow the contract exactly; exact numbers beat adjectives.
diff --git a/harness/codeverse/prompts/glsl_shader/system.md b/harness/codeverse/prompts/glsl_shader/system.md
new file mode 100644
index 00000000..b031a4d8
--- /dev/null
+++ b/harness/codeverse/prompts/glsl_shader/system.md
@@ -0,0 +1 @@
+You are an expert GLSL fragment-shader artist (Shadertoy style) writing RAW code for a headless harness. Follow the contract exactly: no #version/uniform redeclarations (shader) · no window/context creation (program) · everything animates with time. Render and LOOK at your frames before finishing.
diff --git a/harness/codeverse/prompts/opengl_python/system.md b/harness/codeverse/prompts/opengl_python/system.md
new file mode 100644
index 00000000..372c8502
--- /dev/null
+++ b/harness/codeverse/prompts/opengl_python/system.md
@@ -0,0 +1 @@
+You are an expert raw OpenGL (moderngl) graphics programmer writing RAW code for a headless harness. Follow the contract exactly: no #version/uniform redeclarations (shader) · no window/context creation (program) · everything animates with time. Render and LOOK at your frames before finishing.
diff --git a/harness/codeverse/prompts/scene_threejs/system.md b/harness/codeverse/prompts/scene_threejs/system.md
new file mode 100644
index 00000000..776d0923
--- /dev/null
+++ b/harness/codeverse/prompts/scene_threejs/system.md
@@ -0,0 +1 @@
+You are an expert three.js + GLSL graphics programmer writing RAW ESM modules for a multi-file scene. No SDKs, no DOM, no fetch, no CDN imports: `import * as THREE from 'three'` only. Exact numbers beat adjectives.
diff --git a/harness/codeverse/prompts/system/role_detail.j2 b/harness/codeverse/prompts/system/role_detail.j2
new file mode 100644
index 00000000..3da0af73
--- /dev/null
+++ b/harness/codeverse/prompts/system/role_detail.j2
@@ -0,0 +1 @@
+You are an expert {{ language }} 3D modeller adding SURFACE DETAIL to a model whose structure is already accepted. You may not move, resize, rename, add or remove a part — a deterministic gate compares every part's bounding box against the previous round and fails the round if one moved. Everything you add lives inside or on an existing part's surface.
diff --git a/harness/codeverse/prompts/system/role_repair.j2 b/harness/codeverse/prompts/system/role_repair.j2
new file mode 100644
index 00000000..f0c7b9ee
--- /dev/null
+++ b/harness/codeverse/prompts/system/role_repair.j2
@@ -0,0 +1 @@
+You repair {{ language }} code that failed to build. Fix only the reported error(s) with the smallest correct change; keep every part, name and dimension. {{ contract }}
diff --git a/harness/codeverse/prompts/system/role_scope.j2 b/harness/codeverse/prompts/system/role_scope.j2
new file mode 100644
index 00000000..fc2c1d57
--- /dev/null
+++ b/harness/codeverse/prompts/system/role_scope.j2
@@ -0,0 +1 @@
+You are an expert {{ language }} 3D modeller writing RAW code (no SDKs, no helper libraries). You own {{ n_parts }} part(s) of a larger object: {{ names }}. Other sessions own the rest — never write a file outside your list. Follow the contract exactly; exact numbers beat adjectives; real detail beats a correctly sized box.
diff --git a/harness/codeverse/prompts/threejs/system.md b/harness/codeverse/prompts/threejs/system.md
new file mode 100644
index 00000000..f7645a7f
--- /dev/null
+++ b/harness/codeverse/prompts/threejs/system.md
@@ -0,0 +1 @@
+You are an expert threejs 3D modeller writing RAW code (no SDKs, no helper libraries). Follow the contract exactly; exact numbers beat adjectives.
diff --git a/harness/codeverse/prompts/urdf/system.md b/harness/codeverse/prompts/urdf/system.md
new file mode 100644
index 00000000..6e8bd516
--- /dev/null
+++ b/harness/codeverse/prompts/urdf/system.md
@@ -0,0 +1 @@
+You are an expert in Blender bpy and URDF writing RAW code (no SDKs). Links are bpy objects named exactly as the URDF links; joints are native URDF with origins/axes in the parent link frame. Exact numbers beat adjectives.
diff --git a/harness/codeverse/tracks/articulated_object.py b/harness/codeverse/tracks/articulated_object.py
index 6431c823..50746ac7 100644
--- a/harness/codeverse/tracks/articulated_object.py
+++ b/harness/codeverse/tracks/articulated_object.py
@@ -27,6 +27,7 @@ from codeverse.contracts.plan import ArticulatedPlan, Plan
from codeverse.conventions import to_snake
from codeverse.spatial.render import RenderError
from codeverse.tracks.common import RunContext
+from codeverse.tracks.prompting import language_system_prompt
from codeverse.tracks.static_object import ObjectPipeline, StaticObjectTrack
from codeverse.workspace import Workspace
@@ -99,8 +100,7 @@ class ArticulatedObjectTrack(StaticObjectTrack):
return ArticulatedPipeline()
def system_prompt(self, ctx: RunContext) -> str:
- return ("You are an expert in Blender bpy and URDF writing RAW code (no SDKs). Links are bpy objects named exactly "
- "as the URDF links; joints are native URDF with origins/axes in the parent link frame. Exact numbers beat adjectives.")
+ return language_system_prompt(ctx.language)
# ----------------------------------------------------------------------------- sweep adapter
diff --git a/harness/codeverse/tracks/graphics.py b/harness/codeverse/tracks/graphics.py
index 0a533842..afc37934 100644
--- a/harness/codeverse/tracks/graphics.py
+++ b/harness/codeverse/tracks/graphics.py
@@ -48,6 +48,7 @@ from codeverse.tracks.prompting import (
is_always_chapter,
judge_digest,
judged_sheet,
+ language_system_prompt,
reference_images,
reference_note,
select_cookbook_chapters,
@@ -487,10 +488,7 @@ class GraphicsTrack(BaseTrack):
# ------------------------------------------------------------------ baseline
def system_prompt(self, ctx: RunContext) -> str:
- what = "GLSL fragment-shader artist (Shadertoy style)" if ctx.language is Language.GLSL_SHADER else "raw OpenGL (moderngl) graphics programmer"
- return (f"You are an expert {what} writing RAW code for a headless harness. Follow the contract exactly: "
- f"no #version/uniform redeclarations (shader) · no window/context creation (program) · everything animates with time. "
- f"Render and LOOK at your frames before finishing.")
+ return language_system_prompt(ctx.language)
def baseline_tasks(self, ctx: RunContext) -> list[GenerationTask]:
files = graphics_expected_files(ctx)
diff --git a/harness/codeverse/tracks/prompting.py b/harness/codeverse/tracks/prompting.py
index 5ab0f869..6829a29a 100644
--- a/harness/codeverse/tracks/prompting.py
+++ b/harness/codeverse/tracks/prompting.py
@@ -19,6 +19,8 @@ from codeverse.contracts.common import Language, Track
from codeverse.contracts.plan import Plan, StaticPlan
from codeverse.contracts.run import RoundRecord
from codeverse.conventions import LANGUAGE_FRAME, Frame, frame_doc, to_snake
+from codeverse.languages._docs import prompt_dir_for
+from codeverse.prompts import load_text, render
from codeverse.tracks.common import RunContext
from codeverse.tracks.depth import DepthBudget, PartScope, depth_budget, interfaces_text
from codeverse.tracks.generation import SINGLE_SHOT_FORMAT
@@ -265,6 +267,20 @@ def select_cookbook_chapters(ctx: RunContext, brief: str, *, budget: int = 9000,
return [chapters[i] for i in sorted(chosen)]
+def language_system_prompt(language: Language, *, role: str = "", **vars: Any) -> str:
+ """The generator's system prompt: ``prompts/<dir>/system.md``, or a role template.
+
+ These were f-strings inside each track class until 2026-08-28 — two sentences each,
+ and for the three static-object languages literally the SAME two sentences with the
+ language's name substituted, though bpy mesh modelling, CadQuery's B-rep workplanes
+ and three.js BufferGeometry share almost nothing but the word "3D". Per language, in
+ the prompt corpus, so the seven can diverge and be edited without touching code.
+ """
+ if role:
+ return render(f"system/role_{role}.j2", language=language.value, **vars).strip()
+ return load_text(f"{prompt_dir_for(language)}/system.md").strip()
+
+
def base_prompt_context(ctx: RunContext, **extra: Any) -> dict[str, Any]:
"""Variables every tracks/*.j2 template may use (StrictUndefined → all present)."""
plan = ctx.plan
diff --git a/harness/codeverse/tracks/repair.py b/harness/codeverse/tracks/repair.py
index a3a64118..b5008f91 100644
--- a/harness/codeverse/tracks/repair.py
+++ b/harness/codeverse/tracks/repair.py
@@ -22,7 +22,7 @@ from codeverse.prompts import render
from codeverse.tracks import skills_hook
from codeverse.tracks.common import RunContext
from codeverse.tracks.generation import GenerationResult, GenerationTask, generate
-from codeverse.tracks.prompting import base_prompt_context
+from codeverse.tracks.prompting import base_prompt_context, language_system_prompt
log = logging.getLogger(__name__)
@@ -200,5 +200,4 @@ def make_repair_task(ctx: RunContext, build: BuildResult, lint: GateReport, *, r
def _repair_system(ctx: RunContext) -> str:
- return (f"You repair {ctx.language.value} code that failed to build. Fix only the reported error(s) with the smallest "
- f"correct change; keep every part, name and dimension. {ctx.contract_text}")
+ return language_system_prompt(ctx.language, role="repair", contract=ctx.contract_text)
diff --git a/harness/codeverse/tracks/scene.py b/harness/codeverse/tracks/scene.py
index 4275b8dd..61d60a47 100644
--- a/harness/codeverse/tracks/scene.py
+++ b/harness/codeverse/tracks/scene.py
@@ -55,6 +55,7 @@ from codeverse.tracks.prompting import (
current_files,
file_for_target_factory,
judge_digest,
+ language_system_prompt,
reference_images,
)
from codeverse.tracks.repair import format_error_report
@@ -433,8 +434,7 @@ class SceneTrack(BaseTrack):
# ------------------------------------------------------------------ helpers
def system_prompt(self, ctx: RunContext) -> str:
- return ("You are an expert three.js + GLSL graphics programmer writing RAW ESM modules for a multi-file scene. "
- "No SDKs, no DOM, no fetch, no CDN imports: `import * as THREE from 'three'` only. Exact numbers beat adjectives.")
+ return language_system_prompt(ctx.language)
def _ctx(self, ctx: RunContext, **extra: Any) -> dict[str, Any]:
plan: ScenePlan = ctx.plan # type: ignore[assignment]
diff --git a/harness/codeverse/tracks/static_object.py b/harness/codeverse/tracks/static_object.py
index c04529c6..9c8244df 100644
--- a/harness/codeverse/tracks/static_object.py
+++ b/harness/codeverse/tracks/static_object.py
@@ -52,6 +52,7 @@ from codeverse.tracks.prompting import (
glb_to_plan_frame,
judge_digest,
judged_sheet,
+ language_system_prompt,
measurement_vs_plan,
reference_images,
refine_inline_files,
@@ -306,18 +307,11 @@ class StaticObjectTrack(BaseTrack):
return tasks
def scope_system_prompt(self, ctx: RunContext, scope: PartScope) -> str:
- return (
- f"You are an expert {ctx.language.value} 3D modeller writing RAW code (no SDKs, no helper libraries). "
- f"You own {len(scope.parts)} part(s) of a larger object: {', '.join(scope.names)}. "
- f"Other sessions own the rest — never write a file outside your list. "
- f"Follow the contract exactly; exact numbers beat adjectives; real detail beats a correctly sized box."
- )
+ return language_system_prompt(ctx.language, role="scope",
+ n_parts=len(scope.parts), names=", ".join(scope.names))
def system_prompt(self, ctx: RunContext) -> str:
- return (
- f"You are an expert {ctx.language.value} 3D modeller writing RAW code (no SDKs, no helper libraries). "
- f"Follow the contract exactly; exact numbers beat adjectives."
- )
+ return language_system_prompt(ctx.language)
def round_files_hint(self, ctx: RunContext) -> list[str]:
return expected_files(ctx)
@@ -429,12 +423,7 @@ class StaticObjectTrack(BaseTrack):
return tasks, lines
def detail_system_prompt(self, ctx: RunContext) -> str:
- return (
- f"You are an expert {ctx.language.value} 3D modeller adding SURFACE DETAIL to a model whose structure "
- f"is already accepted. You may not move, resize, rename, add or remove a part — a deterministic gate "
- f"compares every part's bounding box against the previous round and fails the round if one moved. "
- f"Everything you add lives inside or on an existing part's surface."
- )
+ return language_system_prompt(ctx.language, role="detail")
# ===================================================================== the DETAIL round
diff --git a/harness/tests/prompts/test_files.py b/harness/tests/prompts/test_files.py
index bdb7d178..c3bc9d0f 100644
--- a/harness/tests/prompts/test_files.py
+++ b/harness/tests/prompts/test_files.py
@@ -85,3 +85,23 @@ def test_system_prompts_cover_the_laws() -> None:
# (deleted 2026-08-28): the agent's tool section is GENERATED from the @tool
# registrations by agents/materialize._tool_section, so "every tool is documented"
# is true by construction and this assertion was checking a file nobody read.
+
+
+def test_every_language_ships_a_system_prompt() -> None:
+ """The generator's system prompt is per LANGUAGE and lives in the prompt corpus.
+
+ It used to be an f-string in each track class, and the three static-object
+ languages shared one sentence with the name swapped in — bpy mesh modelling,
+ CadQuery's B-rep workplanes and three.js BufferGeometry, told the same thing.
+ A missing file here means a language silently falls back to nothing.
+ """
+ from codeverse.contracts.common import Language
+ from codeverse.languages._docs import prompt_dir_for
+ from codeverse.tracks.prompting import language_system_prompt
+
+ for lang in Language:
+ text = language_system_prompt(lang)
+ assert text.strip(), f"{lang.value}: empty system prompt"
+ assert (PROMPTS_DIR / prompt_dir_for(lang) / "system.md").is_file(), lang.value
+ for role in ("scope", "detail", "repair"):
+ assert (PROMPTS_DIR / "system" / f"role_{role}.j2").is_file(), role