Spath and Splan
2 days ago
- #Code Abstraction
- #Semantic Addressing
- #AI Programming Tools
- The filesystem has historically been used to organize code, aligning with programming language scopes, but it forces AI agents to operate at a low abstraction level.
- AI agents can work at any abstraction layer, yet current tools still require them to interact with the filesystem, replicating human programming rituals.
- Narrative hygiene involves identifying an ideal narrative for an intention and optimizing toward it, leveraging that narrative is the native language of LLMs.
- Spath is a semantic addressing format that allows AI agents to reference programming language symbols, eliminating filesystem operations and improving narrative hygiene.
- Spath is designed as a general symbol address schema with dialects for various languages like Go, Rust, Python, TypeScript, Swift, and Kotlin.
- Spath Go is a dialect for Go that has been extensively used, with flexibility for fine-grained addressing or minimal dialects depending on needs.
- Splan is a grammar for expressing batched code operations with content, where spath is the noun and splan is the sentence, enabling transactional plans without filesystem details.
- Splan operations are transactional, ensuring all succeed or none apply, preventing half-mutated states and reducing recovery narratives in coding sessions.
- Spath and Splan are open-sourced with licenses like CC BY 4.0, encouraging broader adoption and dialect development by the community.
- These tools represent steps toward better narrative hygiene for coding agents, with ongoing developments and community engagement anticipated.