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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.j2new file mode 100644index 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.j2new file mode 100644index 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.j2new file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.pyindex 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, Planfrom codeverse.conventions import to_snakefrom codeverse.spatial.render import RenderErrorfrom codeverse.tracks.common import RunContext+from codeverse.tracks.prompting import language_system_promptfrom codeverse.tracks.static_object import ObjectPipeline, StaticObjectTrackfrom 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 adapterdiff --git a/harness/codeverse/tracks/graphics.py b/harness/codeverse/tracks/graphics.pyindex 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):# ------------------------------------------------------------------ baselinedef 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.pyindex 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, Trackfrom codeverse.contracts.plan import Plan, StaticPlanfrom codeverse.contracts.run import RoundRecordfrom codeverse.conventions import LANGUAGE_FRAME, Frame, frame_doc, to_snake+from codeverse.languages._docs import prompt_dir_for+from codeverse.prompts import load_text, renderfrom codeverse.tracks.common import RunContextfrom codeverse.tracks.depth import DepthBudget, PartScope, depth_budget, interfaces_textfrom 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.plandiff --git a/harness/codeverse/tracks/repair.py b/harness/codeverse/tracks/repair.pyindex a3a64118..b5008f91 100644--- a/harness/codeverse/tracks/repair.py+++ b/harness/codeverse/tracks/repair.py@@ -22,7 +22,7 @@ from codeverse.prompts import renderfrom codeverse.tracks import skills_hookfrom codeverse.tracks.common import RunContextfrom 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_promptlog = logging.getLogger(__name__)@@ -200,5 +200,4 @@ def make_repair_task(ctx: RunContext, build: BuildResult, lint: GateReport, *, rdef _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.pyindex 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):# ------------------------------------------------------------------ helpersdef 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.pyindex 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 tasksdef 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, linesdef 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 rounddiff --git a/harness/tests/prompts/test_files.py b/harness/tests/prompts/test_files.pyindex 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