docs: restructure documentation by consolidating audience and interface sections, removing outdated files, and enhancing navigation

Author: dataGriff

docs/README.md

@@ -6,6 +6,15 @@ The codebase interface is a set of principles and practices that allow us to ide
 
 By providing specific interfaces for each audience perspective, we can ensure that everyone has a clean and maintainable experience when interacting with a codebase.
 
+## Guide
+
+- [Principles](./principles.md)
+- [Audiences](./audiences.md)
+- [Interfaces](./interfaces.md)
+- [Benefits](./benefits.md)
+- [Examples](./examples.md)
+- [Tooling](./tooling.md)
+
 ## Support
 
 If your codebase uses codebase interface principles please support the initiative by starring the [Codebase Interface GitHub repository](https://github.com/codebase-interface/codebaseinterface){target="_blank"} and placing the below markdown in the README of your repo.

docs/audiences.md

@@ -0,0 +1,18 @@
+# Audiences
+
+## Users
+
+## Contributors
+
+## Operators
+
+## AI Agents
+
+## Build Agents
+
+## What's Next?
+
+Now that you understand the audiences its time to explore the interfaces designed for each audience.
+
+[← Previous: Principles](../){ .md-button }
+[Next: Interfaces →](../interfaces/){ .md-button .md-button--primary style="float: right;" }

docs/audiences/ai_agents.md

@@ -20,4 +20,7 @@ Benefits can be broken down per codebase audience type as they have been defined
 
 ## AI Agents
 
-## Build Agents
+## Build Agents
+
+[← Previous: Interfaces](../){ .md-button }
+[Next: Tooling →](../tooling/){ .md-button .md-button--primary style="float: right;" }

docs/audiences/build_agents.md

@@ -36,3 +36,6 @@
 ## Source Aligned Services
 
 TODO: Add examples of source aligned services that follow the codebase interface principles.
+
+[← Previous: Tooling](../){ .md-button }
+[Next: Welcome →](../){ .md-button .md-button--primary style="float: right;" }

docs/audiences/contributors.md

@@ -0,0 +1,34 @@
+# Interfaces
+
+## Readme
+
+- **Primary Audience**: Users
+- **Secondary Audience**: Contributors, Operators
+
+## Contributing
+
+- **Primary Audience**: Contributors
+
+## Runbook
+
+- **Primary Audience**: Operators
+
+## Changelog
+
+- **Primary Audience**: Users
+- **Secondary Audience**: Contributors, Operators
+
+## Language
+
+- **Primary Audience**: All Audiences
+
+## Agents
+
+- **Primary Audience**: AI Agents
+
+## What's Next?
+
+Now that you understand the interfaces, its time to explore the benefits of adopting the Codebase Interface principles.
+
+[← Previous: Audiences](../){ .md-button }
+[Next: Benefits →](../benefits/){ .md-button .md-button--primary style="float: right;" }