sdcorejs-comment-code

What problem does it solve?

Prevents blindly auto-commenting or omitting comments by forcing an explicit user decision at the comment phase, so code stays readable without bloating files.

Core Features & Use Cases

• Mandatory ASK gate: always prompts the user to choose skip / simple / medium / full before any comments are added, aligned to the session language (VI/EN).
• Progressive commenting rules: applies increasingly richer JSDoc and inline // why explanations depending on the selected level, including optional companion documentation at full.
• Workflow integration: runs after 50-review-code / orchestration/repair-loop (if applicable) and before orchestration/verify-before-done, and triggers when the user asks for comments or comment level.
• Use cases: after code generation for Angular Portal, NestJS, or Next.js tasks, when the user wants consistent team conventions for documentation density and “why” explanations.

Quick Start

Tell the agent “comment level full” after it generates code to apply the richest JSDoc and design rationale documentation for non-obvious module decisions.