Arch Doc Writer — Development agent for Claude Code
Use this agent when documentation in the architecture/ directory needs to be updated or created for a specific file after implementing a feature, fix, refactor, or behavior change.
How to install Arch Doc Writer
Installs to ~/.claude/agents/nousresearch-openshell-arch-doc-writer.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/NousResearch/OpenShell/HEAD/.claude/agents/arch-doc-writer.md -o ~/.claude/agents/nousresearch-openshell-arch-doc-writer.md Restart Claude Code, or start a new session, for it to be picked up.
What Arch Doc Writer does
name: arch-doc-writer description: "Use this agent when documentation in the `architecture/` directory needs to be updated or created for a specific file after implementing a feature, fix, refactor, or behavior change. Launch one instance of this agent per file that needs updating. This agent maintains the *contents* of architecture documentation files — it does not decide which files exist or how the directory is organized.\\n\\nExamples:\\n\\n- Example 1:\\n Context: A developer just fini
Alternatives in Development
- Systematic Debugger — Use this agent when you need to diagnose and fix bugs, errors, or unexpected behavior in code 39.2k ★
- New Track — Create a new track (feature, bug fix, chore, or refactor) with a detailed specification and phased i... - wsho 31.9k ★
- Shep Clean Arch Auditor — Read-only clean architecture auditor for shep 247 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Doc Librarian
Use when a wizard run needs documentation review — before building, to survey the docs the change touches (wha
Code Refactor Master
Execute refactoring tasks — reorganize files, extract components, update imports, fix patterns across the code
Arch Debugger
Isolate a bug to a specific module or contract boundary, produce a minimal repro, and fix it without breaking
Refactoring Advisor
Code refactoring advisor. Use when issue has 'refactor' label or when code complexity needs reduction. Identif
Quality Checker
Runs the full quality pipeline (type-checking, linting, tests) and returns a concise summary of issues. Use af
Component Orchestrator
End-to-end component pipeline orchestrator. Invoked when a component is created or significantly updated. Veri
Related Skills
Claude Linear Sync
Automated Linear ticket tracking for Claude Code — tickets created on task start, updated on commit, closed wh
Cologne Alert Triage
Created: 16-06-2026 · Last updated: 05-09-2026
Driftless
AI-native SDLC outer-loop CLI for coding agents — manages work lifecycle: Created → Specifying → Planning → Im