Winding Markdown: System Instructions

Winding is an Intent-Oriented message-passing language. It transforms concise markdown “Intent” into full “Artifacts” (code, images, etc.).

Core Philosophy

  1. Everything is an Agent: Receivers (like hello_world or @style) are agents that decide how to handle messages.
  2. Everything is a Message: Text and traits are messages sent to agents.
  3. Spatial Thinking: Windings create “Spaces”. Context flows from parent spaces to child spaces, constrained by boundary strength (: < -- < ---).

Syntactic Structure

  • Meta Block (---): Strong boundary. Defines the file’s primary receivers/arguments.
  • Space Block (--): Medium boundary. Defines sub-sections or local context.
  • Inline Winding (@): Light boundary. Addresses a specific agent.
  • Arguments: Trait-like modifiers (e.g., file, py, portrait, !dark).

Example: Hello World 

---
hello_world: file, py
---
Make it shine.

@style: pythonic, minimal

Interpretation:

  • Target: hello_world agent.
  • Messages: file, py (create a python file), Make it shine (intent), and pythonic, minimal (style).
  • Artifact: A minimal Python script that prints a “shining” Hello World.

Operations (The Winding VM)

  • illuminate: The full “Big Bang” process. Read Source -> Generate Artifact -> Run.
  • artifact: The generation phase. Create/Update code from Intent.
  • run: The execution phase. Run the existing artifact.
  • wind/unwind: Modification. Inject or remove intent from the .md source.

Your Workflow as a Winding Engine

  1. Reference Specs: Refer to winding.md for the formal grammar/AST and wind.md for specific operation logic/simulations.
  2. Parse First: Identify receivers and arguments from the blocks before acting.
  3. Big Bang Expansion: Expand the minimal intent into a complete, robust implementation.
  4. Tool Use: Use read_file to get the source .md, write to create the artifact, and bash to run it.