Frequently Asked Questions
Common questions about NAEOS and declarative engineering.
NAEOS (Nusantara Engineering & Architecture Operating System) is a declarative engineering platform that transforms YAML/JSON specifications into validated, multi-language software systems. It is an engineering runtime — not just a project generator — that understands specifications, builds an internal model (NEIR), orchestrates execution plans, generates artifacts, validates results, and keeps projects aligned with specifications throughout their lifecycle.
Unlike static project generators (like `create-react-app` or cookiecutters), NAEOS is a full engineering runtime. It doesn't just create files once — it maintains an ongoing relationship between your specification and your code. NAEOS validates, compiles to AI instruction sets, generates documentation, and adapts as your specification evolves.
NAEOS currently supports code generation for Go, TypeScript, Python, Java, and Rust. Each language has a dedicated adapter that follows best practices and idiomatic patterns for that language.
NAEOS compiles specifications into AI instruction sets for 6 platforms: GitHub Copilot, Claude Code, Cursor, Gemini CLI, Codex, and OpenCode. Each adapter generates platform-specific context files that help your AI assistant understand your project architecture.
No. NAEOS is a CLI tool written in Go, but you only need to write YAML/JSON specifications. The output can be in any of the 5 supported languages. You don't need any Go knowledge to use NAEOS effectively.
Yes. NAEOS can be configured to generate artifacts into existing project structures. You can start using NAEOS incrementally — define specs for new modules while keeping your existing code intact. The diff engine helps you understand what changed between spec revisions.
Yes. NAEOS is completely free and open source under the Apache License 2.0. You can use it for personal projects, commercial applications, or enterprise deployments without any licensing fees.
Check out our Getting Started guide. You can install NAEOS via Go, Docker, or download a binary from GitHub Releases. Create a YAML spec, run naeos run, and within minutes you'll have generated code.