Folder README Architect
Crafts purposeful internal directory documentation that explains organizational logic and architectural context.
The Folder README Architect skill provides a specialized framework for documenting internal project directories, moving beyond redundant file listings to focus on the 'why' behind directory structures. It guides Claude to explain mental models, organizational reasoning, and non-obvious context, helping developers understand how different parts of a codebase relate to one another. By emphasizing purpose over simple file enumeration, this skill ensures that internal documentation serves as a valuable map for current contributors and future maintainers.
Key Features
013,817 GitHub stars
02Promotes scannable and concise documentation styles
03Provides guidance on where to place new code
04Clarifies relationships between different project folders
05Focuses on organizational logic and mental models
06Eliminates redundant file listings and obvious context
Use Cases
01Improving codebase discoverability for new team members during onboarding
02Explaining the purpose of utility and converter directories during a refactor
03Standardizing documentation across a large-scale monorepo