docs: Add agent goals to CRUSH.md

Author: stuagano

CRUSH.md

@@ -0,0 +1,65 @@
+# ADK CRUSH.md
+
+This file contains commands and style guidelines for the ADK project.
+
+## Testing
+
+Run all unit tests:
+`pytest tests/unittests`
+
+Run a single test file:
+`pytest tests/unittests/path/to/test_file.py`
+
+Run a single test function:
+`pytest tests/unittests/path/to/test_file.py::test_function`
+
+## Linting and Formatting
+
+Run the autoformatter:
+`./autoformat.sh`
+
+Run the linter:
+`pylint --rcfile=pylintrc src/`
+
+Run the type checker:
+`mypy --config-file=pyproject.toml src/`
+
+## Code Style
+
+- Follow the Google Python Style Guide.
+- **Indentation**: 2 spaces.
+- **Line Length**: 80 characters.
+- **Naming Conventions**:
+  - `function_and_variable_names`: `snake_case`
+  - `ClassNames`: `CamelCase`
+  - `CONSTANTS`: `UPPERCASE_SNAKE_CASE`
+- **Docstrings**: Required for all public modules, functions, classes, and methods.
+- **Imports**:
+  - Use relative imports within the `src/google/adk` directory (e.g., `from ..agents.llm_agent import LlmAgent`).
+  - Use absolute imports in tests (e.g., `from google.adk.agents.llm_agent import LlmAgent`).
+  - Always include `from __future__ import annotations` at the beginning of each file.
+- **Error Handling**: Catch specific exceptions, not general ones like `Exception`.
+
+## Refactoring Guidelines
+
+- When removing a feature, ensure that all related components are removed, including:
+  - Services
+  - API endpoints
+  - Models
+  - UI elements
+  - Documentation
+- When switching from a local execution to a containerized deployment, ensure that the `Dockerfile` and `run.sh` scripts are updated accordingly.
+- When deploying to a new platform, ensure that the `cloudbuild.yaml` file is updated to reflect the new deployment target.
+
+## Agent Goals
+
+- Showcase the full power and capabilities of the ADK.
+- Provide a local ADK development environment for customers to experiment with.
+- Offer a guided walkthrough of all ADK features.
+- Demonstrate the integration between ADK and a Streamlit frontend.
+- Provide a clear path to deploying the agent to Cloud Run within a customer's VPC.
+
+
+
+
+