Skip to content
Sceleratis edited this page Oct 20, 2026 · 2 revisions

PlainLogic

PlainLogic is a custom pseudocode format for expressing behavior through plain-English steps, precise logic, or both. It gives people and coding agents a shared, reviewable description of what to implement.

alias NewThread -> Create and run new coroutine

NewThread:
    for i = 1 to 100:
        > Print i to console

This is an informal fragment. The alias supplies a named behavior, the counted loop includes both endpoints, and the English step describes the work. The target runtime still determines how the coroutine is created and started.

Three pieces

Piece What it does
PlainLogic language Records intent, exact conditions, operations, examples, and unresolved decisions in readable form.
VS Code extension Adds highlighting, snippets, navigation, completion, folding, and local structural diagnostics for .plog files.
PlainLogic agent skill Interprets logic or specifications, validates the relevant behavior, and writes implementation code in the target project.

The editor and agent skill can be used independently. Neither the editor nor the optional Python checker executes a PlainLogic document or interprets its English. Implementation is an agent workflow, not a standalone deterministic compiler.

Start here

  • Getting started: choose a workflow and try a complete example.
  • Syntax reference: document structure, types, routines, control flow, contracts, and cases.
  • Aliases and native blocks: express target-specific behavior without recreating an entire implementation language.
  • Examples: full documents and clearly marked fragments.

Install and use

Check and contribute

Version and source

These pages document PlainLogic 0.3 and the implementation at 4319f11. Versions 0.1 and 0.2 remain supported with their original syntax. The 0.3 additions include behavior aliases, inclusive counted loops, optional target context, symbolic generic types, and protected native blocks.

Use the maintained language reference and extension-surface rules when changing the language. This wiki explains the implemented behavior; it does not establish new syntax.

Clone this wiki locally