Concrete Coordinate System for Software Artifacts

Modern software systems have grown to a scale where developers frequently lose their sense of location and direction within a codebase. Existing tools such as language servers, dependency analyzers, and AST-based representations provide partial structural information but lack a unified notion of absolute position. This paper introduces the Concrete Coordinate System (CCS), a geometric framework that embeds software artifacts into a fixed-dimensional Euclidean space using only their concrete structure: file paths, syntactic forms, and dependency relations. CCS assigns each artifact an absolute coordinate, enabling modifications to be represented as direction vectors in this space. Building on this representation, we propose a directional anomaly detection model that identifies structurally inconsistent or harmful changes based on angular deviation, magnitude, dependency reversal, and cluster displacement. We further present an OS-level integration model that provides real-time tracking of position, direction, and structural flow within a codebase. CCS establishes the foundation for Code Geometry, a new research domain that unifies software engineering and geometric representation, and offers a principled solution to directional disorientation in large-scale development.