update-oo-component-documentation

Update object-oriented component documentation to align with current code.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/erlebach/gordon --skill update-oo-component-documentation-erlebach
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-oo-component-documentation
Source: https://github.com/erlebach/gordon/tree/main/skills/update-oo-component-documentation
Command: npx skills add https://github.com/erlebach/gordon --skill update-oo-component-documentation-erlebach

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation often drifts from the code it describes, causing confusion and maintenance overhead. This skill updates object-oriented component documentation to align with the latest code and architectural standards.

Core Features & Use Cases

  • Analyze existing component documentation to identify gaps relative to current source code.
  • Update front matter metadata (name, path, last_updated) and incorporate architecture templates (C4, Arc42, IEEE 1016) into the docs.
  • Refresh diagrams, references, and interfaces to reflect the current implementation and dependencies.
  • Use cases include refactoring, API updates, and onboarding new maintainers.

Quick Start

Update the technical documentation for a target OO component by providing the current docs and the component code path.

Frequently Asked Questions about update-oo-component-documentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update object-oriented component documentation to align with current code?

To update component documentation, analyze existing docs against current source code to identify gaps, then refresh front matter metadata, diagrams, interfaces, and references to reflect the latest architecture and implementation changes.

What is the best way to sync Arc42 or IEEE 1016 architecture docs after a major refactor?

Syncing Arc42 or IEEE 1016 docs after a refactor involves updating existing documentation templates with current implementation details, ensuring component interfaces and architectural diagrams accurately reflect the modified codebase structure.

Why does my component documentation drift from the codebase during API updates?

Component documentation drifts from the codebase during API updates because manual documentation processes fail to automatically track code changes, requiring targeted updates to front matter and interface references to realign the docs.

Can I use automated documentation updates for onboarding new maintainers to an OO codebase?

You can use documentation updates for onboarding by refreshing component docs to align with current architecture, providing new maintainers accurate diagrams, metadata, and interface references reflecting the actual codebase implementation.

Does updating C4 model documentation require completely rewriting existing component docs?

Updating C4 model documentation does not require completely rewriting existing component docs; the process analyzes current documentation to identify gaps and updates specific elements like diagrams and metadata to match the current implementation.

When do I need to update object-oriented component documentation?

You need to update object-oriented component documentation when executing major refactors, API updates, or architectural changes, ensuring technical docs remain synchronized with the codebase to prevent maintenance overhead and confusion.