📝 This article introduces Clprolf and serves as the preamble to the official documentation series (6 parts to follow).

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.

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