Agent migrated guidance catalog

This file preserves current instructions that were previously inline in the long AGENTS.md but are not yet fully split into narrower docs. Nothing here was intentionally dropped during the compact-governance migration.

Code conventions

  • Python 3.11+ runtime, line length 120, typed public surfaces
  • snake_case for files, modules, and functions
  • PascalCase for classes
  • UPPER_SNAKE_CASE for constants
  • Stable public bundle surfaces should continue to use @beartype and @icontract

Bundle and registry reminders

  • Keep bundle package code under packages/.
  • Keep registry metadata in registry/index.json and packages/*/module-package.yaml.
  • This repository hosts official nold-ai bundles only; third-party bundles publish from their own repositories.

Testing

Contract-first coverage remains the primary testing philosophy. Test structure mirrors source under tests/unit/, tests/integration/, and tests/e2e/.