{"slug": "show-hn-naeos-an-engineering-system-for-ai-coding-agents", "title": "Show HN: Naeos – an engineering system for AI coding agents", "summary": "NAEOS (Nusantara Engineering & Architecture Operating System), an open-source declarative engineering platform for AI coding agents, has been released on GitHub, enabling developers to specify software systems once and generate, validate, and evolve code across multiple languages and frameworks. The platform includes 67 CLI commands, supports six AI output adapters (GitHub Copilot, Claude Code, Cursor, Gemini CLI, Codex, OpenCode), and offers features like a profile marketplace, MCP server, and policy evaluator.", "body_md": "Specify Once. Build Anywhere.\n\nNAEOS (Nusantara Engineering & Architecture Operating System) is a declarative engineering platform that transforms specifications into high-quality software systems through a consistent, validated, and extensible pipeline.\n\nNAEOS is not just a project generator. NAEOS is an engineering runtime that understands specifications, builds an internal model, orchestrates execution plans, generates artifacts, validates results, and keeps projects aligned with specifications throughout their lifecycle.\n\nBuild an open-source engineering platform that enables developers and organizations to describe their system once, then build, validate, and evolve software across multiple languages, frameworks, and platforms.\n\n```\n# Clone dan build\ngit clone https://github.com/NAEOS-foundation/naeos.git\ncd naeos\ngo build ./cmd/naeos/\n\n# Buat spesifikasi\ncat > spec.yaml << 'EOF'\nproject: my-app\nmodules:\n  - name: auth\n    path: ./auth\n  - name: api\n    path: ./api\n    dependencies: [auth]\nservices:\n  - name: gateway\n    kind: http\n    port: 8080\narchitecture:\n  pattern: hexagonal\ngeneration:\n  languages: [go, typescript]\nEOF\n\n# Init membuat config (naeos.yaml) yang otomatis dideteksi oleh run\nnaeos init\nnaeos run --input-file spec.yaml\n\n# Generate AI context\nnaeos context --input-file spec.yaml\n\n# Compile ke AI tools\nnaeos ai compile --input-file spec.yaml --target opencode\n```\n\n**Parser**— YAML/JSON specification parsing with variable interpolation** Normalizer**— data normalization** Resolver**— cross-reference resolution** NEIR Builder**— unified project model** Validator**— comprehensive validation (circular deps, port conflicts, module boundaries)** Scheduler**— DAG-based task scheduling** Generator**— multi-language code generation (Go, TypeScript, Python, Java, Rust)\n\n`${var}`\n\n— variable interpolation`$env{VAR}`\n\n— environment variable resolution`$ref{path}`\n\n— cross-reference resolution`$include{file}`\n\n— multi-file spec composition`$fn{name(args)}`\n\n— custom functions (upper, lower, slug, default, len, coalesce)`$if{condition}`\n\n/`$endif`\n\n— conditional sections- Schema versioning with auto-check (minimum v0.1.0)\n\n**Compiler**— transform NEIR ke AI instruction sets** 6 Output Adapters**:- GitHub Copilot —\n`.github/copilot-instructions.md`\n\n- Claude Code —\n`CLAUDE.md`\n\n- Cursor —\n`.cursorrules`\n\n- Gemini CLI —\n`.gemini/CONFIG.md`\n\n- Codex —\n`AGENTS.md`\n\n- OpenCode —\n`AGENTS.md`\n\n- GitHub Copilot —\n**MCP Server**— Model Context Protocol untuk AI agent integration** Context Bundles**— LLM-optimized project summaries\n\n**Profile Marketplace**— publish, search, download industry profiles** Plugin Marketplace**— install, uninstall, search plugins** 5 Built-in Profiles**: SaaS, AI Agent, FinTech, Healthcare, Government\n\n**Policy Evaluator**— 7 operators, 5 default rules** Artifact Review**— governance rules** Audit Trail**— traceability\n\n**67 CLI Commands**— run, validate, compile, context, test, docgen, mcp, marketplace, etc.** Watch Mode**— hot-reload pipeline on spec changes** Diff Engine**— compare specs with colorized output** Migration Engine**— schema version transforms (v0.1→v0.2→v0.3)** Testing Framework**— multi-language test runner** Documentation Generator**— auto-generate API/module docs** Benchmarks & Fuzz Testing**— performance and robustness** Docker**— multi-stage Dockerfile\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                    NAEOS Architecture                     │\n├─────────────┬──────────────┬──────────────┬─────────────┤\n│    Input    │  Core Layer  │  Generation  │   Output    │\n├─────────────┼──────────────┼──────────────┼─────────────┤\n│  Spec YAML  │   Parser     │   Generator  │  Code Files │\n│  CLI cmds   │   Normalizer │   Adapters   │  Configs    │\n│  Profiles   │   Resolver   │   Renderers  │  Docs       │\n│  Context    │   Validator  │   Compiler   │  AI Context │\n│             │   Scheduler  │   Profiles   │  Artifacts  │\n│             │   Kernel     │              │             │\n│             │   Policy     │              │             │\n│             │   Review     │              │             │\n└─────────────┴──────────────┴──────────────┴─────────────┘\n```\n\nThe kernel provides the runtime foundation:\n\n- Service Registry\n- Event Bus (pub/sub)\n- Telemetry Collection\n- Lifecycle Management\n\nSpecifications use NAEOS Specification Language v2 as the single source of truth.\n\nNAEOS Engineering Intermediate Representation is the central engineering model representing the entire system. NEIR encompasses project, architecture, domain, module, component, service, API, storage, infrastructure, security, AI, documentation, deployment, testing, and metadata.\n\nThe compiler transforms NEIR into AI instruction sets for 6 target tools.\n\nA marketplace for profiles, plugins, and templates that can be published, searched, and installed.\n\n| Command | Description |\n|---|---|\n`naeos run` |\nExecute full pipeline |\n`naeos validate` |\nValidate specification |\n`naeos compile` |\nCompile to AI instruction sets |\n`naeos context` |\nGenerate AI context bundle |\n`naeos test` |\nRun tests for generated code |\n`naeos docgen` |\nGenerate documentation |\n`naeos mcp` |\nStart MCP server |\n`naeos marketplace` |\nBrowse marketplace |\n`naeos profile` |\nManage industry profiles |\n`naeos artifacts` |\nManage artifact store |\n`naeos migrate` |\nSchema migration |\n`naeos doctor` |\nSystem health check |\n`naeos diff` |\nCompare specifications |\n`naeos watch` |\nWatch for changes |\n`naeos init` |\nInitialize config |\n`naeos create` |\nCreate project |\n`naeos scaffold` |\nGenerate scaffold |\n`naeos export` |\nExport artifacts |\n`naeos audit` |\nAudit specification |\n`naeos kernel` |\nInspect kernel |\n`naeos plugin` |\nManage plugins |\n`naeos template` |\nManage templates |\n`naeos workspace` |\nManage workspace |\n`naeos rollback` |\nRollback changes |\n`naeos repair` |\nRepair specification |\n`naeos status` |\nPipeline status |\n`naeos ai` |\nAI assistance |\n`naeos docs` |\nDocumentation |\n`naeos lock` |\nLock dependencies |\n`naeos version` |\nVersion info |\n`naeos completion` |\nShell completion |\n\n```\ncmd/naeos/           # CLI commands (35+ files)\ninternal/\n  specification/     # Parser, normalizer, resolver\n  neir/             # NEIR model and builder\n  compiler/         # AI instruction compiler\n  context/          # Context bundle generator\n  generation/       # Code generation\n  governance/       # Policy and review\n  artifacts/        # Artifact store\n  profiles/         # Industry profiles\n  marketplace/      # Profile & plugin marketplace\n  migration/        # Schema migration\n  mcp/              # MCP server\n  testrunner/       # Test framework\n  docgen/           # Documentation generator\n  diff/             # Diff engine\n  watch/            # File watcher\n  security/         # Security rules\n  knowledge/        # Knowledge graph\n  database/         # Database layer (PostgreSQL, MySQL, SQLite)\n  websocket/        # WebSocket real-time communication\n  eventsourcing/    # Event sourcing and aggregate snapshots\n  distributed/      # Distributed task execution\n  configreload/     # Configuration hot-reload\n  pipelinecache/    # Pipeline result caching\n  pipelinemiddleware/ # Composable pipeline middleware\n  audit/            # Audit logging layer\n  hcl/              # HCL configuration parser\n  profiledetect/    # Automatic language/framework detection\n  ai/               # AI service and LLM integration\n  pluginsdk/        # Plugin SDK with WASM runtime\npkg/\n  pipeline/         # Main pipeline\n  kernel/           # System kernel\n  config/           # Configuration\n  plugin/           # Plugin system\ndocs/               # Documentation (56 NES specs)\n```\n\n[WHITEPAPER-EN.md](/NAEOS-foundation/naeos/blob/main/WHITEPAPER-EN.md)— official whitepaper (English)[WHITEPAPER.md](/NAEOS-foundation/naeos/blob/main/WHITEPAPER.md)— whitepaper resmi (Bahasa Indonesia)[DOCUMENTATION-INDEX.md](/NAEOS-foundation/naeos/blob/main/DOCUMENTATION-INDEX.md)— document index[GETTING-STARTED.md](/NAEOS-foundation/naeos/blob/main/GETTING-STARTED.md)— onboarding guide[CONTRIBUTING.md](/NAEOS-foundation/naeos/blob/main/CONTRIBUTING.md)— contribution guidelines[CHANGELOG.md](/NAEOS-foundation/naeos/blob/main/CHANGELOG.md)— version history[docs/](/NAEOS-foundation/naeos/blob/main/docs)— 57 NES specification documents (NES-000 to NES-054, including Kernel API and NEIR Model references)\n\n- v0.1.0 — Foundation (parser, NEIR, pipeline, CLI)\n- v0.2.0 — Compiler Foundation (6 adapters, artifact store, profiles)\n- v0.3.0 — Core Specification (Spec v2, validation, context bundles)\n- v0.4.0 — MCP Server, migration engine, marketplace, benchmarks\n- v1.0.0 — Stable release (test coverage, security hardening, 67 commands)\n- v1.1.0 — Critical fixes (WebSocket races, interface{}→any, godoc, OpenAPI)\n- v1.2.0 — Database layer (PostgreSQL/MySQL/SQLite, retry, logging, health checks)\n- v1.3.0 — Quality, Correctness & Production Readiness (code gen fixes, security audit, CLI --output json/yaml)\n- v1.3.1 — Code Quality & Lint Compliance (999 issues resolved, 22 unused symbols removed)\n- v1.4.0 — Prompt Library & Platform Improvements (YAML templates, observability dashboard, workflow manager)\n- v1.5.0 — Production Hardening (HTTP timeouts, context propagation, error logging, SSE fixes, test fixes)\n- v2.1.0 — RBAC, multi-tenant workspaces, schema registry API, industry profiles, compliance export\n- v2.2.0 — Supabase backend integration, lint zero-failure, fuzz testing, coverage-gated CI\n- v3.0.0 — Pipeline profiling, stage caching, schema-based validation, NEIR-aware LSP server, official plugin examples\n- v3.1.0 — Pipeline caching on\n`naeos run`\n\n, run-level profiling (`--profile`\n\n/`--pprof`\n\n), architecture patterns, WASM plugin hardening\n\nFor upcoming work, see [DEVELOPMENT_PLAN.md](/NAEOS-foundation/naeos/blob/main/DEVELOPMENT_PLAN.md) and [ROADMAP.md](/NAEOS-foundation/naeos/blob/main/ROADMAP.md).\n\nApache License 2.0\n\n🟢 **Active Development** — NAEOS is under active development with full features for specification-driven engineering. Latest version: v3.1.0 (Pipeline caching on `naeos run`\n\n, run-level profiling, architecture patterns, WASM plugin hardening).", "url": "https://wpnews.pro/news/show-hn-naeos-an-engineering-system-for-ai-coding-agents", "canonical_source": "https://github.com/NAEOS-foundation/naeos", "published_at": "2026-08-19 16:34:02+00:00", "updated_at": "2026-08-19 16:43:52.274348+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools", "ai-tools", "generative-ai"], "entities": ["NAEOS", "GitHub", "GitHub Copilot", "Claude Code", "Cursor", "Gemini CLI", "Codex", "OpenCode"], "alternates": {"html": "https://wpnews.pro/news/show-hn-naeos-an-engineering-system-for-ai-coding-agents", "markdown": "https://wpnews.pro/news/show-hn-naeos-an-engineering-system-for-ai-coding-agents.md", "text": "https://wpnews.pro/news/show-hn-naeos-an-engineering-system-for-ai-coding-agents.txt", "jsonld": "https://wpnews.pro/news/show-hn-naeos-an-engineering-system-for-ai-coding-agents.jsonld"}}