In this paper we present a framework that allows to introduce architecture students to agent-based simulations in the context of urban planning. It provides them with an understanding of how such simulations work by instructing them to learn how to program and develop an agent on their own. Along with the framework we explain our didactic concept of teaching complexity-science-methods to students from other fields such as architecture. In the discussion we report on that theory and practise should be alternated at very short intervals. Additionally we emphasize the importance to teach a good understanding of the capabilities of modelling and simulation tools, since uneducated students tend to trust them too blindly.