Research-Stack/5-Applications/text-to-cad
Brandon Schneider 747045ff0f docs(agents): project-wide AGENTS.md audit — cross-refs, baseline, contracts
Actions taken from 5-agent audit sweep (audit date 2026-05-26):

AGENTS.md / docs sync:
- root AGENTS.md: add scripts/qc-flag and lean_expert_agent to Nested Contracts
- All 6 nested AGENTS.md files: append Cross-References section pointing to
  root for Post-Interaction Workflow, Programming Choice Flow, Do Not Sweep,
  Git Remote Hygiene (Lean, Infra, text-to-cad, docs, qc-flag, lean_expert_agent)
- 6-Documentation/docs/AGENTS.md: cross-ref also lists AVMIsa.Emit sole output
  boundary and Compiler surface blessing

Lean build baseline:
- 0-Core-Formalism/lean/Semantics/AGENTS.md: update blessed Compiler Surface
  header to commit ff8e71fa; correct job count to 3311 (lake build Compiler)

ARCHITECTURE.md:
- §7 repo table: add RRC.Emit, AVMIsa.Emit, RRC.Corpus278 to Lean/Semantics entry
- New §7.1 Compiler Surface: documents 3-root pipeline and sole output boundary
- §4 Data Flow: annotate output with AVMIsa.Emit sole-boundary note

TODO_MAP.md:
- Phase A6: add 3 new Lean deliverables (Corpus278, RRC.Emit, AVMIsa.Emit);
  update status/result with Compiler build baseline; refine next action

Build: Compiler 3311 jobs, 0 errors (no Lean changes).

Generated with Devin (https://cli.devin.ai/docs)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-05-26 22:34:46 -05:00
..
models initial: sovereign research stack (consolidated, weightless, and lfs-optimized) 2026-05-04 18:11:36 -05:00
skills initial: sovereign research stack (consolidated, weightless, and lfs-optimized) 2026-05-04 18:11:36 -05:00
viewer initial: sovereign research stack (consolidated, weightless, and lfs-optimized) 2026-05-04 18:11:36 -05:00
.gitattributes initial: sovereign research stack (consolidated, weightless, and lfs-optimized) 2026-05-04 18:11:36 -05:00
.gitignore initial: sovereign research stack (consolidated, weightless, and lfs-optimized) 2026-05-04 18:11:36 -05:00
AGENTS.md docs(agents): project-wide AGENTS.md audit — cross-refs, baseline, contracts 2026-05-26 22:34:46 -05:00
CLAUDE.md initial: sovereign research stack (consolidated, weightless, and lfs-optimized) 2026-05-04 18:11:36 -05:00
LICENSE initial: sovereign research stack (consolidated, weightless, and lfs-optimized) 2026-05-04 18:11:36 -05:00
README.md initial: sovereign research stack (consolidated, weightless, and lfs-optimized) 2026-05-04 18:11:36 -05:00
requirements-cad.txt initial: sovereign research stack (consolidated, weightless, and lfs-optimized) 2026-05-04 18:11:36 -05:00

Demo of the text-to-cad harness generating and previewing CAD geometry

⚙ Open Source Text to CAD Harness ⚙

An open source harness for generating 3D models with your favorite coding agent

GitHub stars GitHub forks License: MIT Follow @soft_servo Python build123d OCP STEP STL URDF Node.js React Vite

Features

  • Generate - Create source-controlled CAD models with coding agents like Codex and Claude Code.
  • Export - Produce STEP, STL, DXF, GLB, topology data, and URDF robot descriptions.
  • Browse - Inspect generated geometry in a local CAD Explorer viewer.
  • Reference - Copy stable @cad[...] references so agents can make precise follow-up edits.
  • Review - Render quick snapshots for fast checks during an iteration loop.
  • Reproduce - Edit source files first, then regenerate explicit targets.
  • Local - Run the harness and viewer locally with no backend to host.

🧰 Bundled Skills

This harness vendors file-targeted skills for CAD and robot-description work. Use the bundled copies here for local models/ projects, or use the dedicated repositories when installing the skills outside this harness.

🔁 Workflow

  1. Describe - Tell your agent about the part, assembly, fixture, robot, or mechanism you want.
  2. Edit - Let your coding agent update CAD source files under models/.
  3. Regenerate - Create explicit STEP, STL, DXF, GLB, or URDF targets.
  4. Inspect - Open the CAD Explorer viewer to review the generated model.
  5. Reference - Copy @cad[...] handles when you want geometry-aware edits.
  6. Commit - Save the source and generated artifacts together once the model is ready.

🚀 Quick Start

Clone the repo:

git clone https://github.com/earthtojake/text-to-cad.git
cd text-to-cad

Install Python CAD dependencies:

python3.11 -m venv .venv
./.venv/bin/python -m pip install --upgrade pip
./.venv/bin/pip install -r requirements-cad.txt

Install viewer dependencies:

cd viewer
npm install

Run the local CAD Explorer:

npm run dev

Then open http://localhost:4178.