English Compiler

Transforms natural language specifications written in Markdown format into executable code through a sophisticated multi-stage AI-driven pipeline that handles codebases exceeding typical LLM token limits. The system uses chain-of-thought processing with multiple AI passes, frontmatter metadata extraction, and prompt engineering to decompose complex specifications into manageable generation tasks. Core workflow: specification parsing → prompt construction via fullSpecPrefix → iterative AI code generation → component assembly → optional minification.

Generates syntactically correct, idiomatic code across JavaScript, Java, and HTML by routing specifications through language-specific generation pipelines. Each language has dedicated generation logic that understands language conventions, module systems, and structural patterns. The system reads target language from specification frontmatter and applies appropriate code assembly and minification strategies per language.

Provides testing and validation capabilities for generated applications through demo testing infrastructure. The system validates that generated code matches specification requirements and functions correctly. Testing framework enables verification of generated code quality and specification compliance before deployment.

Maintains persistent JSONL-based caches (personality-remark.*.jsonl, FunctionModuleCodegen.*.jsonl, SpecChangeSuggestion.*.jsonl) that store AI-generated artifacts and intermediate results across build runs. This enables incremental builds where unchanged specifications reuse cached outputs, reducing API calls and generation latency. The caching system tracks which specifications have been processed and stores both generated code and AI reasoning artifacts.

Extracts YAML frontmatter metadata from Markdown specification files to configure code generation behavior, including target language, output structure, and generation parameters. The parser separates frontmatter from specification content and uses metadata to route specifications through appropriate generation pipelines. Frontmatter fields control language selection, module naming, and other generation-time configuration.

Applies language-aware code minification through simpleAndSafeMinify function that reduces generated code size while preserving functionality. The minification strategy varies by target language, removing unnecessary whitespace, shortening variable names where safe, and eliminating comments. Minification is optional and applied post-generation based on specification configuration.

Provides command-line interface (EnglishCompiler.js) that orchestrates the entire code generation pipeline through build commands (build file, build all) and specification management commands (spec suggest, spec infer). The build system in build/all.js handles file discovery through scanDirForFiles, processes each specification through markdownSpecToCode, and manages output file writing. CLI enables both single-file and batch specification processing.

Provides spec suggest and spec infer commands that use AI to generate missing specification details or infer specification structure from partial requirements. These commands analyze incomplete specifications and suggest additions or improvements, helping developers flesh out specifications before code generation. Suggestions are cached in SpecChangeSuggestion.*.jsonl for reuse.

Constructs multi-step AI prompts using fullSpecPrefix and chain-of-thought reasoning to decompose complex code generation tasks into manageable steps. Rather than single-shot generation, the system guides the LLM through structured reasoning about specification requirements, code structure, and implementation details. Multiple AI passes combine intermediate results into final code, enabling generation of complex applications that exceed single-prompt capabilities.

Generates complete, functional full-stack applications (frontend, backend, database) from unified Markdown specifications. The system coordinates generation of multiple application layers, ensuring consistency across components and proper integration. Demo applications (Twitter Clone, OAuth2 Provider) demonstrate generation of production-grade applications with database schemas, API endpoints, and UI components from single specifications.

Generates enterprise-grade Java classes with proper object-oriented structure, type safety, and Java conventions. The Java generation pipeline understands class hierarchies, interface definitions, method signatures, and Java-specific patterns. Generated classes follow Java naming conventions, include proper access modifiers, and implement appropriate design patterns. Demo applications include complex Java class generation for database models and business logic.