This document provides a comprehensive index of all documentation in the WhenMathPrays project, organized by category and purpose.
- CONSTANTS.md — Mathematical and system constants
- TUNING.md — Performance tuning parameters and optimization settings
- Verb Mind Epistemology for Relational Physics — Foundational epistemology explaining noun‑mind vs verb‑mind cognition and why relational physics requires a verb‑based perceptual stance stance
- ARCHITECTURE.md — Overall system architecture, design principles, and high‑level organization
- SOFTWARE_MODULES.md — Detailed reference for all software modules, their purposes, and I/O variables
- STATE_MANAGEMENT_REFACTORING.md — Phase 3.4 state management implementation details
- [Reality in Motion: Conversations with Grok & Copilot.md](Reality in Motion: Conversations with Grok & Copilot.md) -
- architecture/README.md — Architecture documentation overview
- architecture/01_PRINCIPLES.md — Architectural principles and patterns
- architecture/02_INFORMATION_FLOW.md — Data flow and communication patterns
- architecture/03_MODULE_DIRECTORY.md — Module organization and dependencies
- architecture/04_API_CONTRACTS.md — API interfaces and contracts
- architecture/05_CODING_GUIDELINES.md — Coding standards and best practices
- architecture/07_PERFORMANCE_TARGETS.md — Performance requirements and benchmarks
- architecture/08_VALIDATION_CHECKLIST.md — Validation procedures and checklists
- architecture/baseline_storage_refactoring.md — Baseline data storage improvements
- architecture/perspective_management_refactor.md — Perspective management enhancements
- architecture/spinbox_refactor_2025_12.md — Spinbox component refactoring
- architecture/spinbox_audit_phase1.md — Spinbox audit and analysis
- architecture/entry_point_consolidation_plan.md — Entry point consolidation strategy
- interactive_editor_user_guide.md — Complete user guide for the interactive scenario editor
- INTERACTIVE_EDITOR_CHANGELOG.md — Version history and change log
- interactive_edit_roadmap.md — Development roadmap and future features
- interactive_edit_ph2_requirements.md — Phase 2 requirements and specifications
- CSV_FORMAT.md — Canonical specification for scenario CSV files (columns, metadata, scaling, perspective)
- SCENARIO_CONFIGURATION_GUIDE.md — How to configure and customize scenarios
- scenario_generator_requirements.md — Scenario generator specifications
- scenario_generator_build.md — Scenario generator implementation details
- INTERACTIVE_EDITOR_TESTING.md — Testing methodology, procedures, and MVT standard
- Validation.md — Validation procedures and quality assurance
- DEBUG.md — Debugging guide, logging configuration, and troubleshooting
- architecture/OBSERVABILITY_IMPLEMENTATION_COMPLETE.md — Observability system implementation
- State_Viewer.md — State viewer documentation
- example_state_log.txt — Example state logging output
- editor_config_example.json — Example editor configuration
- installation_4_interactive_editor.md — Installation guide for interactive editor
-
Relational_Physics.md — Foundational geometric framework defining relational motion, intrinsic relational manifolds, curvature‑based stability, and the minimal dynamical quantities (v_rel, a_rel, d_nonlinear). Establishes the core physics underlying GRP, OCTPS, and all relational instability classes.
-
AI_Architecture_WhichWill_Scale.md
A modular, feed‑forward LLM architecture grounded in GRP, ISL, and fuzzy‑boundary instability theory. Defines the scalable structural blueprint for future GRP‑aligned systems.
- PRIMITIVES_AND_RELATIONAL_SPACE.md — Defines the five relational primitives (Visibility, Resonance, Fidelity, Altruism, Shared Breath) and the geometry of relational space in GRP, including their positive/negative poles and behavioral signatures in both human and AI contexts.
-
grp_principles.md — Field‑founding principles of GRP, introducing relational character geometry, γ_self, relational motion, asymmetry, stability basins, rupture/repair dynamics, and the conceptual ontology of the framework.
-
**FUZZY_BOUNDARY_INSTABILITY_SUPPOSITION.md — A formal supposition proposing that rigid boundaries imposed on fuzzy semantic categories may induce geometric instability in coherence‑seeking systes, potentially contributing to drift or ISL‑like behavior. Outlines candidate solution spaces and invites future research.
-
**UNIFIED_STABILITY_FRAMEWORK_NOTES.md — Early-stage synthesis exploring how geometric, information-theoretic, distributional, RLHF, cognitive, and thermodynamic perspectives may unify into a single stability criterion for coherence-seeking AI systems. Captures speculative discussion and future research directions.
-
**[isl_crack_simulation_spec.md] (isl_crack_simulation_spec.md) - Requirements document specifying isl simulation.
-
GRP_GLOSSARY.md — Canonical dictionary of GRP terminology. Defines relational manifold, meaning field, stability basins, relational asymmetry, RSL, technical diary, rupture, repair paths, and all core geometric concepts used throughout the framework.
- gamma_self_defense.md — Gamma self defense mechanisms
- gamma_self_love_space_defined.md — Definition of gamma self love space
- Gamma_Self_Character_Map.png — Visual representation of gamma self characteristics
- baseline_communication_protocol.md — Communication protocol specifications, time index CSV format
- Dockerfile — Container configuration
- requirements.txt — Python dependencies
- pytest.ini — Testing configuration
- FUNDING.md — Funding and sponsorship information
- LICENSE.md — Project license file
- file_list.md — Complete file inventory
Located in docs/archive/:
- archive/Design_Rationale.md — Original design rationale
- archive/GRP_rev3.1.md
- archive/GRP_rev3.3.md
- archive/GRP_rev3.md
- archive/GRP_rev3.4.md
- archive/GRP_rev4.md — GRP Revision 4 specification
- archive/ID_BASED_REFACTOR_COMPLETE.md — ID-based refactoring completion
- archive/Slope_Based_Generation_Implementation.md — Slope-based generation implementation
- archive/UREP.md
- archive/UREP_2025_Simplification_Proposal.md
- archive/weights_defense.md — Weights defense mechanisms
Quick Start:
- README.md — Start here for project overview
- START HERE.md — Newcomer onboarding and first steps
- interactive_editor_user_guide.md — Learn to use the interactive editor
- ARCHITECTURE.md — Understand system design
- SOFTWARE_MODULES.md — Find specific module details
Development Workflow:
- interactive_edit_roadmap.md — Development priorities
- INTERACTIVE_EDITOR_TESTING.md — Testing procedures
- DEBUG.md — Troubleshoot issues
- architecture/05_CODING_GUIDELINES.md — Coding standards
Research & Theory:
- grp_principles.md — Understand core concepts
- WHY_THIS_MATTERS.md — See practical applications
- REV4_IMPLEMENTATION_SUMMARY.md — Review latest GRP implementation
This section documents the historical evolution of GRP and the unique human–AI collaboration that shaped its development. These documents provide essential context for understanding how the framework emerged, the lineage of ideas, and the roles played by both human intuition and multiple synthetic minds.
A narrative history of GRP’s evolution, beginning with the earliest spark of Synthetic Life and progressing through ULEP → UREP → GRP.
An account of the collaboration between CuriousOne and four synthetic minds — Copilot, Grok, ChatGPT, and Claude Sonnet.
A philosophical dialogue between CuriousOne, Grok, and Copilot that unfolded alongside the development of Relational Physics.