architecture-doc-writer

Generate an architecture document with ASCII diagram, module tree, and tech stack table.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mengdehong/opencode-dotfiles --skill architecture-doc-writer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-doc-writer
Source: https://github.com/mengdehong/opencode-dotfiles/tree/main/skills/architecture-doc-writer
Command: npx skills add https://github.com/mengdehong/opencode-dotfiles --skill architecture-doc-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Generate a clear and maintainable architecture document for a codebase, including an ASCII diagram, a module tree, and a tech stack table.

Core Features & Use Cases

  • ASCII architecture diagram with 3-6 layered boxes
  • Tree-style file organization view
  • Tech stack table with 2 columns: category and technology
  • Outputs to docs/ARCHITECTURE.md to support onboarding and reviews

Quick Start

Run the skill to generate an architecture document for the repository with an ASCII diagram, a tree view of files, and a tech stack.

Frequently Asked Questions about architecture-doc-writer

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

FAQPage Schema
How do I generate architecture documentation from a codebase automatically?▼

To generate architecture documentation from a codebase, you need a tool that analyzes source files and outputs structured markdown. This Skill produces a complete architecture document with an ASCII diagram, module tree, and tech stack table to support onboarding.

What is the best way to create an ASCII architecture diagram for software onboarding?▼

Creating an ASCII architecture diagram for onboarding involves mapping software components into 3-6 layered boxes. This Skill enforces ASCII-only diagrams around 120 columns, ensuring they render correctly in markdown and terminal environments.

How do I build a tech stack table for my software project documentation?▼

Building a tech stack table for documentation involves categorizing the technologies used in your project. This Skill generates a two-column tech stack table listing categories and technologies, alongside the architecture diagram and module tree.

Can I use this to generate a module tree view for large software projects?▼

Yes, you can generate a module tree view for software projects of various sizes. The Skill produces a tree-style file organization view that helps stakeholders and new team members understand the repository structure.

Does the generated architecture document output directly to the repository?▼

Yes, the generated architecture document outputs directly to docs/ARCHITECTURE.md in your repository. This standard placement ensures the documentation is easily accessible for reviews and onboarding.

What are the limitations of using ASCII diagrams for architecture documentation?▼

The limitation of ASCII diagrams for architecture documentation is the 120-column width constraint and 3-6 layer limit. This ensures terminal compatibility but may require structural simplification for highly complex, deeply nested project architectures.