# Update Codebase Understanding > Update documents under `.aidocs` directory to reflect recent code changes. Use when new non-documentation commits occured since last ai documentation commit. Use when this capability is needed. - Skill: `tomevault-io/update-codebase-understanding` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/update-codebase-understanding` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/update-codebase-understanding/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/update-codebase-understanding --- You should update all documents under `.aidocs` directory. First fetch git commit history and identify all commits after the last commit with message starting with "ai docs:". Then analyze the code changes in those commits to identify what parts of the codebase were changed (files added, deleted, modified; functions/classes/structs added, deleted, modified; dependencies changed; overall architecture changed; etc). For each file changed, use `file-summarizer` agent or use `summarize-file` skill as fallback to get the updated summary of that file. If you use agent, you can start many agents in parallel for the files to summarize. Then update the documents under `.aidocs` directory accordingly with the updated file summaries. Make sure the documents accurately represent the current state of the codebase after the recent changes. After updating the documents, commit with `ai-docs-commit` skill with proper commit message as $ARGUMENTS. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/xcc-zach) — claim your Tome and manage your conversions.