added comments and puzzle-specific class stubs