apolo-cad: Instructions file for Claude Code

CLAUDE.md

apolo-cad CLAUDE.md is an instructions file for Claude Code from mariorojasmz/apolo-cad. It costs 8,504 tokens per session, scanned A, original, MIT.

A Claude Code instruction file for Genix Apolo CAD, a 3D computer-aided design tool for industrial machinery and robotics. It documents the Python geometry engine, web application, AI integration, command-based document format, and development rules.

In plain words
What is it for?
Use it when developing or testing Apolo CAD, especially its conveyor and material-handling features, HTTP API, React and three.js interface, geometry generation, or saved .apolo documents.
Why use it?
It gives agents the architectural context needed to change a complex CAD system without breaking its API-first and event-based design.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md.

This is mariorojasmz/apolo-cad's own configuration. It tells Claude Code how to work on apolo-cad itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything apolo-cad configures →

Reuse

Borrowing it

Nothing to install: this file belongs to mariorojasmz/apolo-cad. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/mariorojasmz/apolo-cad/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/mariorojasmz/apolo-cad

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for apolo-cad CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/mariorojasmz/apolo-cad/claude-md/github.svg)](https://agentmods.dev/instructions/mariorojasmz/apolo-cad/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/mariorojasmz/apolo-cad/claude-md"><img src="https://agentmods.dev/badge/instructions/mariorojasmz/apolo-cad/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for apolo-cad CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/mariorojasmz/apolo-cad/claude-md"><img src="https://agentmods.dev/badge/instructions/mariorojasmz/apolo-cad/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 8,504 This file is loaded in full into every session.
When invoked 8,504 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.08504 $0.08504
Opus 5.5 $0.03402 $0.03402
Sonnet 5.5 $0.01701 $0.01701
Haiku 4.5 $0.00850 $0.00850

Measured yesterday against content hash bd641028c187, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

apolo-cad CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 414 lines

How it starts

The opening of the file, as written. The whole thing — 414 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Genix Apolo CAD

CAD paramétrico 3D para maquinaria industrial/robótica cuyo diferenciador es el diseño asistido por IA (agente-nativo, también manual). Vertical del MVP: transportadores / manejo de materiales. Stack: Python (build123d/OCCT) + FastAPI + React/three.js. IA: Claude por MCP (apolo-cad); el chat de la app (Claude API vía APOLO_MODEL) viene APAGADO (APOLO_CHAT=1 lo prende; D19 de chat-cliente-igual).

Este archivo tiene sólo lo transversal: principios, cultura de trabajo y reglas que valen en todo el repo. El detalle de cada paquete está en su propio CLAUDE.md (índice más abajo); la historia, en el plan de cada versión, en docs/devlog.md y en git log.

Arquitectura (principios que NO se negocian)

  • API-first / IA-nativa: toda operación es un comando sobre un kernel headless. UI, agente-chat y MCP son clientes iguales de la misma API HTTP.
  • Documento = log de comandos (event-sourced). .apolo = ZIP (manifest v2 + commands.json + attachments/). La geometría nunca se guarda → archivos de KB, autosave barato, undo/redo por snapshots.
  • Schema-driven: los JSON Schemas pydantic del REGISTRY generan a la vez la toolbar, los diálogos, el panel Propiedades y las tools del agente. Una sola fuente de verdad. El MCP es THIN: run_command/run_batch (con $k) + edit_command/edit_batch + undo/redo cubren TODO el registro; NO hay tool por comando (los huecos auditados siempre fueron de LECTURA, no de escritura). Los lotes aceptan contrato (expect): aserciones que deben cumplirse tras el regenerate o el lote se revierte entero (api).
  • Expresiones: cualquier campo numérico acepta "=expresión" con variables del proyecto (motor AST en commands/expressions.py). Las variables son comandos set_variable en la cabecera del log; cambiarlas regenera todo.
  • Selectores declarativos de aristas/caras (todas/direccion/cara/longitud/cerca) para evitar nombrado topológico frágil.
  • Plantillas de máquina = super-comandos del registro (p. ej. create_conveyor), no scripts: heredan edición paramétrica, undo, BOM y exposición al agente gratis.
  • Criterio de ingeniería por defecto: el agente diseña como ingeniero/estructurista (el usuario es el CLIENTE) y asume lo obvio —sujeción, montaje/desmontaje con pernos, forma conforme a la función— sin esperar a que se lo pidan. Fuente ÚNICA: core/apolo/design/guidelines.py (core/apolo). Un 3D sólo vale si es FABRICABLE y se SOSTIENE.

Read the full file on GitHub · 414 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday Changed · +2 lines · +119 tokens per session bd641028c187
  2. 3d ago Changed · +12 lines · +352 tokens per session 954b0a02a4ad
  3. 4d ago Changed · -18 lines · -455 tokens per session 581257c4cb6f
  4. 5d ago Changed · +6 lines · +185 tokens per session 515ed4112352
  5. 7d ago Changed · +16 lines · +397 tokens per session 24f903f1dffc
  6. 8d ago Changed · +7 lines · +151 tokens per session a39223ca59db
  7. 16d ago Changed · -41 lines · -707 tokens per session dc4dc5872196
  8. 18d ago Changed · +4 lines · +152 tokens per session e9ae801267fe
  9. 22d ago Changed · -976 lines · -28,341 tokens per session 9c3b5f017295
  10. 1mo ago First seen · 1,402 lines · 36,651 tokens per session scan A ee4068c7015b

Subscribe to this mod's changes

apolo-cad CLAUDE.md is an instructions file published in the GitHub repository mariorojasmz/apolo-cad (3 stars, last pushed today), licensed MIT. It adds 8,504 tokens to every session, about $0.0340 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories