feat: expand documentation in index.md with principles and benefits for users and contributors

Author: dataGriff

docs/index.md

@@ -2,4 +2,36 @@
 
 ## Principles
 
-test test 1
+1. Identify and empathise with all audience perspectives on the codebase - contributors, users, operators, AI agents, Build agents.
+2. Provide specific interfaces for each audience perspective.
+3. Ensure each audience interface is clean and remains maintainable.
+4. Provide a consistent abstraction over languages and frameworks.
+5. Provide a codebase experience that can be replicated by any audience, anywhere and on any platform.
+6. Do not be constrainted by current technology and tools - provoke change to how we would like to interact with codebases over current constraints.
+7. Utilise cross platform and cross IDE tools and technologies to provide the interfaces.
+8. Empathise with your own future self who could become any of the audience perspectives at any time.
+
+## Benefits
+
+Benefits can be broken down per codebase audience type as they have been defined up-front. This is a benefit in itself as it allows to be considerate and then specific about the needs of each audience.
+
+### Users
+
+- Users expect to interact with the codebase via a specific entry point that is the README.
+- Users get a consistent experience across codebases and have expectations that can either be met or missed.
+- Users understanding when expectations are missed promotes feedback and improvement.
+- Users should be able to interact with the service based on the good user interface provided by the codebase.
+
+### Contributors
+
+- Contributors expect to interact with the codebase via a specific entry point that is the README.
+- Contributors get a consistent experience across codebases and have expectations that can either be met or missed.
+- Contributors understanding when expectations are missed promotes feedback and improvement.
+- Contributors should be able to make changes to the code base based on the good contributor interface provided by the codebase.
+
+### Operators
+
+### AI Agents
+
+### Build Agents
+