# JCOM and Conquer: Design Hub

Welcome to the JCOM and Conquer design hub repository and documentation node.

This repository provides game architecture, design standards, and service skills for JCOM and Conquer.
It serves as the hosted reference node for automated tools, language models (such as ChatGPT), and human contributors.

## Purpose

The owner stated on 2026-10-20:
- "new repo is _design make sure our game architecture, standards for everything are included."
- "I need a hosted node that i can point chatgpt at so it knows what to design for"
- "our design reference should point to it"

This hub gathers all standards into one place.
It publishes a static website for web browsers and language models.
Language models should start by reading [`llms.txt`](llms.txt) and [`llms-full.txt`](llms-full.txt).

## Standard Repositories

The design system splits rules across specialized repositories under the `z4yin` organization:

| Repository | Visibility | Role & One-Line Purpose |
|---|---|---|
| `jcom_v0bb_simulation_design_standards_units` | PRIVATE | Unit coordinate frames, dimensions, node naming, joints, and clip rules. |
| `jcom_v0bb_simulation_design_standards_maps` | PRIVATE | Map cell grid scales, heightmaps, theatres, terrain layers, and water rules. |
| `jcom_v0bb_simulation_design_standards_logic` | PRIVATE | Simulation tick rate, lockstep determinism, clean-room rules, and mechanics. |
| `jcom_v0bb_simulation_design_standards_geometry` | PRIVATE | Mesh topology, triangle budgets, LOD derivation, and geometry validation. |
| `jcom_v0bb_simulation_design_standards_lookdev` | PRIVATE | PBR materials, textures, texel density, lighting, tone mapping, and colour. |
| `jcom_v0bb_simulation_design_standards_blueprints` | PRIVATE | US Navy / US military, third-angle projection, Navy A1 facility sheet, JSLC STD-1 look (standard 0.3.0). |
| `jcom_v0bb_simulation_svc_skills` | PRIVATE | Tooling skills, asset creation procedures, review rubrics, and workflows. |

## Core Documents

- [`ARCHITECTURE.md`](ARCHITECTURE.md): The overall game architecture, engines, data flow, rendering, and deployment.
- [`REPOS.md`](REPOS.md): Complete catalog of simulation repositories, naming conventions, and visibility rules.
- [`OPEN-DECISIONS.md`](OPEN-DECISIONS.md): Master roll-up of all open decisions across the standard repositories, with owner decisions marked DECIDED.
- [`site/`](./): The static site tree deployed to Cloudflare Pages for human and model browsing.
- [`scripts/build-site.mjs`](scripts/build-site.mjs): Rebuilds `site/` deterministically from the standard repositories.

## Machine Reading

- [`llms.txt`](llms.txt): Machine index following the llmstxt.org standard. It lists what to read first.
- [`llms-full.txt`](llms-full.txt): Complete concatenated text of all repository README files for single-file ingestion.

## Contributing Rules

1. Write in plain controlled language (about 80% ASD-STE100).
2. Keep sentences short and clear. Use active voice.
3. Make no direct edits to standard repositories from this hub.
4. Scan all files for secrets, tokens, keys, and private network addresses before deployment.
5. All commits use the author identity: `Eli Kopter <eli@jewishspacelasercommand.com>`.
6. Rebuild and redeploy the hub after any push to a standard repo.