There's a lot of useful information in development documentation of Hammer Core. Studying it first can help you to understand the basic principles.
Foreman plugin extends the Hammer Core in following areas:
It's recommended that you set :refresh_cache: true in the plugin settings if
engaging in API development to enable aggressive apidoc cache checking.