Architecture Writer — Research agent for Claude Code
Introspects a codebase and its docs and writes an evidence-based architecture analysis report (Markdown with editable .drawio.svg diagrams, rendered to PDF) structured per Views and Beyond, ATAM and A.
How to install Architecture Writer
Installs to ~/.claude/agents/ashapochka-arch-docs-architecture-writer.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/ashapochka/arch-docs/HEAD/agents/architecture-writer.md -o ~/.claude/agents/ashapochka-arch-docs-architecture-writer.md Restart Claude Code, or start a new session, for it to be picked up.
What Architecture Writer does
name: architecture-writer description: Introspects a codebase and its docs and writes an evidence-based architecture analysis report (Markdown with editable .drawio.svg diagrams, rendered to PDF) structured per Views and Beyond, ATAM and ADD. Use when asked for an architecture analysis, architecture review document, or a full architecture description of an existing solution. tools: Read, Grep, Glob, Bash, Write, Edit, Skill, Agent skills:
- arch-docs
- doc-coauthoring
- pdf model: inhe
Alternatives in Research
- Worker Researcher — Web research agent 1k ★
- Research Dossier Writer — Creates a PRP-style research dossier for a feature brief, focused on concrete codebase anchors, patterns, gotc 415 ★
- Jogyo Paper Writer — Generates human-readable, narrative research reports from structured context 244 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Memo Writer
Writes (v1) or rewrites (vN) the legal memorandum based on research files, the selected template, and (for vN)
Codebase Mapper
Use to produce structured analysis documents of a codebase — stack, architecture, conventions, testing, or con
Deep Research Writer
Writes the single report.md of a nav-deep-research run from the run's source notes, following the readable rep
Moneydive Report Writer
Writes the comprehensive equity intelligence report from scope, research notes, and gap flags. Spawned by /mon
Resume Customizer
Tailors a base resume to match a specific company and job posting, using the company research brief. Outputs a
Source Pack Builder
Builds an evidence table from research and currency files so the writer and citation auditor work from a struc
Related Skills
Architect Visualize
Realize a catalog workload pattern on a chosen provider and write its views (Mermaid, sequence, C4/Structurizr
Vizcharter
MCP diagram studio for Claude Code — architecture diagrams with 1,155 official AWS/GCP/Azure icons, charts, an
Delivery Doc Writer
Agent skill for batch-producing software delivery documents from Word templates, a requirements spec and a cod