module-gates CLAUDE.md

Context Rules

Code Structure

• src/ - extention source
• test/ - unit tests
• .tasks/ - local development plan directory, e.g. .tasks/ISSUE-2/ for Github issue #2.

Glossary

Given the example code structure:

src/
   file1.ts
   file2.ts
   sub1/
      file3.ts
   sub2/
      file4.ts

• Module: a directory. src/ is a module, src/sub1/ is a module.
• Siblings: files in the same directory. src/file1.ts and src/file2.ts are siblings.
• Children: files in a sub-directory. src/sub1/file3.ts and src/sub2/file4.ts are children of module src.
• External: files in external modules. file1.ts is an external file from module sub1. file4.ts is an external file from module sub1.
• Internal: files in the same module. file1.ts is an internal file of module src, file3.ts is an internal file of module sub1 and module src.

Also refer to @README.md

Conversational Style

• Keep answers short and concise
• No emojis in commits, issues, PR comments, or code
• When the user asks a question, answer it first before making edits or running implementation commands.
• When writing text, think from the reader's perspective, write only what they need to know.
• When writing to README, be concise.
• If you want to ask user, simply print the questions, there's no such a ask_user tool.

Code Conventions

• No any types, No enums, No inline imports, No Classes
• Use only erasable TypeScript syntax compatible with Node strip-only mode in TypeScript. Do not use constructor parameter properties, enum, namespace/module, import =, export =, or other TypeScript constructs that require JavaScript emit. Use explicit fields and constructor assignments instead of parameter properties.
• Public types, contract, methods, higher-level abstractions should be at the top of the files, private implementation details should be at the bottom. If a private function only is used in the same file, it should be below its callers. See below section Single file layout.
• Do not add comments except it's a consequential information and the code itself cannot tell.