skills.rest
brmatola
brmatolaCOMMUNITY
Explore all skills by this author →
GitHub

writing-claude-md-files

Create top-level and domain-level CLAUDE.md files with Last verified dates and contracts for Claude projects.

Updated Jan 17, 2026
Search Tags:#architecture#templates#documentation#CLAUDE.md#contracts#project-structure
One-click install
npx skills add https://github.com/brmatola/gremlins --skill writing-claude-md-files-brmatola
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-claude-md-files
Source: https://github.com/brmatola/gremlins/tree/main/skills/writing-claude-md-files
Command: npx skills add https://github.com/brmatola/gremlins --skill writing-claude-md-files-brmatola

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md files help preserve architectural intent across sessions by storing context and contracts so humans don't re-explain it every time.

Core Features & Use Cases

  • Top-level CLAUDE.md captures project-wide WHAT and HOW
  • Subdirectory CLAUDE.md captures domain-level WHY and CONTRACTS
  • Freshness requirement enforces a Last verified date to ensure contracts stay current

Quick Start

Create a top-level CLAUDE.md for your project and a CLAUDE.md for each domain, including a Last verified date.

Frequently Asked Questions about writing-claude-md-files

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

FAQPage Schema
How do I preserve architectural intent across Claude sessions?▼

You preserve architectural intent by storing context and contracts in CLAUDE.md files, ensuring humans don't re-explain project boundaries and structure every time a new session starts.

What is the best way to structure CLAUDE.md files for multi-domain projects?▼

Use a top-level CLAUDE.md for project-wide guidance and subdirectory files for domain-level contracts, enforcing mandatory Last verified dates to ensure documentation stays current.

Do I need a Last verified date in my CLAUDE.md documentation?▼

Yes, a Last verified date is mandatory in CLAUDE.md files to enforce freshness and ensure your architectural contracts and boundaries stay current with the actual project structure.

What should go into top-level vs subdirectory CLAUDE.md files?▼

Top-level CLAUDE.md captures project-wide WHAT and HOW, while subdirectory files capture domain-level WHY and CONTRACTS to define clear boundaries for specific project areas.

Can I use CLAUDE.md templates for project architecture contracts?▼

Yes, you can apply standardized templates to CLAUDE.md files to enforce clear structure for contracts and boundaries, ensuring consistent architectural documentation across multi-domain projects.

Related Skills

Explore More Software Engineering Skills→
luanzebaluanzeba

teach-impeccable

Gather project design context and generate a CLAUDE.md Design Context document.

Community
Intermediate
TK-Evans01TK-Evans01

writing-claude-md-files

Generate and maintain CLAUDE.md files for projects and subdirectories.

Community
Intermediate
t0dorakist0dorakis
32

architecture-decision-records

Create and manage Architecture Decision Records using established templates.

Community
Intermediate
ayubunayubun
8

writing-agents-md-files

Generate AGENTS.md files with templates and mandatory freshness dates.

Community
Intermediate