Skip to content

charleskoffler/clprolf

Repository files navigation

Clprolf — Clear Programming Language & Framework

A methodology turned into a language. Good OOP becomes natural, not accidental.

Clprolf adds a conceptual layer on top of Java/C#/PHP: roles, contracts, and design rules are first-class keywords. You model systems with agents, worker agents, versions, and capacities, while the compiler enforces clarity.

If you clone the repository and find value in the project, please consider giving it a ⭐.


🚀 Why Clprolf?

  • Safer architecture: compile-time errors prevent invalid dependencies
  • Clear concurrency: intent expressed with one_at_a_time, turn_monitor, etc.
  • Readable design: class roles (agent, worker_agent, model) explain themselves

📝 Quick Example

agent OrderService {
    with_compat OrderRepository repo;
    void checkout(Order o) { repo.save(o); }
}
  • In plain OOP: architecture drifts, concurrency bugs, endless onboarding.
  • With Clprolf: contracts explicit, roles clear, design rules enforced.

✨ Key Ideas

  • Role-based classes: agent, worker_agent, model, information, indef_obj

  • Modifiers for real-world complexity: long_action, one_at_a_time, dependent_activity

  • Works two ways:

    • Framework (annotations for Java, C#, PHP 8+)
    • Language (compiles into pure Java)

🎯 Perfect For

  • Large simulations & multi-agent systems
  • Scientific prototypes with interacting “actors”
  • Teaching OOP/design patterns with minimal overhead

👉 With Clprolf, your code doesn’t just run — it explains itself.


📚 Documentation — Official Clprolf Materials

Explore the complete set of official Clprolf documents. From the Language Reference Manual to focused thematic guides and conceptual insights, each resource is designed to help you understand and master the language with clarity and precision.


🧠 Main Documentation


🔬 Extended Documentation


🧩 Source Examples — Explore the Language in Action

Discover how Clprolf comes to life through concrete examples — from simple demonstrations to full applications and design patterns. Each directory showcases a different facet of the language: clarity, structure, and algorithmic expressiveness.