Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/hyeonsangjeon/repolis/agents-mdgit clone --depth 1 https://github.com/hyeonsangjeon/RepolisWrote 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.
[](https://agentmods.dev/instructions/hyeonsangjeon/repolis/agents-md)<a href="https://agentmods.dev/instructions/hyeonsangjeon/repolis/agents-md"><img src="https://agentmods.dev/badge/instructions/hyeonsangjeon/repolis/agents-md.svg" alt="Measured on agentmods" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.06159 | $0.06159 |
| Opus 5 | $0.03080 | $0.03080 |
| Sonnet 5 | $0.01232 | $0.01232 |
| Haiku 4.5 | $0.00616 | $0.00616 |
Grade A, and why
Repolis AGENTS.md scanned grade A with 1 finding 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 today.
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.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
| **`examples/`** | Copy-paste recipes (curl the worker, share links, embed). | Learning the public surface fast. | How it starts
The opening of the file, as written. The whole thing — 226 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md — operating manual for AI agents working on Repolis
You are an AI agent. Read this once and you can run, change, verify, and ship Repolis correctly. Repolis is a zero-build static 3D "city of repos" web app. Humans get
README.md; this file is the machine-readable contract. If something here disagrees with a comment in code, trust this file and flag it.
- Live: https://hyeonsangjeon.github.io/Repolis/
- What it is:
index.htmlis the primary Three.js runtime for a walkable town built from public GitHub repos; local modules and generated assets provide the World Tree, scholars, Council, and data. Gitber + star-named scholar NPCs answer questions and guide visitors through it. - Owner / required git identity:
Hyeon Sang Jeon <[email protected]>· GitHubhyeonsangjeon - License: MIT
⏱️ 60-second quickstart (no build, no install)
git clone https://github.com/hyeonsangjeon/Repolis && cd Repolis
python3 -m http.server 8000 # any static server works (npx serve . etc.)
# open http://localhost:8000 → walk the city with WASD, click the 🚕 to ask the taxi
There is no build step, no bundler, no package.json, no npm install. The page boots from a
CDN import map (Three.js r0.160 via jsDelivr) plus local data, scripts, and modules served as static files.
🗺️ Repository map (what lives where)
| Path | What it is | Touch it when… |
|---|---|---|
index.html |
Primary app runtime — 3D engine, UI, navigation, residents, exploration, i18n, day/night. | Any UI / gameplay / client behavior change. |
repolis.config.js |
Fork-facing runtime identity and optional-service policy. GitHub Pages infers the fork owner; upstream Workers stay off on forks. | Changing owner inference, template behavior, or canonical endpoints. |
repos.json + data/city-state.json |
Generated repo catalog plus deterministic era, season, current statistics, Silence Ledger, bounded 30-day Sap Ledger, sap timestamp, and archived roots for the current owner city. Do not hand-edit. | Never directly; regenerate (see below). |
data/city-state.schema.json |
Strict JSON Schema for the generated city-state artifact. | Changing the city-state contract. |
assets/city-time.js |
Pure wear (recent / faded / mossed), ruin, reference-date, and seasonal palette rules. |
Changing how public time metadata affects the city. |
data/lore/fragments.json + assets/lore-fragments.js |
Hand-authored KO/EN elder fragments plus strict validation, deterministic active-roster allocation, and session-bounded delivery. | Changing The Silence fragments or their rarity/allocation contract. Never generate or overwrite the JSON. |
assets/taxi-voice.js |
Pure local taxi Shared-state answers, household redirect, and once-per-ride seasonal/district observations. | Changing travel voice without adding a backend call. |
assets/session-footprints.js |
Pure bounded current-tab footprint ring: movement threshold, lifetime, LOW_END/reduced-motion policy, and teardown. | Changing the local player's ephemeral walking trace. |
assets/procedural-surfaces.js |
Pure facade/roof seed, UV phase, family, and bounded-cache contract for the shared procedural maps. | Changing repository-house material identity, tiling, or texture budgets. |
scripts/fork_lineage.py + assets/fork-lineage.js |
Public-only fork source sanitizer plus deterministic six-color crest projection. | Changing generated fork source truth, lineage cards, or the shared crest batch. |
scholars.js |
window.SCHOLARS roster: POLARIS · VEGA · RIGEL · MIRA · LYRA. |
Adding / editing an NPC scholar. |
assets/world-tree/createRepolisHero.js |
Procedural World Tree factory imported by index.html. |
Changing the tree geometry, materials, sockets, or actions. |
assets/world-tree/world-tree-state.js |
Pure projection for Chronicle, Silence Ledger, 30-day Sap Ledger, Roots, sap-flow freshness/mode, bounded star/repo growth, and portable public-town residents. | Changing how owner or normalized public-town state reaches the silent World Tree and local resident roster. |
assets/repo-portal.js |
Pure username/repository parser, route precedence, public projection, canonical Plaza/Portal/Atelier/Blueprint links, and owner-town expansion link. | Changing ?repo=, ?view=plaza&lang=en, ?view=atelier&lang=en, accepted GitHub inputs, public traffic truth, or target/path share links. |
assets/repository-atelier-chat.js + cloudflare-taxi/src/repository-atelier.js |
Pure visit-scoped five-call chat state plus strict exact-owner/repo GitHub MCP request and reference boundaries. |
Changing Repository Atelier chat lifecycle, limits, payloads, or grounding scope. |
assets/repository-blueprint.js |
Pure exact-repository GitHub Tree request boundary plus deterministic bounded source-tree projection. | Changing Repository Blueprint validation, request, cache, node, edge, depth, or layout rules. |
assets/repo-route.js |
Pure 2–3 stop route validator, current-catalog resolver, conflict policy, and canonical Repo Route URL. | Changing visitor-curated multi-repo paths or ?route= links. |
assets/contribution-quests.js |
Pure current-owner/catalog issue projector and bounded quest ranker. | Changing Open Source Quest validation, tier priority, or result diversity. |
assets/issue-code-scout.js |
Pure exact-repo Quest title/label to loaded Blueprint path candidate matcher. | Changing Scout tokenization, scoring, ordering, caps, or fail-closed path rules. |
assets/town-growth.js |
Pure repo-creation timeline, year snapshot, and Growth Replay share-link logic. | Changing historical cutoffs, unknown-date policy, or ?growth= links. |
assets/town-creator.js |
Pure allowlisted public-profile + town-repo summary for Creator Hall. | Changing creator facts, badges, signature-repo ranking, or avatar safety. |
assets/twin-towns.js |
Pure public-repo comparison and reversible Twin Towns link builder. | Changing the two-person referral bridge or its URL contract. |
scripts/build_repos.py |
Rebuilds repos.json and data/city-state.json from data/logs/* traffic + gh api. |
Refreshing the city data locally. |
scripts/resident_profiles.py + data/residents/ |
Generates sanitized public resident profiles, the boot manifest, and the Worker authority registry. Profile JSON is generated — do not hand-edit. | Changing repository-bound resident identity or Shared/Bound inputs. |
scripts/smoke.mjs |
Hermetic static and behavioral regression guards for the city runtime. | Any client feature, navigation, or generated-module integration change. |
scripts/test-visual-governor.mjs |
Extracts and deterministically replays the inline adaptive visual-governor core. | Changing warm-up, thresholds, hysteresis, dwell, LOW_END/reduced-motion bounds, or recovery. |
scripts/test-procedural-surfaces.mjs |
Hermetic seed, UV, family, bounded-cache, pixel-hash, and disposal fixtures. | Changing procedural facade/roof helpers or cache limits. |
scripts/test-portable-town.mjs |
Deterministic fixtures for canonical, foreign, empty/archive-only, partial, missing-date, leakage, resident-cap, and zero-request portable towns. | Changing public-town projection or local resident derivation. |
.github/workflows/refresh.yml |
"Refresh Repolis data" — daily Action that regenerates repos.json and pushes chore: refresh. |
CI / data-refresh changes. |
scripts/build-contribution-library.mjs + assets/contribution-library.json |
Generates the in-app Contribution Library JSON from the sibling Hyeonsang-AI-Contributions README (KO/EN); index.html fetches it at runtime. JSON is generated — do not hand-edit. Daily via .github/workflows/update-contribution-library.yml. |
Changing the library landmark's data/source. |
cloudflare-taxi/ |
The live AI backend — Worker repolis-taxi (src/grounded.js): grounded repo/docs Q&A + in-persona chat. |
Grounding / scholar answer logic. |
cloudflare/ |
Realtime presence Worker repolis-rt (multiplayer avatars + visitor counter). |
Realtime/multiplayer changes. |
party/ + partykit.json |
PartyKit realtime server (alternative to cloudflare/). |
Forks that prefer PartyKit. |
api/taxi.js, api/taxi-grounded.js |
Optional Vercel functions — fork-only alternatives to the Worker. | Only if maintaining the Vercel path. |
council/ |
Kronos Council deterministic decision engine + hermetic tests. | The debate/verdict feature. |
docs/ |
Agent-facing specs, known limitations, and archived release history. | Understanding the data/feature model or historical context. |
examples/ |
Copy-paste recipes (curl the worker, share links, embed). | Learning the public surface fast. |
README.md / README.ko.md |
Human docs (EN / KO). | User-facing narrative. |
SCHOLARS.md |
Human roster of the scholar NPCs. | Documenting a new scholar. |
llms.txt |
One-page LLM index of this project. | Keep links in sync on big changes. |
repolis.yaml |
Machine-readable project manifest. | Entry points / deploy targets change. |
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.
- today Changed · +8 lines · +467 tokens per session 2c5dc94312c6
- 4d ago First seen · 218 lines · 5,692 tokens per session scan A e02eeed555a4
Repolis AGENTS.md is an instructions file published in the GitHub repository hyeonsangjeon/Repolis (21 stars, last pushed today), licensed MIT. It adds 6,159 tokens to every session, about $0.0308 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
dcc-mcp-blender AGENTS.md
Instructions for dcc-mcp/dcc-mcp-blender, covering agents.md — dcc-mcp-blender agent navigation map, agent control path, cli availability and updates, 30-second summary and quick start (3 lines).
dcc-mcp-blender CLAUDE.md
Instructions for dcc-mcp/dcc-mcp-blender, covering what this project does, claude desktop configuration, progressive loading — important for claude, claude-specific tips and quick test prompts.
dcc-mcp-blender GEMINI.md
Instructions for dcc-mcp/dcc-mcp-blender, covering gemini.md — google gemini / vertex ai integration guide, what this project does, gemini-specific strengths, 1. skill script generation and 2. structured tool results.
mcp-server-starter AGENTS.md
AGENTS.md instructions for starter-series/mcp-server-starter, covering agents.md, project structure, adding a new tool, adding a new prompt and safety annotations.
ai-news-agent AGENTS.md
AGENTS.md instructions for nickzren/ai-news-agent, covering ai news agent, purpose, preferred agent flow, defaults and status artifacts.
ziyuanzhan AGENTS.md
Instructions for aidizhi/ziyuanzhan, covering agents.md, project overview, architecture, tech stack and always do.