gaesup-world: Instructions file for Codex

AGENTS.md

gaesup-world AGENTS.md is an instructions file for Codex, OpenCode from jigglypop/gaesup-world. It costs 1,958 tokens per session, scanned A, original, MIT.

Repository instructions for gaesup-world, a TypeScript project that combines React, a web interface library, with Three.js and Rapier for interactive 3D worlds. They define coding, architecture, migration, and workflow rules for contributors.

In plain words
What is it for?
They guide changes to the React and TypeScript codebase, including domain procedures, strict typing, file organisation, server handling, and restrictions on generated files and assets.
Why use it?
Shared repository rules reduce inconsistent changes and help contributors preserve existing behaviour while working across the 3D library and its showcase app.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: reads .claude/ paths; reads ~/.codex paths; mentions AGENTS.md.

This is jigglypop/gaesup-world's own configuration. It tells Codex and OpenCode how to work on gaesup-world 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 gaesup-world configures →

Reuse

Borrowing it

Nothing to install: this file belongs to jigglypop/gaesup-world. 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/jigglypop/gaesup-world/master/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/jigglypop/gaesup-world

Made for: Codex, OpenCode.

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 gaesup-world AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/jigglypop/gaesup-world/agents-md/github.svg)](https://agentmods.dev/instructions/jigglypop/gaesup-world/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/jigglypop/gaesup-world/agents-md"><img src="https://agentmods.dev/badge/instructions/jigglypop/gaesup-world/agents-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 gaesup-world AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/jigglypop/gaesup-world/agents-md"><img src="https://agentmods.dev/badge/instructions/jigglypop/gaesup-world/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,958 This file is loaded in full into every session.
When invoked 1,958 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.01958 $0.01958
Opus 5.5 $0.00783 $0.00783
Sonnet 5.5 $0.00392 $0.00392
Haiku 4.5 $0.00196 $0.00196

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

Security

Grade A, and why

gaesup-world AGENTS.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 1mo ago.

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.

AGENTS.md · 123 lines

How it starts

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

gaesup-world

gaesup-world는 React Three Fiber, Three.js, Rapier와 Zustand를 기반으로 하는 3D world library와 이를 소비하는 Vite showcase를 함께 관리한다. 장기 목표는 Blender asset authoring, persistent WorldDocument, WebGPU-first rendering, world creator, multiplayer와 social interaction을 연결하는 data-oriented 3D social world platform이다.

AGENTS.md, .codex/agents/*.toml의 위치와 필수 형식은 Codex 공식 문서를 따른다. 절차형 스킬은 .claude/skills/**/SKILL.md에 있으며(add-domain, add-subpath-export, verify, start-epoch, close-epoch) Codex에서도 해당 파일을 문서로 읽어 같은 절차를 따른다. 4개 역할 분리, context 문서, invariant와 epoch workflow는 현재 저장소 분석을 바탕으로 한 추론한 설계다.

저장소 규칙

  • 기존 동작과 사용자 변경을 보존하고 요청 범위의 최소 migration slice만 수정한다.
  • reset, checkout, restore, revert로 기존 변경을 제거하지 않는다.
  • dist/, demo-dist/, node_modules/와 대용량 asset을 직접 수정하지 않는다.
  • 이미 실행 중인 dev server를 다시 실행하거나 종료하지 않는다.
  • 전체 재작성보다 strangler migration을 우선한다.
  • 존재하지 않는 경로나 API를 추측하지 않고 현재 저장소를 확인한다.

코딩 규칙

  • TypeScript strict를 유지하고 any를 사용하지 않는다.
  • 데이터 타입은 type으로 정의한다. 기존 interface는 해당 작업이 직접 다루지 않으면 기계적으로 변경하지 않는다.
  • 코드 식별자는 영어로 작성한다.
  • 불필요한 주석, 빈 줄, magic number와 중복 코드를 추가하지 않는다.
  • 타입은 가능한 경우 같은 domain의 types.ts에 분리한다.
  • 컴포넌트는 <Name>/index.tsx, styles.css, types.ts 구조를 우선한다.
  • console.log, console.warn, console.error 대신 project logger를 사용한다.
  • store는 selector로 필요한 상태만 구독하고 전체 store를 구독하지 않는다.
  • Props event는 on*, 내부 handler는 handle*, 상수는 UPPER_SNAKE_CASE를 사용한다.
  • 프로젝트의 Prettier와 ESLint 설정을 따른다.

Architecture 원칙

  • Persistent world state는 React에 의존하지 않는다.
  • Three.js와 Rapier 객체는 canonical persistent state가 아니다.
  • Editor와 Runtime은 장기적으로 같은 World Model을 projection한다.
  • Persistent mutation은 하나의 canonical write path를 가진다.
  • Network와 save contract는 engine-neutral serializable data를 사용한다.
  • WebGPU는 목표 primary renderer이고 WebGL-specific 구현은 compatibility boundary에 격리한다.
  • 기존 typed-array, spatial, visibility, culling과 GPU upload 구현은 측정 근거 없이 객체 중심 구조로 교체하지 않는다.
  • React component lifetime과 persistent entity lifetime을 결합하지 않는다.
  • migration 중 old/new path가 공존하면 canonical path를 문서와 코드에서 명시한다.
  • gaesup-world는 특정 미니홈피/SNS 제품의 business domain을 소유하지 않는다. 제품 기능은 application/backend가 소유하고 library에는 재사용 가능한 spatial primitive와 engine-neutral contract만 둔다.
  • pet 기능은 AI brain과 runtime body를 분리한다. memory, personality, emotion reasoning, LLM/planner는 core에 넣지 않고 bounded intent execution만 runtime 책임으로 둔다.

Read the full file on GitHub · 123 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. 1mo ago Changed · +5 lines · +192 tokens per session e7ffde08e6d1
  2. 1mo ago First seen · 118 lines · 1,766 tokens per session scan A 155b2f851b73

Subscribe to this mod's changes

gaesup-world AGENTS.md is an instructions file published in the GitHub repository jigglypop/gaesup-world (22 stars, last pushed 1mo ago), licensed MIT. It adds 1,958 tokens to every session, about $0.0078 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-09-06.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,461 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,750 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens