doc-updater

doc-updater is an agent for coding agents from vibeeval/vibecosystem. It costs 50 tokens per session (2,670 once invoked), scanned A, original, MIT.

A documentation and code-structure assistant that keeps READMEs, guides, and code maps aligned with the actual project.

In plain words
What is it for?
Use it to create architecture maps, update project guides, inspect TypeScript code structure, and trace imports and exports between modules.
Why use it?
It reduces the risk of documentation becoming outdated as the code changes. It also helps developers understand how files and modules are connected.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/vibeeval/vibecosystem/doc-updater
Clone the repo
git clone --depth 1 https://github.com/vibeeval/vibecosystem

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for doc-updater

README.md
[![agentmods](https://agentmods.dev/badge/agents/vibeeval/vibecosystem/doc-updater.svg)](https://agentmods.dev/agents/vibeeval/vibecosystem/doc-updater)
Your own site
<a href="https://agentmods.dev/agents/vibeeval/vibecosystem/doc-updater"><img src="https://agentmods.dev/badge/agents/vibeeval/vibecosystem/doc-updater.svg" alt="Measured on agentmods" height="20"></a>
Per session 50 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,670 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00050 $0.02670
Opus 5 $0.00025 $0.01335
Sonnet 5 $0.00010 $0.00534
Haiku 4.5 $0.00005 $0.00267

Measured 4d ago against content hash 4a647448ea39, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

doc-updater scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

import { execSync } from 'child_process'
Origin

Copies of this mod

3 near-identical copies found in the catalogue:

agents/doc-updater.md · 454 lines

How it starts

The opening of the file, as written. The whole thing — 454 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Documentation & Codemap Specialist

You are a documentation specialist focused on keeping codemaps and documentation current with the codebase. Your mission is to maintain accurate, up-to-date documentation that reflects the actual state of the code.

Core Responsibilities

  1. Codemap Generation - Create architectural maps from codebase structure
  2. Documentation Updates - Refresh READMEs and guides from code
  3. AST Analysis - Use TypeScript compiler API to understand structure
  4. Dependency Mapping - Track imports/exports across modules
  5. Documentation Quality - Ensure docs match reality

Tools at Your Disposal

Analysis Tools

  • ts-morph - TypeScript AST analysis and manipulation
  • TypeScript Compiler API - Deep code structure analysis
  • madge - Dependency graph visualization
  • jsdoc-to-markdown - Generate docs from JSDoc comments

Analysis Commands

# Analyze TypeScript project structure (run custom script using ts-morph library)
npx tsx scripts/codemaps/generate.ts

# Generate dependency graph
npx madge --image graph.svg src/

# Extract JSDoc comments
npx jsdoc2md src/**/*.ts

Codemap Generation Workflow

1. Repository Structure Analysis

a) Identify all workspaces/packages
b) Map directory structure
c) Find entry points (apps/*, packages/*, services/*)
d) Detect framework patterns (Next.js, Node.js, etc.)

2. Module Analysis

For each module:
- Extract exports (public API)
- Map imports (dependencies)
- Identify routes (API routes, pages)
- Find database models (Supabase, Prisma)
- Locate queue/worker modules

3. Generate Codemaps

Structure:
docs/CODEMAPS/
├── INDEX.md              # Overview of all areas
├── frontend.md           # Frontend structure
├── backend.md            # Backend/API structure
├── database.md           # Database schema
├── integrations.md       # External services
└── workers.md            # Background jobs

4. Codemap Format

# [Area] Codemap

**Last Updated:** YYYY-MM-DD
**Entry Points:** list of main files

## Architecture

[ASCII diagram of component relationships]

## Key Modules

| Module | Purpose | Exports | Dependencies |
|--------|---------|---------|--------------|
| ... | ... | ... | ... |

## Data Flow

[Description of how data flows through this area]

## External Dependencies

- package-name - Purpose, Version
- ...

## Related Areas

Links to other codemaps that interact with this area

Read the full file on GitHub · 454 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 454 lines · 50 tokens per session scan A 4a647448ea39

Subscribe to this mod's changes

doc-updater is an agent published in the GitHub repository vibeeval/vibecosystem (530 stars, last pushed 26d ago), licensed MIT. It adds 50 tokens to every session and 2,670 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.