You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
| G-0 | Whenever unsure about something that's related to the project, ask the developer for clarification before making changes. | ❌ Write changes or use tools when you are not sure about something project specific, or if you don't have context for a particular feature/decision. |
27
-
| G-1 | Generate code **only inside** relevant source directories (e.g., `agents_api/` for the main API, `cli/src/` for the CLI, `integrations/` for integration-specific code) or explicitly pointed files. | ❌ Touch `tests/`, `SPEC.md`, or any `*_spec.py`/ `*.ward`files (humans own tests & specs). |
27
+
| G-1 | Generate code **only inside** relevant source directories (e.g., `agents_api/` for the main API, `cli/src/` for the CLI, `integrations/` for integration-specific code) or explicitly pointed files. | ❌ Touch `tests/`, `SPEC.md`, or any `*_spec.py` files (humans own tests & specs). |
28
28
| G-2 | Add/update **`AIDEV-NOTE:` anchor comments** near non-trivial edited code. | ❌ Delete or mangle existing `AIDEV-` comments. |
29
29
| G-3 | Follow lint/style configs (`pyproject.toml`, `.ruff.toml`, `.pre-commit-config.yaml`). Use the project's configured linter, if available, instead of manually re-formatting code. | ❌ Re-format code to any other style. |
30
30
| G-4 | For changes >300 LOC or >3 files, **ask for confirmation**. | ❌ Refactor large modules without human guidance. |
@@ -41,8 +41,8 @@ Use `poe` tasks for consistency (they ensure correct environment variables and c
*Forgetting to use pytest fixtures properly or mixing test framework patterns.
211
211
* Forgetting to `source .venv/bin/activate`.
212
212
* Wrong current working directory (CWD) or `PYTHONPATH` for commands/tests (e.g., ensure you are in `agents-api/` not root for some `agents-api` tasks).
213
213
* Large AI refactors in a single commit (makes `git bisect` difficult).
@@ -258,7 +258,7 @@ This section provides pointers to important files and common patterns within the
258
258
***Execution**: The runtime instance and state of a task being performed by an agent. Core model in `typespec/executions/models.tsp`.
259
259
***POE (PoeThePoet)**: The task runner used in this project for development tasks like formatting, linting, testing, and code generation (configured in `pyproject.toml`).
260
260
***TypeSpec**: The language used to define API schemas. It is the source of truth for API models, which are then generated into Python Pydantic models in `autogen/` directories.
261
-
***Ward**: The primary Python testing framework used for unit and integration tests in most components (e.g., `agents-api`, `cli`).
261
+
***Pytest**: The primary Python testing framework used for unit and integration tests in all components.
262
262
***Temporal**: The distributed workflow engine used to orchestrate complex, long-running tasks and ensure their reliable execution.
263
263
***AIDEV-NOTE/TODO/QUESTION**: Specially formatted comments to provide inline context or tasks for AI assistants and developers.
0 commit comments