Repository navigation
Home
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.
| 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.
- 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.
- VS Code extension
- Codex plugin
- Claude Code plugin
- Using PlainLogic: implement a file or specification, draft logic, validate a slice, or convert source-file instructions.
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.
PlainLogic 0.3 · Home · Implementation source · Validation limits
Learn
Install and use
Check and contribute