smart-docs

Smart Docs Generator

Generate clear, comprehensive documentation from your codebase automatically.

When to Activate

• User says /smart-docs, "document this", "generate docs", "write a README"
• User asks for API reference, module documentation, or function docs
• User wants to document a file, directory, or entire project

Instructions

Step 1: Determine Scope

Ask what needs documenting if unclear:

Single file: /smart-docs src/auth.ts Directory: /smart-docs src/services/ Full project: /smart-docs (no arguments — documents the whole project) Specific focus: /smart-docs --api or /smart-docs --readme

# Understand the project structure
find . -maxdepth 3 -type f \( -name "*.ts" -o -name "*.js" -o -name "*.py" -o -name "*.go" -o -name "*.rs" -o -name "*.java" \) | head -50

# Check for existing docs
ls -la README.md CHANGELOG.md docs/ 2>/dev/null

# Check package metadata
cat package.json 2>/dev/null | head -20
cat pyproject.toml 2>/dev/null | head -20
cat Cargo.toml 2>/dev/null | head -20

Step 2: Analyze Code

Read the target files and extract:

Exports & Public API

• Exported functions, classes, types, constants
• Their signatures, parameters, return types
• Existing JSDoc/docstring/doc comments (preserve and enhance, don't replace)

Architecture

• Module dependencies (imports/requires)
• Inheritance hierarchies
• Design patterns used (factory, singleton, observer, etc.)
• Entry points and main flows

Configuration

• Environment variables used
• Config files read
• CLI arguments accepted
• Default values

Examples

• Look for existing tests — they're the best documentation
• Look for example files or usage in README
• Check for examples/ or __tests__/ directories

# Find test files for usage examples
find . -path "*/test*" -name "*.test.*" -o -name "*.spec.*" | head -20

# Find example files
find . -name "example*" -o -name "demo*" -o -name "sample*" 2>/dev/null | head -10