docs-architect

Generates comprehensive technical documentation and manuals from existing codebases.

1|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/gonzoblasco/ai-developer-stack --skill docs-architect-gonzoblasco
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: docs-architect
Source: https://github.com/gonzoblasco/ai-developer-stack/tree/main/tools-automation/docs-architect
Command: npx skills add https://github.com/gonzoblasco/ai-developer-stack --skill docs-architect-gonzoblasco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing thorough technical documentation for an existing codebase is time-consuming and often skipped, leaving teams without architecture guides, onboarding material, or records of design decisions. This Skill analyzes a codebase and produces structured, long-form technical documentation. ## Core Features & Use Cases - Codebase Analysis: Maps architecture, data models, dependencies, and design patterns before writing. - Structured Documentation: Produces manuals with executive summaries, architecture overviews, ADRs, data schemas, and security models. - Use Case: A new engineer joins a project with no docs. Point this Skill at the repository to generate an architecture guide with component deep-dives, schema tables, and linked code references for onboarding. ## Quick Start Analyze this repository and generate a complete technical documentation manual covering its architecture, data models, and design decisions.

Frequently Asked Questions about docs-architect

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

FAQPage Schema
How do I generate technical documentation from an existing codebase?▼

Run this Skill against the repository so it analyzes structure, entry points, dependencies, and data models, then writes a structured manual. The output includes an architecture overview, component deep-dives, and linked code references in Markdown.

What sections should technical architecture documentation include?▼

This Skill produces an executive summary, architecture overview, design decisions (ADRs), core component deep-dives, data models, integration points, and a security model. Each section follows a progressive disclosure hierarchy from general to specific.

Can this replace automated API reference generators like Swagger?▼

No. The Skill explicitly excludes basic automated API reference generation without design rationale. It focuses on explaining the what and why behind architecture, not endpoint-by-endpoint schema output.

When should I not use codebase documentation generation?▼

Avoid it for user manuals, marketing content, or copywriting, which are out of scope. Also treat the output as a draft requiring environment-specific validation and expert review rather than a final authoritative document.

What output format does the documentation use?▼

Documentation is generated in Markdown with nested headings, syntax-highlighted code blocks, tables for schemas and configurations, and relative links to source files in the format [filename](file:///path/to/file#lines).