dot-folder-architecture

Scaffold and validate .claude/ directory structures for Claude Code projects.

31|2|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/vonchitzki/claude-project-template --skill dot-folder-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dot-folder-architecture
Source: https://github.com/vonchitzki/claude-project-template/tree/main
Command: npx skills add https://github.com/vonchitzki/claude-project-template --skill dot-folder-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the issue of brittle, inconsistent Claude Code setups by enforcing a clear separation of concerns between behavioural rules, domain knowledge, and runtime state.

Core Features & Use Cases

  • Project Scaffolding: Instantly generate a production-ready .claude/ directory structure.
  • Setup Auditing: Validate existing projects against the CALMER framework to ensure they are handoff-ready.
  • Use Case: Use this when starting a new project or when your current Claude instructions have become too cluttered to manage effectively.

Quick Start

Run the dot-folder-architecture skill to scaffold a new project structure in your current directory.

Frequently Asked Questions about dot-folder-architecture

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

FAQPage Schema
How do I standardize my Claude Code workspace architecture for consistent agent behavior?

You can standardize your Claude Code workspace by enforcing a modular directory structure for rules, context, and memory. This approach separates behavioral rules from domain knowledge to ensure auditability and team handoff readiness.

What is the best way to audit an existing Claude Code project for team handoff readiness?

The best way to audit an existing project is to validate it against the CALMER framework. This checks your directory structure and configuration to ensure environment-aware settings and explicit trigger mapping for automated workflows.

How do I scaffold a production-ready directory structure for Claude Code configurations?

You can generate a production-ready directory structure by running the scaffolding process in your current directory. This instantly creates a modular setup enforcing a clear separation of concerns between behavioral rules and runtime state.

Does Claude Code work with environment-aware settings and explicit trigger mapping?

Yes, Claude Code supports environment-aware settings and explicit trigger mapping for automated workflows. Structuring your project with standardized directories ensures these configurations are correctly applied during runtime.

When should I restructure my Claude Code instructions and project context?

You should restructure your Claude Code instructions when your current setup becomes too cluttered to manage effectively. Applying a standardized architecture resolves brittle configurations by separating domain knowledge from runtime state.

Why does my Claude Code setup have inconsistent agent behavior across different sessions?

Inconsistent agent behavior often stems from a brittle project setup lacking a clear separation of concerns. Enforcing a modular directory structure for rules, context, and memory standardizes the environment and resolves this issue.