Skip to content

FractalicAI Workflows in Markdown

Plain-language programming for building AI agents using Markdown + YAML operation blocks

What is Fractalic?

Fractalic is a plain-language programming environment for building AI workflows and agents using ordinary Markdown plus lightweight YAML operation blocks. Instead of wiring nodes in a UI or writing imperative Python scripts, you express intent in structured text.

Key idea: A Fractalic file = (Ordered Knowledge Blocks) + (Operation Blocks that transform context) → Final Returned Result.

Quick Example

markdown
# Product Requirements {id=reqs}
- Fast response times
- Easy to use interface
- Reliable performance

@llm
prompt: "Create a technical specification based on these requirements"
blocks: reqs
use-header: "# Technical Specification"
mode: append

After execution, your document grows:

js
# Product Requirements {id=reqs}
- Fast response times
- Easy to use interface
- Reliable performance

@llm
prompt: "Create a technical specification based on these requirements"
blocks: reqs
use-header: "# Technical Specification"
mode: append

# Technical Specification {id=technical-specification} 
## Performance Requirements 
- Response time: < 200ms for all user interactions 
- System uptime: 99.9% availability target 
- Concurrent users: Support up to 10,000 simultaneous connections 
## User Interface Specifications 
- Responsive design for mobile and desktop 
- Intuitive navigation with maximum 3-click access to any feature 
- Accessibility compliance (WCAG 2.1 AA standards) 
## Reliability Standards 
- Automated failover mechanisms 
- Data backup and recovery procedures 
- Comprehensive error handling and logging 

The document evolves as operations run—new blocks are appended, replaced, or refined—so you can literally "grow" an AI system the way you draft a document.

Core Benefits

  • Transparency: Diffable evolution with full execution history
  • Composability: Any file can be an agent, workflows chain naturally
  • Deterministic: Controlled merge semantics and context windows
  • Integration: Seamless shell and tool integration via MCP
  • Rapid Development: Progressive elaboration without refactoring

Getting Started

Ready to build your first AI workflow? Check out the Quick Start guide or dive into Core Concepts to understand the fundamentals.

Released under the MIT License.