# NeuPlan Architecture and Guidelines

- Purpose
  - Provide a production-ready scaffold for a neuromorphic planning stack, enabling end-to-end wiring from a lightweight DSL to a neuromorphic backend.
- Tech Stack
  - Language: Python 3.9+
  - Packaging: pyproject.toml with setuptools
  - Core modules: neuplan.dsl (LocalProblem, PlanDelta, SharedVariables, to_nir), neuplan.runtime (OnboardRuntime), neuplan.backends.loihi (LoihiBackend)
- Testing
  - test.sh should execute: python -m build, pytest
- Testing commands
  - Build: python3 -m build
  - Run tests: pytest -q
- Contribution
  - Create a feature branch, implement, run tests, and open a PR. Include README updates and READY_TO_PUBLISH if ready.