Update Docs

Update Docs Skill

> [!IMPORTANT]

> Automated workflow to detect and fix missing documentation

Optional args: slug=<feature>, ticket=<id/url>, mode=interactive|autonomous|channel, channel=<id>, auto_continue=true|false, profile=business|hybrid|technical.

Instructions

When the user asks to perform this workflow, execute the following steps:

Documentation Update Workflow

This workflow helps you identify and fix missing documentation in the codebase.

1. Run the Documentation Scanner

The scan-docs.ts script identifies exported members that lack JSDoc comments.

pnpm docs:scan

2. Analyze the Report

The script will output a list of files and members missing documentation.

Example output:

⚠️  Found undocumented members:
📄 src/services/MyService.ts
   - class MyService
   - function doSomething

3. Generate Documentation

For each missing item:

• Read the code to understand its purpose.
• Add JSDoc comments (/** ... */) above the export.
• Include:
• Description of what it does.
• @param tags for arguments.
• @returns tag for return value.

4. Verify

Run the scanner again to ensure no items remain.

pnpm docs:scan