Files
core/.trellis/spec/backend/index.md
T

1.7 KiB

Compiler Development Guidelines

This repository implements the Dever language compiler in Rust. It is not a Go Dever application or a database-backed service.

Pre-Development Checklist

  1. Read the current task PRD, design and implementation progress.
  2. Read Directory Structure, Error Handling and Quality Guidelines. For CLI, formatter, native optimization or official packages, also read Toolchain and Library Contracts, including signed ecosystem packs and bounded binary resource attachments. For language contracts and API boundaries, read Compiler Contracts. For LLVM typed lowering or runtime C ABI work, read both contracts; distinguish kernel/object evidence from complete application semantics and formal target runtime packs. For Model, ORM, database configuration or runtime connections, also read Database Guidelines. For Dever logging or HTTP request-boundary records, read Logging Guidelines.
  3. Inspect affected compiler phases and existing tests before adding another rule or helper.

Quality Check

  • Check the implemented milestone only; syntax success must not imply semantic validity.
  • Run the focused checks listed in the quality guide.
  • Keep all tests under repository-root test/.
  • Preserve unrelated user changes and do not create Git commits without authorization.

Database behavior is a compiler/runtime contract only within the static ORM boundary documented in Database Guidelines. Shared logging and native exit-flush contracts are documented in Logging Guidelines.