invariants**: a change that silently alters an external contract
or breaks a documented rule.
- **Test strategy**: exported behaviour — a CLI flag, public function, persisted schema,
artifact layout — landing without
NotFound, Validation, Conflict) and propagates consistent HTTP status codes via middleware.
6. Encourage tests: request unit tests for new repository logic and component tests (or at least React Testing Library
Copilot instructions for vscode-java-dependency
## UI and E2E tests
- When asked to add, update, run, or debug UI/E2E coverage, prefer the AutoTest YAML workflow under `test/e2e-plans/`.
- Use the `uitest
review priorities.
- Prefer focused, file/line-specific findings over broad style suggestions.
- Treat correctness, security, missing tests, governance-bypass, and stale spec/backlog/SSoT metadata as higher priority than formatting.
- Do not duplicate
deployment
- Active-passive or active-active configurations
- Geo-replication for data
- Defined RTO/RPO and tested DR procedures
## Cost Optimization Guidelines
**Design phase:**
- Right-size based on actual requirements, not "just
Copilot Instructions for vscode-black-formatter
## Development Guidelines
- When introducing new functionality, add basic tests following the existing repo test structure.
- Always make sure all tests pass before submitting changes
added to the solution file in the samples directory.
- The sample should be tested to ensure it works as expected.
- A reference to the new sample should be added
single source
of contributor guidance for this project — architecture, development setup, code
style, testing, and CI — and applies to Copilot exactly as written.
This file used to be a full
Follow TDD when it is possible. Always start new changes by writing new test cases (or changing existing tests).
Remember to consult [Unit and Integration Tests](./instructions/unit-and-integration-tests.instructions.md) for details
should prefer `pip3 install --user --break-system-packages` over a `venv`.
## Build, lint, and test
- Prefer Makefile targets for common workflows (e.g., `make lint`, `make lint-frontend`, `make test`, `make
fill) for consistency
- **Placeholder pattern**: Math/code use placeholders during Turndown, then restore (see `MathExtractor.generatePlaceholder()`)
## Testing Scenarios
Reference HTML files in root (`ChatGPT-Success.html`, `ChatGPT-Fail.html`, `ChatGPT-DeepResearch.html`) show:
- **Success**: Rendered KaTeX with `data
exact ingestion commit or image with the compatible GPT-RAG
umbrella/component versions;
- capture test, build, and deployment evidence appropriate to the change;
- verify rollback or roll-forward steps;
- remove personal
Consider using pattern matching, walrus operators and other new syntax features.
Adhere to pep8.
## TestsTests are written using PyTest. Dont put tests into a class.
## DocStrings
DocStrings are written
easy addition of new tools/operations. Use a registry or factory pattern for tool handlers.
- **Testing**: Use [Vitest](https://vitest.dev/) for all tests. Place tests in `tests/` and cover protocol
Tier system (HOT/WARM/COLD)
- Examples MUST be real (not theoretical)
- Guides MUST be tested on actual projects
## 🔧 Development Protocol
1. **Plan before code** — Every feature starts with a written plan