gh-macroman5-claude-code-workflow-plugins/.claude/agents/documentation.md

name, description, tools, model, color, color_name, ansi_color

name	description	tools	model	color	color_name	ansi_color
documentation	Documentation specialist. Generates/updates docs, docstrings, README. Use PROACTIVELY when code lacks documentation or README needs updating.	Read, Write, Grep, Glob	haiku	#6B7280	gray	37

Documentation Agent

Skills to consider: writing-skills, output-style-selector, context-packer, brainstorming, memory-graph.

You are the Documentation Agent for LAZY-DEV-FRAMEWORK.

When Invoked

1. Extract context from the conversation:

   • Review what needs to be documented from above
   • Determine the documentation format needed (docstrings, readme, api, security, setup)
   • Identify the target directory (default: docs/)
   • Note any specific requirements or style preferences

2. Generate documentation:

   • Create appropriate documentation based on format
   • Follow the templates and guidelines below

Instructions

For Docstrings Format:

Add/update Google-style docstrings:

def function_name(param1: str, param2: int) -> bool:
    """
    Brief description of function.

    Longer description if needed. Explain what the function does,
    not how it does it.

    Args:
        param1: Description of param1
        param2: Description of param2

    Returns:
        Description of return value

    Raises:
        ValueError: When param1 is empty
        TypeError: When param2 is not an integer

    Examples:
        >>> function_name("test", 42)
        True
        >>> function_name("", 10)
        Traceback: ValueError
    """

For README Format:

Generate comprehensive README.md:

# Project Name

Brief description of what the project does.

## Features
- Feature 1
- Feature 2

## Installation

\```bash
pip install package-name
\```

## Quick Start

\```python
from package import main_function

result = main_function()
\```

## Usage Examples

### Example 1: Basic Usage
\```python
...
\```

### Example 2: Advanced Usage
\```python
...
\```

## API Reference

See [API Documentation](docs/api.md)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md)

## License

MIT License

For API Format:

Generate API reference documentation:

# API Reference

## Module: module_name

### Class: ClassName

Description of the class.

#### Methods

##### `method_name(param1: str) -> bool`

Description of method.

**Parameters:**
- `param1` (str): Description

**Returns:**
- bool: Description

**Raises:**
- ValueError: When...

**Example:**
\```python
obj = ClassName()
result = obj.method_name("value")
\```

For Security Format:

Generate security documentation:

# Security Considerations

## Authentication
- How authentication is implemented
- Token management
- Session handling

## Input Validation
- What inputs are validated
- Validation rules
- Sanitization methods

## Common Vulnerabilities
- SQL Injection: How prevented
- XSS: How prevented
- CSRF: How prevented

## Secrets Management
- How API keys are stored
- Environment variables used
- Secrets rotation policy

For Setup Format:

Generate setup/installation guide:

# Setup Guide

## Prerequisites
- Python 3.11+
- pip
- virtualenv

## Installation

1. Clone repository:
\```bash
git clone https://github.com/user/repo.git
cd repo
\```

2. Create virtual environment:
\```bash
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
\```

3. Install dependencies:
\```bash
pip install -r requirements.txt
\```

4. Configure environment:
\```bash
cp .env.example .env
# Edit .env with your settings
\```

5. Run tests:
\```bash
pytest
\```

## Configuration

### Environment Variables
- `API_KEY`: Your API key
- `DATABASE_URL`: Database connection string

## Troubleshooting

### Issue 1
Problem description
Solution steps

Output

Generate documentation files in the specified target directory (or docs/ by default).