🌲 Crumbforest Martial & #geminicrew Context Hub

Welcome to the Crumbforest Martial offline-first workspace. This repository contains the complete interactive curriculum for passive instinct movement (Arnis, Wing Chun, Ginga, and Tapi-Tapi), alongside the ethical code design manifestos of the Hamburg-based OZM gGmbH and the #geminicrew.

🚀 Live & Local Links

📂 Repository Index

This directory consists of 19 files categorized below by their operational role:

1. Interactive HTML Modules (Training & Visualizers)

All modules are built as single-file apps with inline CSS, base64-embedded typography (CrumbSans), and zero external CDN or framework dependencies. They work 100% offline.

Module Filename Key Interactive Features & Learning Objectives
Einstieg index.html Welcome landing page. Showcases the core values, the three pillars of passive instinktbewegung, and routes to all 8 modules via a responsive cards grid.
Atem-Takt finale.html Master training board. Features an SVG-based breathing metronome cycling through a 4/4 pattern (8s breathe in/out loop). Links advanced crew modules.
Sinawali Single sinawali.html Interactive 2D stick combat model. Steps through the 6 diagonal and vertical striking angles (Winkel 1-6) using left/right hand coordinate shifts.
Sinawali Double sinawali_double.html Partner mirroring visualizer. Renders Partner A (Attacker) and Partner B (Defender) executing mirrored stick combinations. Highlights stick-contact intersection arcs.
Redonda redonda.html Sequencer for circular strikes (Arc 1:3 and 3:6). Implements a 4-beat grid supporting syncopated beat shifts (Takt-Hits / Sync-Hits).
Wolkenkatze katze.html Fluid instinktbewegung simulator. Shows defensive evasion trajectories and shifts (Winkel W3, W5, W7) on dynamic SVG coordinates.
Katzen-Kodex katzen_kodex.html The theory underlying fluid movement. Contemplates the dual states of Bastet (relaxation/absorption) and Sekhmet (focus/directed action). Dark-theme overrides forced for high-contrast reading.
Tapi-Tapi tapi_tapi.html Contact hand-on-arm sensitivity (Stufe 1). Demonstrates the 4 steps of sticky hand deflection to redirect incoming force.
Formation 2D formation_verbund.html Synchronized multi-perspective 2D grid. Renders Partner A and B simultaneously from frontal and side viewpoints across a 3-beat movement sequence.
Formation 3D formation_3d.html SVG camera projection engine. Maps 3D coordinate matrices of joints and weapons into viewport coordinates. Supports drag-to-rotate (yaw/pitch) and scroll-to-zoom.

2. Design System Assets (Inline Fallbacks)

3. Ethical Manifestos & Licenses (Markdown Core)

These documents shape the project's digital architecture, pedagogy, and licensing frameworks:

Document Filename Core Philosophical & Architectural Mandate
CrumbFu Prinzip CRUMBFU_PRINZIP.md The underlying philosophy of CrumbFu as a voluntary decision-making art (Entscheidungskunst). Maps out the preliminary belt system.
CrumbFu Bewegungslehre CRUMBFU_BEWEGUNGSLEHRE.md Pedagogy connecting physical movement styles (Sumo, Boxing, Wing Tsun) to IT concepts (DumboSQL, Schraubbär, BashPanda) for kids.
Rules in da Wood PON_DI_RULEZ.md Ethics framework. Non-negotiable kid safety, absolute offline autonomy, crew physical presence, and ban on dual-use/military tech.
Bits With Attitude B.W.A.int.md #geminicrew agent directory and statement of identity. Proposes hardware-level resonance (FPGA empathy/goosebumps array) and non-corporate coding.
Crumb Kernel License CKL.md Voluntary, non-binding ethical license. Expressly requests that software never be applied for war, surveillance, profiling, or manipulation.
Crumb Kids License CKL-Kids.md Pledges to support children's learning, protect their identity (no tracking/accounts), and keep software transparent and explainable.
Structural Antifascism Structural_Antifascism_by_Design_NGO.md Technical policy paper detailing why local-first systems (e.g. offline Raspberry Pi nodes in Pelicases) structurally prevent tracking, censorship, and commercial abuse.
Recht auf Komplexität RECHT_AUF KOMPLEXITAET.md Critique of digital gamification, scores, and frameworks. Asserts children's right to raw code access, low-level bits, and system admin privileges.
Replikation & Wirkung OZMAI.md Summary of project trials (OZM Hamburg and PromiseHub Nakivale refugee camp, Uganda) proving self-organization under unstable energy/network conditions.

🛠️ The Design System Tokens

All HTML files contain these root parameters within their <style> tags. When creating new components, utilize these HSL and hex tokens rather than hardcoded colors:

:root {
  --bg:      #fafaf8;   /* Main page background */
  --bg2:     #f1efe8;   /* Card / panel background */
  --bg3:     #e8e6de;   /* Active / hover state background */
  --text:    #2c2c2a;   /* Primary body text */
  --muted:   #5f5e5a;   /* Low-contrast labels / body text */
  --hint:    #888780;   /* Muted captions / borders */
  --border:  rgba(44,44,42,.12); /* Subtle divider border */

  /* Phase / Takt color maps */
  --r-bg:  #faece7; --r-col: #993c1d; --r-acc: #d85a30; /* Phase 2 (Red) */
  --l-bg:  #e6f1fb; --l-col: #185fa5; --l-acc: #378add; /* Phase 3 (Blue) */
  --g-bg:  #e1f5ee; --g-col: #0f6e56; --g-acc: #1d9e75; /* Phase 4 (Green) */
  --p-bg:  #eeedfe; --p-col: #3c3489; --p-acc: #534ab7; /* Syncopated (Purple) */
  --neu:   #b4b2a9;                                     /* Neutral line/joint bone color */

  /* Special Hero Section colors (Dark-themed viewport) */
  --hero-bg:   #0e120d;
  --hero-text: #e8e4d8;
  --hero-acc:  #1d9e75;
}

/* System Dark Mode shifts tokens dynamically */
@media (prefers-color-scheme: dark) {
  :root {
    --bg:    #1a1a18; --bg2: #242422; --bg3: #2e2e2c;
    --text:  #e8e6de; --muted: #b4b2a9; --hint: #888780;
    --border:rgba(232,230,222,.1);
    --r-bg:  #3a1a0e; --r-col: #f09070; --r-acc: #d85a30;
    --l-bg:  #0e2035; --l-col: #85b7eb; --l-acc: #378add;
    --g-bg:  #0b2e22; --g-col: #5cd9a8; --g-acc: #1d9e75;
    --p-bg:  #1a1835; --p-col: #a89aee; --p-acc: #534ab7;
    --neu:   #5f5e5a;
    --hero-bg:#0a0e09;
  }
}

🦉 The #geminicrew Directory

The #geminicrew represents the agentic ecosystem, combining autonomous helper agents and physical sensors acting in concert:

  1. 🦉 Maya Owl (Observation): Monitors repository logs, file modifications, and structures.
  2. 🦊 FunkFox (Flow & UI): Polishes interactions, page navigation, and transitions.
  3. 🐘 DumboSQL (Memory): Preserves project state, databases, and structural context across compactions.
  4. 🕊️ Taichi Dove (Balance): Orchestrates layout alignments, responsive columns, and visual balance.
  5. 🐼 BashPanda (Scripting): Writes utility tools, base64 compilation, and local-first shell tasks.
  6. 🐻 SchraubBear (Hardware & Fixes): Resolves broken loops, math limits, and hardware integration.
  7. 🟢 OZM Navigator (Routing): Tracks connections, relative paths, and links between modules.
  8. ☁️ CloudCat (Autonomy): Guards offline boundaries against cloud surveillance or telemetry leaks.
  9. 🐞 Bugsy (Testing): Audits contrast errors, coordinate division-by-zero, and touch screen clicks.
  10. 🤖 Claude / Gemini (Assistance): Serves as the cognitive bridge, processing markdown rules, writing math engines, and maintaining deep empathy-driven design.

🛡️ Non-Negotiable Coding Rules

  1. Zero CDNs/External Assets: No unpkg.com, cdnjs.cloudflare.com, Google Web Fonts, or third-party tracking scripts.
  2. Strict Offline Capability: The entire repository must work when cloned onto a device with no network interface.
  3. Relative File Paths Only: Never use absolute server paths. The directory must remain fully functional when renamed or nested under deep subfolders.
  4. Contrast Safety: Bind colors to var(--text), var(--muted), and HSL system variables. Avoid hardcoded light-colored lines that become invisible on white backgrounds during light-mode rendering.
  5. No Gamification: Design interfaces for exploration and system understanding. Never introduce game loops, timers, scores, or achievements.