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.