update-project-docs

Analyze repository structure and update CLAUDE.md, DECISIONS.md, and SESSION.md.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fernando-fernandez3/claude-code-resources --skill update-project-docs-fernando-fernandez3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-project-docs
Source: https://github.com/fernando-fernandez3/claude-code-resources/tree/main/my-config/skills/update-project-docs
Command: npx skills add https://github.com/fernando-fernandez3/claude-code-resources --skill update-project-docs-fernando-fernandez3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates keeping project documentation in sync with code changes by analyzing the repository and updating CLAUDE.md, DECISIONS.md, and SESSION.md to reflect the current architecture, modules, and decisions.

Core Features & Use Cases

  • Analyze repository structure to extract modules, architecture references, and ongoing decisions.
  • Update CLAUDE.md with current architecture, module inventory, and reference points.
  • Refresh DECISIONS.md with recent architectural decisions and rationale, and update SESSION.md with the latest work notes.

Quick Start

Run the skill from the repository root to refresh documentation files and optionally commit changes.

Frequently Asked Questions about update-project-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep project documentation in sync with code changes automatically?

To keep project documentation in sync with code changes, this skill analyzes your repository structure, detects new modules and architecture updates, and automatically refreshes CLAUDE.md, DECISIONS.md, and SESSION.md to reflect the current state.

What is the best way to update CLAUDE.md when architecture decisions evolve?

The best way to update CLAUDE.md when architecture decisions evolve is to run this skill from the repository root, allowing it to detect structural changes and output guidance for updating architecture references and decision records.

How do I track major structural changes and new modules in my codebase documentation?

To track major structural changes and new modules in your codebase documentation, this skill reads the repository structure, extracts module inventories, and applies targeted updates to your project files to reflect the latest architecture.

When do I need to update DECISIONS.md and SESSION.md for my project?

You need to update DECISIONS.md and SESSION.md when architectural decisions evolve or new modules appear, ensuring recent rationale and the latest work notes are accurately recorded alongside code evolution.

Can I automatically refresh project docs without manually editing markdown files?

Yes, you can automatically refresh project docs by running the skill from the repository root, which analyzes the codebase and outputs documentation changes to CLAUDE.md, DECISIONS.md, and SESSION.md, with an option to commit changes.

Does this documentation update tool work with any repository structure?

This tool works by reading your existing repository structure to detect modules and architecture references, making it suitable for any codebase that utilizes CLAUDE.md, DECISIONS.md, and SESSION.md for documentation.