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 ⭐.

Scope and Positioning

Clprolf is not intended as a mainstream replacement for Java or other general-purpose languages.

It is designed for:

• educational contexts focused on architectural clarity,
• complex systems,
• simulation and MAS-like applications,
• systems requiring strong predictability and structural discipline.

Clprolf introduces explicit structural constraints through predefined roles and natures. These constraints are intentional and form part of the language’s philosophy.

Developers who prefer unrestricted class modeling and complete architectural freedom may find traditional object-oriented languages more suitable.

Clprolf is intended for contexts where early architectural control and long-term coherence are primary objectives.

🚀 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

• Teaching OOP and architectural thinking through structural guarantees
• Large simulations & multi-agent systems
• Scientific prototypes with interacting “actors”

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