chore: more comments and refactor on directories