Generate Standard OO Component Documentation

${input:ComponentPath}

Documentation Standards

• DOC-001: Follow C4 Model documentation levels (Context, Containers, Components, Code)
• DOC-002: Align with Arc42 software architecture documentation template
• DOC-003: Comply with IEEE 1016 Software Design Description standard
• DOC-004: Use Agile Documentation principles (just enough documentation that adds value)
• DOC-005: Target developers and maintainers as primary audience

Analysis Instructions

• ANA-001: Determine path type (folder vs single file) and identify primary component
• ANA-002: Examine source code files for class structures and inheritance
• ANA-003: Identify design patterns and architectural decisions
• ANA-004: Document public APIs, interfaces, and dependencies
• ANA-005: Recognize creational/structural/behavioral patterns
• ANA-006: Document method parameters, return values, exceptions
• ANA-007: Assess performance, security, reliability, maintainability
• ANA-008: Infer integration patterns and data flow

Language-Specific Optimizations

• LNG-001: C#/.NET - async/await, dependency injection, configuration, disposal
• LNG-002: Java - Spring framework, annotations, exception handling, packaging
• LNG-003: TypeScript/JavaScript - modules, async patterns, types, npm
• LNG-004: Python - packages, virtual environments, type hints, testing

Error Handling

• ERR-001: Path doesn't exist - provide correct format guidance
• ERR-002: No source files found - suggest alternative locations
• ERR-003: Unclear structure - document findings and request clarification
• ERR-004: Non-standard patterns - document custom approaches
• ERR-005: Insufficient code - focus on available information, highlight gaps

Output Format

File Location

/docs/components/

[component-name]-documentation.md

Required Documentation Structure

---
title: [Component Name] - Technical Documentation
component_path: `${input:ComponentPath}`
version: [Optional: e.g., 1.0, Date]
date_created: [YYYY-MM-DD]
last_updated: [Optional: YYYY-MM-DD]
owner: [Optional: Team/Individual responsible for this component]
tags: [Optional: List of relevant tags or categories, e.g., `component`,`service`,`tool`,`infrastructure`,`documentation`,`architecture` etc]
---

# [Component Name] Documentation

[A short concise introduction to the component and its purpose within the system.]

## 1. Component Overview

### Purpose/Responsibility
- OVR-001: State component's primary responsibility
- OVR-002: Define scope (included/excluded functionality)
- OVR-003: Describe system context and relationships

## 2. Architecture Section

- ARC-001: Document design patterns used (Repository, Factory, Observer, etc.)
- ARC-002: List internal and external dependencies with purposes
- ARC-003: Document component interactions and relationships
- ARC-004: Include visual diagrams (UML class, sequence, component)
- ARC-005: Create mermaid diagram showing component structure, relationships, and dependencies

### Component Structure and Dependencies Diagram

Include a comprehensive mermaid diagram that shows:
- **Component structure** - Main classes, interfaces, and their relationships
- **Internal dependencies** - How components interact within the system
- **External dependencies** - External libraries, services, databases, APIs
- **Data flow** - Direction of dependencies and interactions
- **Inheritance/composition** - Class hierarchies and composition relationships

```mermaid
graph TD
    subgraph "Component System"
        A[Main Component] --> B[Internal Service]
        A --> C[Internal Repository]
        B --> D[Business Logic]
        C --> E[Data Access Layer]
    end

    subgraph "External Dependencies"
        F[External API]
        G[Database]
        H[Third-party Library]
        I[Configuration Service]
    end

    A --> F
    E --> G
    B --> H
    A --> I

    classDiagram
        class MainComponent {
            +property: Type
            +method(): ReturnType
            +asyncMethod(): Promise~Type~
        }
        class InternalService {
            +businessOperation(): Result
        }
        class ExternalAPI {
            <<external>>
            +apiCall(): Data
        }

        MainComponent --> InternalService
        MainComponent --> ExternalAPI

3. Interface Documentation

• INT-001: Document all public interfaces and usage patterns
• INT-002: Create method/property reference table
• INT-003: Document events/callbacks/notification mechanisms

4. Implementation Details

• IMP-001: Document main implementation classes and responsibilities
• IMP-002: Describe configuration requirements and initialization
• IMP-003: Document key algorithms and business logic
• IMP-004: Note performance characteristics and bottlenecks

5. Usage Examples

Basic Usage

// Basic usage example
var component = new ComponentName();
component.DoSomething();

Advanced Usage

// Advanced configuration patterns
var options = new ComponentOptions();
var component = ComponentFactory.Create(options);
await component.ProcessAsync(data);

• USE-001: Provide basic usage examples
• USE-002: Show advanced configuration patterns
• USE-003: Document best practices and recommended patterns

6. Quality Attributes

• QUA-001: Security (authentication, authorization, data protection)
• QUA-002: Performance (characteristics, scalability, resource usage)
• QUA-003: Reliability (error handling, fault tolerance, recovery)
• QUA-004: Maintainability (standards, testing, documentation)
• QUA-005: Extensibility (extension points, customization options)

7. Reference Information

• REF-001: List dependencies with versions and purposes
• REF-002: Complete configuration options reference
• REF-003: Testing guidelines and mock setup
• REF-004: Troubleshooting (common issues, error messages)
• REF-005: Related documentation links
• REF-006: Change history and migration notes

undefined