ByteBiota Wiki Home
ByteBiota Wiki Home¶
How to Use This Wiki¶
- Start Here: Read
project-overview.md
for a high-level summary of ByteBiota goals, scope, and stakeholders. - Navigation Tips: Follow the section pages below; each subsection corresponds to a dedicated Markdown file organized in logical subdirectories.
Core Concepts¶
core/simulation-foundations.md
β Simulation philosophy, guiding principles, success metrics.core/system-architecture.md
β High-level diagrams, core services, data flow, and deployment topology.core/technology-stack.md
β Languages, frameworks, tooling, dependencies, and versioning policy.core/evolution-dynamics.md
β Digital evolution principles, troubleshooting guide, and configuration best practices.
Simulation Mechanics¶
simulation/world-model.md
β Spatial/temporal resolution, environmental layers, resource systems, and global rules.simulation/entity-lifecycle.md
β Creation, reproduction, death, and persistence rules for entities.simulation/interaction-models.md
β How entities interact (competition, cooperation, communication) and conflict resolution.simulation/event-processing.md
β Tick/update loop, scheduling, randomness, and determinism controls.simulation/ai-behavior.md
β Decision-making algorithms, behavior trees, reinforcement learning policies, tuning knobs.simulation/opcode-reference.md
β Full instruction set listing, opcode families, and alias mapping.simulation/seed-bank.md
β Seed retention policy, taxonomy metadata, reserve guarantees, and checkpoint audits.
Taxonomy & Biology¶
biology/taxonomy-overview.md
β Classification scheme, terminology, and naming conventions.biology/species-profiles/
β Individual Markdown files per species describing traits, abilities, habitats, and evolution paths.biology/traits-and-mutations.md
β Trait definitions, mutation rules, heritability, and balancing notes.biology/ecosystem-dynamics.md
β Food webs, population dynamics, resource regeneration, and disequilibrium scenarios.
Data & Analytics¶
analytics/data-pipelines.md
β Logging strategy, telemetry, ETL jobs, storage formats, and retention policy.analytics/metrics-and-observability.md
β Key performance indicators, dashboards, alerting, and health checks.analytics/experiment-playbooks.md
β How to design, run, and evaluate simulation experiments.analytics/scripts.md
β CLI utilities, dashboards, and analysis tooling built atop the core simulator.
Architecture & Infrastructure¶
architecture/distributed-architecture.md
β Worker/server payloads, aggregation, and distributed metrics schema.architecture/hybrid-tuning.md
β Discovery, authority, policies, and operational playbooks for the hybrid tuning subsystem.
User Interface & APIs¶
interface/ui/ui-ux-overview.md
β Interface patterns, wireframes, and accessibility considerations.interface/ui/ui-components.md
β UI system architecture, components, and integration with distributed server.interface/ui/web-styling-guide.md
β Comprehensive design system and styling conventions for the web interface.interface/ui/icon-system.md
β Procedural icon generation system for organism visualization.interface/ui/memory-map.md
β Real-time soup memory visualization system.interface/api-reference.md
β Public APIs, endpoints, authentication, rate limits, and sample requests.interface/scenario-authoring.md
β How to author custom scenarios, scripts, or mods.
Operations & Maintenance¶
operations/deployment/deployment-guide.md
β Environment setup, CI/CD pipelines, release process, rollback strategy.operations/deployment/worker-build-process.md
β Worker binary build process, SSL/TLS configuration, and distribution.operations/runtime-operations.md
β Monitoring, scaling, backups, SLAs, incident response.operations/security-and-compliance.md
β Threat model, access controls, auditing, and compliance requirements.operations/testing.md
β Comprehensive testing guide including unit tests, integration tests, and User Acceptance Tests (UAT).operations/environment.md
β Complete reference for all environment variables used throughout the system.operations/configuration-tuning.md
β Parameter tuning guide for simulation stability and evolution dynamics.operations/checkpointing.md
β Checkpointing operations, state restoration, and troubleshooting guide.operations/distributed-quickstart.md
β Step-by-step server/worker smoke test for contributors.
Planned upgrades¶
planned-upgrades/auto-upgrade.md
β Worker distribution roadmap and packaging-first rollout plan.planned-upgrades/worker-self-update.md
β Staged rollout plan for automated worker updates.
Project Management¶
project/working-agreements.md
β Team norms, code review expectations, decision-making process.project/roadmap.md
β Near-term milestones, long-term vision, and dependency tracking.project/change-log.md
β Summary of major simulation changes and historical context.project/references.md
β External research papers, datasets, and inspiration sources.
Quick Reference¶
glossary.md
β Canonical definitions for domain-specific terms.faq.md
β Common questions from devs, scientists, and stakeholders.
Tip: Keep pages short and link richly to maintain discoverability. Update this home page whenever new sections are added.