Skip to content

anbeime/skill / skills/img2threejs/img2threejs

img2threejs

Verified

Turn an object or character reference image into a quality-gated, animation-ready procedural Three.js model built in code. Use for image-to-3D reconstruction, detail-accurate object rebuilds, stylized/likeness-maximized human characters, sculpt specs, and staged code generation.

FileKindSize
.github/FUNDING.ymlconfig94 B
.github/ISSUE_TEMPLATE/bug_report.ymlconfig2.3 KB
.github/ISSUE_TEMPLATE/contribution_intent.ymlconfig1.8 KB
.github/ISSUE_TEMPLATE/feature_request.ymlconfig1.4 KB
.github/pull_request_template.mdmarkdown1.1 KB
.github/release.ymlconfig471 B
.github/workflows/beta-release.ymlconfig1.9 KB
.github/workflows/ci.ymlconfig349 B
.github/workflows/issue-triage.ymlconfig783 B
.github/workflows/pr-issue-close-policy.ymlconfig279 B
.github/workflows/release.ymlconfig625 B
.gitignoreother2.4 KB
CHANGELOG.mdmarkdown33.1 KB
CLAUDE.mdmarkdown2.8 KB
CONTRIBUTING.mdmarkdown4.7 KB
LAB-FINDINGS.mdmarkdown5.7 KB
LICENSEother11.1 KB
README.mdmarkdown38.9 KB
ROADMAP.mdmarkdown16.3 KB
SKILL.mdskill md30.8 KB
assets/logo.svgother2.0 KB
assets/sponsors/atlas-cloud-logomark-black.svgother595 B
assets/sponsors/atlas-cloud-logomark-white.svgother595 B
assets/sponsors/hyper3d-logomark-black.pngbinary1.1 KB
assets/sponsors/hyper3d-logomark-white.pngbinary1.2 KB
assets/sponsors/tripo-logomark-black.svgother1002 B
assets/sponsors/tripo-logomark-white.svgother1002 B
docs/ARCHITECTURE.mdmarkdown14.0 KB
docs/GLB_ANIMATED_CHARACTER_PROMPT.mdmarkdown13.1 KB
docs/GLB_CHARACTER_ANIMATION_PROMPT.mdmarkdown14.6 KB
docs/GLB_CHARACTER_POLISH_PROMPT.mdmarkdown10.6 KB
docs/GLB_CHARACTER_PROMPT.mdmarkdown19.1 KB
docs/HAIR_PIPELINE.mdmarkdown10.5 KB
docs/RESEARCH_TRELLIS2_TO_IMG2THREEJS.mdmarkdown35.4 KB
docs/STAGE_R_BACKLOG.mdmarkdown18.0 KB
docs/STAGE_R_TEST_PLAN.mdmarkdown14.0 KB
docs/TOKEN_COST.mdmarkdown2.5 KB
docs/UPGRADE_PLAN.mdmarkdown30.4 KB
docs/cs2-anatomy/gloves.mdmarkdown11.6 KB
docs/cs2-anatomy/heavy.mdmarkdown13.8 KB
docs/cs2-anatomy/knives.mdmarkdown18.2 KB
docs/cs2-anatomy/pistols.mdmarkdown12.0 KB
docs/cs2-anatomy/rifles.mdmarkdown13.1 KB
docs/cs2-anatomy/smgs.mdmarkdown13.4 KB
docs/cs2-anatomy/snipers.mdmarkdown13.8 KB
docs/cs2/3D_Technical_Mapping.jsonconfig10.6 KB
docs/cs2/3D_Technical_Reference.mdmarkdown22.2 KB
docs/cs2/3D_Vocabulary_CS2.jsonconfig10.0 KB
docs/cs2/3D_Vocabulary_CS2_Dictionary.mdmarkdown26.6 KB
docs/cs2/distill.mdmarkdown9.9 KB
docs/cs2/review-gates.mdmarkdown2.5 KB
docs/integrations/reference_fidelity_tooling.mdmarkdown6.2 KB
docs/issue-triage.mdmarkdown1.8 KB
docs/materials/IMAGE_MATERIAL_ANALYSIS.mdmarkdown5.0 KB
docs/materials/README.mdmarkdown5.2 KB
docs/materials/THREEJS_MATERIAL_REFERENCE.mdmarkdown11.4 KB
docs/materials/material-reference.jsonconfig55.0 KB
docs/pipelines/character-rigging-animation-1.5.2.mdmarkdown22.3 KB
docs/raw/.keepother0 B
docs/raw/img2threejs-skill-dataset.jsonconfig107.3 KB
docs/specs/render-profile.v2.example.jsonconfig2.6 KB
docs/specs/render-profile.v2.schema.jsonconfig3.8 KB
docs/specs/vocabulary/README.mdmarkdown4.4 KB
docs/specs/vocabulary/core_3d.jsonlother13.2 KB
docs/specs/vocabulary/core_3d_reconstruction.jsonlother56.1 KB
docs/specs/vocabulary/cs2.jsonlother7.1 KB
docs/specs/vocabulary/cs2_reconstruction.jsonlother85.7 KB
docs/standard-prompts/README.mdmarkdown2.2 KB
docs/standard-prompts/build.mdmarkdown5.2 KB
docs/standard-prompts/glb-force-measured.mdmarkdown8.6 KB
docs/standard-prompts/polish.mdmarkdown2.7 KB
docs/standard-prompts/vfx.mdmarkdown5.7 KB
forge/_shared/artifact_cache.pyscript1.7 KB
forge/_shared/chirality.pyscript12.1 KB
forge/_shared/color_metrics.pyscript3.6 KB
forge/_shared/feature_acceptance_policy.pyscript4.2 KB
forge/_shared/image_hash.pyscript4.0 KB
forge/_shared/jpeg.pyscript16.0 KB
forge/_shared/material_physics.pyscript12.2 KB
forge/_shared/pipeline_routing.pyscript7.0 KB
forge/_shared/scalp_field.pyscript14.3 KB
forge/_shared/sdf_primitives.pyscript8.3 KB
forge/_shared/spec_search.pyscript61.9 KB
forge/_shared/spec_search_profiles.jsonconfig1.4 KB
forge/_shared/status_banner.pyscript1.4 KB
forge/_shared/subdivision.pyscript10.5 KB
forge/_shared/vertex_paint.pyscript10.8 KB
forge/_shared/workflow_state.pyscript20.5 KB
forge/materials/__init__.pyscript355 B
forge/materials/compatibility.pyscript5.1 KB
forge/materials/reference.pyscript10.2 KB
forge/next.pyscript4.4 KB
forge/report.pyscript1.5 KB
forge/requirements.txtmanifest335 B
forge/stage1_intake/analyze_texture.pyscript12.1 KB
forge/stage1_intake/bind_detail_properties.pyscript4.6 KB
forge/stage1_intake/build_detail_inventory.pyscript13.0 KB
forge/stage1_intake/camera_fitting_math.pyscript5.5 KB
forge/stage1_intake/camera_fitting_solver.pyscript8.2 KB
forge/stage1_intake/camera_fitting_types.pyscript8.2 KB
forge/stage1_intake/camera_image_helpers.pyscript6.0 KB
forge/stage1_intake/check_intake_correctness.pyscript4.8 KB
forge/stage1_intake/check_reference_admission.pyscript7.6 KB
forge/stage1_intake/cs2_foundation.pyscript7.9 KB
forge/stage1_intake/cs2_manifest.pyscript10.5 KB
forge/stage1_intake/cs2_review_contract.pyscript1.7 KB
forge/stage1_intake/delight_albedo.pyscript14.2 KB
forge/stage1_intake/detect_cs2.pyscript9.7 KB
forge/stage1_intake/detect_reference_effects.pyscript8.9 KB
forge/stage1_intake/extract_cs2_textures.pyscript5.6 KB
forge/stage1_intake/extract_gradient_stops.pyscript5.8 KB
forge/stage1_intake/extract_hair_evidence.pyscript18.6 KB
forge/stage1_intake/extract_landmarks.pyscript16.0 KB
forge/stage1_intake/extract_part_color_recipe.pyscript20.8 KB
forge/stage1_intake/extract_pbr_evidence.pyscript32.5 KB
forge/stage1_intake/fetch_cs2_metadata.pyscript6.4 KB
forge/stage1_intake/label_glb_nodes.pyscript13.0 KB
forge/stage1_intake/locate_cs2_vpk.pyscript2.6 KB
forge/stage1_intake/material_region_analysis.pyscript9.8 KB
forge/stage1_intake/probe_glb.pyscript15.0 KB
forge/stage1_intake/probe_image.pyscript5.4 KB
forge/stage1_intake/run_vision_adapter.pyscript1.6 KB
forge/stage1_intake/search_specs.pyscript7.5 KB
forge/stage1_intake/semantic_decomposition.pyscript4.5 KB
forge/stage1_intake/solve_camera_pose.pyscript10.7 KB
forge/stage2_spec/apply_material_analysis.pyscript8.6 KB
forge/stage2_spec/cs2_adapters.pyscript3.0 KB
forge/stage2_spec/derive_geometry.pyscript4.3 KB
forge/stage2_spec/hair_profile.pyscript14.5 KB
forge/stage2_spec/humanoid_proportions.pyscript9.0 KB
forge/stage2_spec/new_pre_spec_assessment.pyscript12.1 KB
forge/stage2_spec/new_sculpt_spec.pyscript127.4 KB
forge/stage2_spec/validate_sculpt_spec.pyscript144.5 KB
forge/stage3_build/bake_projected_texture.pyscript8.8 KB
forge/stage3_build/decimate.pyscript10.4 KB
forge/stage3_build/generate_threejs_factory.pyscript207.6 KB
forge/stage3_build/module_cache.pyscript5.6 KB
forge/stage3_build/morph_targets.pyscript7.3 KB
forge/stage3_build/orchestrate_passes.pyscript27.6 KB
forge/stage3_build/uv_unwrap.pyscript24.7 KB
forge/stage3_build/visual_hull.pyscript16.4 KB
forge/stage4_review/_fit_divine_eye.pyscript2.6 KB
forge/stage4_review/append_review.pyscript20.4 KB
forge/stage4_review/attachment_anchor.pyscript16.2 KB
forge/stage4_review/calibrate_eye.pyscript5.4 KB
forge/stage4_review/check_part_coverage.pyscript13.1 KB
forge/stage4_review/compare_region_passes.pyscript7.6 KB
forge/stage4_review/correction_loop.pyscript10.2 KB
forge/stage4_review/cs2_review.pyscript8.7 KB
forge/stage4_review/diagnose_render.pyscript15.5 KB
forge/stage4_review/diagnose_render_multi_angle.pyscript5.6 KB
forge/stage4_review/divine_eye.pyscript21.0 KB
forge/stage4_review/fit_params.pyscript16.6 KB
forge/stage4_review/geometry_integrity.pyscript15.1 KB
forge/stage4_review/hair_gate.pyscript9.5 KB
forge/stage4_review/interior_difference.pyscript7.8 KB
forge/stage4_review/joint_loops.pyscript8.2 KB
forge/stage4_review/make_comparison_sheet.pyscript10.9 KB
forge/stage4_review/material_comparator.pyscript7.9 KB
forge/stage4_review/material_feedback.pyscript6.7 KB
forge/stage4_review/material_gate.pyscript5.8 KB
forge/stage4_review/material_views.pyscript7.5 KB
forge/stage4_review/mesh_reference_compare.pyscript16.2 KB
forge/stage4_review/multi_pass.pyscript3.1 KB
forge/stage4_review/objectness.pyscript5.4 KB
forge/stage4_review/pairwise_penetration.pyscript16.2 KB
forge/stage4_review/per_feature.pyscript6.8 KB
forge/stage4_review/render_bridge.pyscript24.1 KB
forge/stage4_review/scalp_exposure.pyscript11.5 KB
forge/stage4_review/self_intersection.pyscript26.3 KB
forge/stage4_review/swept_arc_gate.pyscript14.3 KB
forge/stage4_review/turntable_gate.pyscript17.6 KB
forge/stage4_review/validate_render_profile.pyscript8.9 KB
forge/stage4_review/vertex_region_gate.pyscript20.3 KB
forge/stage4_review/vlm_gate.pyscript8.8 KB
forge/stage5_rig/CONTRACT_1.5.2.mdmarkdown3.6 KB
forge/stage5_rig/NOTES.mdmarkdown8.5 KB
forge/stage5_rig/__init__.pyscript302 B
forge/stage5_rig/action_design.pyscript88.2 KB
forge/stage5_rig/clip_features.pyscript33.2 KB
forge/stage5_rig/emit_animation_runtime.pyscript17.7 KB
forge/stage5_rig/emit_rig.pyscript17.6 KB
forge/stage5_rig/geodesic_skinning.pyscript23.0 KB
forge/stage5_rig/glb_rig_reference.pyscript58.8 KB
forge/stage5_rig/mesh_parity.pyscript36.7 KB
forge/stage5_rig/rig_gates.pyscript78.7 KB
forge/stage5_rig/rig_spec.pyscript6.4 KB
forge/stage5_rig/skin_conditioning.pyscript25.9 KB
forge/stage5_rig/validate_rig_payload.pyscript8.8 KB
forge/state.pyscript3.5 KB
forge/tests/fixtures/implicit_character_torso_limb.jsonconfig1.4 KB
forge/tests/fixtures/knife_review_scene.jsonconfig1.3 KB
forge/tests/fixtures/stand_proud_hair_on_head.jsonconfig3.0 KB
forge/tests/fixtures/subdivision_cage.jsonconfig812 B
forge/tests/fixtures/visual_hull_two_views.jsonconfig2.6 KB
forge/tests/showcase_test_support.pyscript698 B
forge/tests/test_action_design.pyscript37.3 KB
forge/tests/test_albedo_color_space.pyscript4.6 KB
forge/tests/test_analyze_texture.pyscript6.0 KB
forge/tests/test_attachment_anchor.pyscript8.2 KB

forge/_shared/subdivision.py

View on GitHub
MAX_SUBDIVISION_ITERATIONS = 4
MAX_SUBDIVISION_QUAD_FACES = 100_000

CYLINDER_RADIAL_SEGMENTS = 48
CYLINDER_HEIGHT_SEGMENTS = 16
ATTACHMENT_CYLINDER_RADIAL_SEGMENTS = 32
ATTACHMENT_CYLINDER_HEIGHT_SEGMENTS = 12
CONE_SUBDIVISION_TOP_RADIUS = 0.0001
# A tapering ConeGeometry, unlike a constant-radius CylinderGeometry, does not weld
# cleanly at CYLINDER_HEIGHT_SEGMENTS (16): measured 2448 raw / 2160 welded boundary
# edges (a real topology defect, not a benign UV seam -- box/cylinder/sphere/torus/
# ellipsoid all weld to 0/0 at their own segment counts). A cone built with
# heightSegments=1 (three.js's own default) welds cleanly to 0/0, verified directly;
# a solid cone's lateral surface does not need internal height rings for shading or
# silhouette quality at rest, only the subdivision-requested substitute (a near-
# degenerate CylinderGeometry, unaffected by this constant) needs a denser cage.
CONE_HEIGHT_SEGMENTS = 1
SPHERE_WIDTH_SEGMENTS = 64
SPHERE_HEIGHT_SEGMENTS = 40
CAPSULE_CAP_SEGMENTS = 16
CAPSULE_RADIAL_SEGMENTS = 32
TORUS_TUBULAR_SEGMENTS = 24
TORUS_RADIAL_SEGMENTS = 96
PLANE_WIDTH_SEGMENTS = 24
PLANE_HEIGHT_SEGMENTS = 24


# --- Tessellation tiers -------------------------------------------------------
#
# The constants above are the `hero` tier and stay the module-level defaults, so
# every existing caller keeps its current output byte-for-byte. A spec that wants
# a cheaper mesh selects a tier via `performanceBudget.targetTriangles`, which
# was already in the schema and read by nothing (`lodPlan` has the same problem;
# see decimate.py's docstring).
#
# Two floors are load-bearing and are asserted by `validate_tier()`:
#
# * HEIGHT segments >= MIN_JOINT_HEIGHT_SEGMENTS on anything a bone deforms. One
#   quad spanning a joint leaves no vertex at the pivot, so the influenced region
#   skips the joint entirely and the elbow collapses instead of bending.
#
#   The value is 4, not the 3 of the standard "rule of three" (one loop on the
#   joint plane, one supporting loop each side). External practice says 3 is the
#   minimum; this repository already decided 3 was not enough. `emit_rig.py:399`
#   derives its own ring count as `max(4, ceil(cyl_length / target_ring_spacing))`
#   -- a hard floor of 4 -- in the same module whose NOTES.md documents the
#   single-quad-band joint-pinch failure this floor exists to prevent. Where an
#   in-repo measurement and an external rule of thumb disagree, the measurement
#   wins, so this matches emit_rig.py rather than the textbook.
# * RADIAL segments >= MIN_RADIAL_SEGMENTS, below which a swept primitive stops
#   reading as a round limb and the silhouette goes visibly polygonal.
MIN_JOINT_HEIGHT_SEGMENTS = 4
MIN_RADIAL_SEGMENTS = 6

# Deliberately NOT tiered. A tapering cone does not weld cleanly at higher height
# segment counts -- 2448 raw / 2160 welded boundary edges, a real topology defect,
# see the comment on CONE_HEIGHT_SEGMENTS above -- and 1 is the value that welds to
# 0/0. `validate_tier()` pins it so a future tier cannot quietly reintroduce that
# defect while chasing a triangle budget.
REQUIRED_CONE_HEIGHT_SEGMENTS = 1

TESSELLATION_TIERS: dict[str, dict[str, int]] = {
    "low": {
        "CYLINDER_RADIAL_SEGMENTS": 10,
        "CYLINDER_HEIGHT_SEGMENTS": 4,
        "ATTACHMENT_CYLINDER_RADIAL_SEGMENTS": 8,
        "ATTACHMENT_CYLINDER_HEIGHT_SEGMENTS": 4,
        "CONE_HEIGHT_SEGMENTS": 1,
        "SPHERE_WIDTH_SEGMENTS": 16,
        "SPHERE_HEIGHT_SEGMENTS": 10,
        "CAPSULE_CAP_SEGMENTS": 4,
        "CAPSULE_RADIAL_SEGMENTS": 8,
        "TORUS_TUBULAR_SEGMENTS": 8,
        "TORUS_RADIAL_SEGMENTS": 16,
        "PLANE_WIDTH_SEGMENTS": 4,
        "PLANE_HEIGHT_SEGMENTS": 4,
        "BOX_SEGMENTS": 1,
        "SDF_MAX_RESOLUTION": 24,
    },
    "standard": {
        "CYLINDER_RADIAL_SEGMENTS": 24,
        "CYLINDER_HEIGHT_SEGMENTS": 8,
        "ATTACHMENT_CYLINDER_RADIAL_SEGMENTS": 16,
        "ATTACHMENT_CYLINDER_HEIGHT_SEGMENTS": 6,
        "CONE_HEIGHT_SEGMENTS": 1,
        "SPHERE_WIDTH_SEGMENTS": 32,
        "SPHERE_HEIGHT_SEGMENTS": 20,
        "CAPSULE_CAP_SEGMENTS": 8,
        "CAPSULE_RADIAL_SEGMENTS": 16,
        "TORUS_TUBULAR_SEGMENTS": 12,
        "TORUS_RADIAL_SEGMENTS": 48,
        "PLANE_WIDTH_SEGMENTS": 12,
        "PLANE_HEIGHT_SEGMENTS": 12,
        "BOX_SEGMENTS": 4,
        "SDF_MAX_RESOLUTION": 40,
    },
    "hero": {
        "CYLINDER_RADIAL_SEGMENTS": CYLINDER_RADIAL_SEGMENTS,
        "CYLINDER_HEIGHT_SEGMENTS": CYLINDER_HEIGHT_SEGMENTS,
        "ATTACHMENT_CYLINDER_RADIAL_SEGMENTS": ATTACHMENT_CYLINDER_RADIAL_SEGMENTS,
        "ATTACHMENT_CYLINDER_HEIGHT_SEGMENTS": ATTACHMENT_CYLINDER_HEIGHT_SEGMENTS,
        "CONE_HEIGHT_SEGMENTS": CONE_HEIGHT_SEGMENTS,
        "SPHERE_WIDTH_SEGMENTS": SPHERE_WIDTH_SEGMENTS,
        "SPHERE_HEIGHT_SEGMENTS": SPHERE_HEIGHT_SEGMENTS,
        "CAPSULE_CAP_SEGMENTS": CAPSULE_CAP_SEGMENTS,
        "CAPSULE_RADIAL_SEGMENTS": CAPSULE_RADIAL_SEGMENTS,
        "TORUS_TUBULAR_SEGMENTS": TORUS_TUBULAR_SEGMENTS,
        "TORUS_RADIAL_SEGMENTS": TORUS_RADIAL_SEGMENTS,
        "PLANE_WIDTH_SEGMENTS": PLANE_WIDTH_SEGMENTS,
        "PLANE_HEIGHT_SEGMENTS": PLANE_HEIGHT_SEGMENTS,
        "BOX_SEGMENTS": 12,
        "SDF_MAX_RESOLUTION": 64,
    },
}

DEFAULT_TESSELLATION_TIER = "hero"

# Measured, not guessed: a 61-component humanoid spec generated at `hero` builds
# 14,208 triangles (counted by constructing the emitted factory under node, not
# by parsing the source). The same primitive mix at each tier, using three.js's
# own triangle formulas, is what these thresholds are drawn from.
TIER_TRIANGLE_CEILINGS: tuple[tuple[int, str], ...] = (
    (6_000, "low"),
    (60_000, "standard"),
)


def tier_for_target_triangles(target_triangles: object) -> str:
    """Pick a tessellation tier from `performanceBudget.targetTriangles`.

    Anything missing, non-numeric or non-positive keeps the current behaviour
    (`hero`), so specs written before this existed are unaffected.
    """
    if isinstance(target_triangles, bool) or not isinstance(target_triangles, (int, float)):
        return DEFAULT_TESSELLATION_TIER
    if target_triangles <= 0:
        return DEFAULT_TESSELLATION_TIER
    for ceiling, tier in TIER_TRIANGLE_CEILINGS:
        if target_triangles <= ceiling:
            return tier
    return DEFAULT_TESSELLATION_TIER


def validate_tier(name: str) -> dict[str, int]:
    """Return a tier's segment table, refusing one that would break deformation."""
    if name not in TESSELLATION_TIERS:
        raise ValueError(
            f"unknown tessellation tier {name!r}; expected one of {sorted(TESSELLATION_TIERS)}"
        )
    table = TESSELLATION_TIERS[name]
    for key in ("CYLINDER_HEIGHT_SEGMENTS", "ATTACHMENT_CYLINDER_HEIGHT_SEGMENTS"):
        if table[key] < MIN_JOINT_HEIGHT_SEGMENTS:
            raise ValueError(
                f"tier {name!r} sets {key}={table[key]}, below the "
                f"{MIN_JOINT_HEIGHT_SEGMENTS}-segment floor a bone needs to deform a joint"
            )
    for key in (
        "CYLINDER_RADIAL_SEGMENTS",
        "ATTACHMENT_CYLINDER_RADIAL_SEGMENTS",
        "CAPSULE_RADIAL_SEGMENTS",
    ):
        if table[key] < MIN_RADIAL_SEGMENTS:
            raise ValueError(
                f"tier {name!r} sets {key}={table[key]}, below the "
                f"{MIN_RADIAL_SEGMENTS}-segment floor a swept primitive needs to read as round"
            )
    if table["CONE_HEIGHT_SEGMENTS"] != REQUIRED_CONE_HEIGHT_SEGMENTS:
        raise ValueError(
            f"tier {name!r} sets CONE_HEIGHT_SEGMENTS={table['CONE_HEIGHT_SEGMENTS']}; a cone "
            f"only welds cleanly at {REQUIRED_CONE_HEIGHT_SEGMENTS} and this is not a budget knob"
        )
    return table


def segments_for_spec(spec: object) -> dict[str, int]:
    """Resolve the segment table a spec should generate with."""
    budget = spec.get("performanceBudget") if isinstance(spec, dict) else None
    target = budget.get("targetTriangles") if isinstance(budget, dict) else None
    return validate_tier(tier_for_target_triangles(target))


def cylinder_source_face_count(radial_segments: int, height_segments: int) -> int:
    return radial_segments * (height_segments + 1)


def capsule_source_face_count(cap_segments: int, radial_segments: int, height_segments: int = 1) -> int:
    """Return the exact triangle count emitted by `buildWatertightCapsule` in
    generate_threejs_factory.py, which replaced THREE.CapsuleGeometry as the capsule
    primitive's construction (see that file's `geometry_for()` and the
    `buildWatertightCapsule` helper it emits). Raw THREE.CapsuleGeometry duplicates
    every UV-seam vertex, same benign pattern as box/cylinder/sphere/torus -- it is
    NOT actually non-manifold (a naive vertex-only mergeVertices() reports 64 such
    edges, but that is a counting artifact from degenerate near-pole triangles, not
    a real defect; confirmed by replicating subdivideCatmullClark's own degenerate-
    aware vertex identity). `buildWatertightCapsule` is worth having regardless: it
    is closed by construction (shared poles, radial index taken `% radialSegments`)
    rather than relying on a weld, and has a smaller, exact triangle count: 2 pole
    fans of `radial_segments` triangles each, plus `(2*cap_segments + height_segments
    - 2)` ring bands of `2*radial_segments` triangles each -- fewer vertices for the
    per-vertex skinning weight pass to visit. `height_segments` defaults to 1,
    matching the one call site.
    """
    return 2 * radial_segments * (2 * cap_segments + height_segments - 1)


def resolve_instanced_cluster_base(
    primitive: str,
    descriptor: dict[str, object],
    valid_primitives: set[str],
) -> str:
    if primitive != "instanced-cluster":
        return primitive
    base = descriptor.get("baseGeometry")
    if isinstance(base, str) and base not in {"", "instanced-cluster"} and base in valid_primitives:
        return base
    return "box"


SUBDIVISION_SOURCE_FACE_ESTIMATES: dict[str, int] = {
    "box": 6,
    "sphere": 2 * SPHERE_WIDTH_SEGMENTS * SPHERE_HEIGHT_SEGMENTS,
    "ellipsoid": 2 * SPHERE_WIDTH_SEGMENTS * SPHERE_HEIGHT_SEGMENTS,
    "cylinder": cylinder_source_face_count(CYLINDER_RADIAL_SEGMENTS, CYLINDER_HEIGHT_SEGMENTS),
    "cone": cylinder_source_face_count(CYLINDER_RADIAL_SEGMENTS, CYLINDER_HEIGHT_SEGMENTS),
    "capsule": capsule_source_face_count(CAPSULE_CAP_SEGMENTS, CAPSULE_RADIAL_SEGMENTS),
    "torus": 2 * TORUS_TUBULAR_SEGMENTS * TORUS_RADIAL_SEGMENTS,
    "plane-card": 2 * PLANE_WIDTH_SEGMENTS * PLANE_HEIGHT_SEGMENTS,
}
ATTACHMENT_CYLINDER_SUBDIVISION_SOURCE_FACES = cylinder_source_face_count(
    ATTACHMENT_CYLINDER_RADIAL_SEGMENTS,
    ATTACHMENT_CYLINDER_HEIGHT_SEGMENTS,
)
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall