project-structure

Generate and maintain a .claude/structure.md documenting directories, key files, and purposes.

5|1|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/microbians/AI.SKILLS --skill project-structure-microbians
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-structure
Source: https://github.com/microbians/AI.SKILLS/tree/main/skills/project-structure
Command: npx skills add https://github.com/microbians/AI.SKILLS --skill project-structure-microbians

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Auto-generates and keeps an up-to-date map of a codebase by producing a readable .claude/structure.md that documents directory trees, key files, and their purposes.

Core Features & Use Cases

  • Directory tree with annotated descriptions for quick orientation.
  • Key-file identification and relationship mapping to clarify project structure.
  • Self-healing: regenerates the structure when missing or outdated.
  • Auto-installation on first session in a project.

Quick Start

Run the auto-install in the project root to generate and maintain .claude/structure.md.

Frequently Asked Questions about project-structure

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

FAQPage Schema
How do I automatically generate and maintain documentation for my codebase structure?

You can automatically generate a living map of your codebase by running an auto-install command in the project root, which scans the repository and produces a readable `.claude/structure.md` file. This file documents directory trees, key files, and their purposes for quick orientation.

What is self-healing project structure documentation and how does it work?

Self-healing project structure documentation automatically regenerates the `.claude/structure.md` file when it detects the codebase map is missing or outdated. It scans the current repository state, filters out noise, and updates the directory tree and key-file annotations to reflect the latest changes.

Can I document project structure across different programming languages and project types?

Yes, the project structure documentation works across languages and project types by scanning the repository and filtering noise to annotate parts of the tree. It identifies key files and maps their relationships regardless of the specific tech stack you are using.

What's the best way to map directory trees and key files for quick orientation in a new project?

The best way to map directory trees is to use an auto-installed structure generator that scans the repository and produces a `.claude/structure.md` file. This file provides annotated descriptions of directories and key files, clarifying project organization and relationships for quick orientation.

Does project structure documentation work with OpenCode-compatible workflows?

Yes, the generated `.claude/structure.md` file meets automated discovery requirements and supports OpenCode-compatible workflows. It ensures the project structure map is easily accessible and integrates with automated codebase orientation processes.

Why does my codebase structure map need to be regenerated automatically?

Your codebase structure map needs automatic regeneration to remain a living document that accurately reflects ongoing development. As directories and key files change, self-healing regeneration updates the `.claude/structure.md` file to prevent outdated documentation and maintain quick orientation.