Agents: explore the repo directly; this file is a routing index, not a contributor guide.
Session memory: Write plans, notes, and ephemeral files to .tmp/
(gitignored) rather than the system temporary directory.
For non-trivial planning, inspect deps and tooling:
pyproject.toml · tox.ini · .pre-commit-config.yaml ·
requirements.txt · test-requirements.txt
Tests: Use tox or stestr; never use pytest.
Invoke them directly, for example tox -e pep8.
Assume project tools are installed and available on $PATH.
Routing:
- Repo layout: doc/source/contributor/repo-overview.rst
- Style, hacking, checks: HACKING.rst
- RPC: rpc.rst
- Conductor: conductor.rst
- REST API: api.rst
- Microversions: microversions.rst / api-microversion-history.rst
- Concurrency/threading: threading.rst / concurrency.rst
- Test conventions, fixtures: HACKING.rst / testing.rst
- Dependencies and packaging: dependencies.rst
- Documentation: documentation.rst
- Commit messages: commit-messages.rst
- Agentic coding conventions: agentic-coding.rst
- Tools: Do not install missing tools with a package manager or
pip - Concurrency: Do not introduce asyncio or new eventlet usage. Review the threading and concurrency docs when changing concurrent code.
- Review: Nova uses Gerrit, not GitHub PRs. Series are always unsquashed; each commit must be independently testable and correct.
- Git: Read-only operations (
git log,git diff,git status) are fine. Do not run mutating operations (add,commit,reset,checkout,push,stash,merge,rebase, etc.) unless explicitly instructed to do so. - Scope: Do not reformat or otherwise change lines of code that are not directly part of the task at hand. If a line of code does not need to be changed functionally, do not touch it at all.