Skip to content

armgit / 67.js

Public Imported from GitHub
0

3D engine that AI agents drive

State the 67js stance in the goal and agent guide (#1043)

Nguyen Xuan An580a4941df5b
diff --git a/AGENTS.md b/AGENTS.md
index 8f2ac9bd..8cb099f9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -3,6 +3,14 @@
Read this before you change code in this repository. [CONTRIBUTING.md](CONTRIBUTING.md) has the full rules; this file is the short path.
To build scenes with 67js rather than change it, use the MCP server and the skills in `skills/` instead ([README](README.md#for-agents)).
+## Stance
+
+67js makes 3D easy to understand and easy to do. The agent carries the heavy steps, and the person keeps the creative choices and stays active ([docs/goal.md](docs/goal.md#stance)). So:
+
+- A change that people can see ships with a still or a clip rendered by 67js. Put it in the pull request and in its change note.
+- Docs and copy show the result first and explain in plain words before code.
+- Agent-facing features return previews and choices, and ask on matters of taste instead of deciding them.
+
## Layout
- `src/` is the library, one flat folder. `src/agent-*.js` and `src/mcp*` are the MCP tool surface.
diff --git a/docs/goal.md b/docs/goal.md
index f28e6c0a..13782821 100644
--- a/docs/goal.md
+++ b/docs/goal.md
@@ -2,6 +2,16 @@
67js aims to be as capable as Blender, as light as three.js, and as AI friendly as possible. No public claim of parity or speed is allowed until the evidence below exists.
+## Stance
+
+67js makes 3D easy to understand and easy to do. An agent knows how to use every part of 67js and carries the heavy steps of the work: setup, assets, lighting, checks and renders. The person keeps the creative choices and stays active. The agent proposes, shows pictures and asks when a choice is a matter of taste. It does not decide the look on its own and it does not leave the person waiting passively.
+
+Every surface follows from this:
+
+- **Show, then tell.** The README, docs, changelog and release notes lead with renders and clips made by 67js. A reader sees what a feature makes before reading how it works. A change that people can see ships with a picture or a short clip.
+- **Plain words.** Copy says what the person can make and what the agent does for them. Code comes after that.
+- **The person stays in the loop.** Agent tools return previews and choices to react to. Examples are `scene_ask_user`, review grids and quick previews before a final render.
+
## Definitions
**As capable as Blender.** Every in-scope row of the parity ledger (`docs/parity.md`) has evidence, and the reference scenes reach an agreed score against Cycles and EEVEE. Evidence is a golden fixture or a reference render. A demo does not count.
@@ -12,7 +22,7 @@
## Not in scope
-- A mouse editor, and the Blender interface and editors. Agents are the user, and people review through images and artifacts.
+- A mouse editor, and the Blender interface and editors. Agents operate the engine, and people direct the work and review it through images and artifacts.
- The Video Editing sequencer, and Motion Tracking and Masking.
- Grease Pencil.
- Reading `.blend` files, and compatibility with the Blender Python API. GLB is the exchange format.