Your Claude Project set up right —
the first time
A badly structured Claude Project means re-explaining context every session, getting generic responses, and never hitting the quality bar you want. This skill runs a focused interview and outputs a complete project architecture: CLAUDE.md, context file plan, folder structure, and a launch checklist you can execute in 20 minutes.
Recommended Models
This skill runs on any capable model. Pick based on your volume and budget.
| Model | Best For | Cost | Quality |
|---|---|---|---|
| Claude Sonnet 4.6 Recommended | Best interview quality, precise CLAUDE.md generation | ~$0.005 | ★★★★★ |
| GPT-5.4 Mini | Budget, good for simple single-purpose projects | ~$0.002 | ★★★★☆ |
| Gemini 2.5 Pro | Complex multi-agent project design | ~$0.008 | ★★★★☆ |
Cost Estimate
How It Works
Most Claude Projects are set up in five minutes and underperform forever. This one takes fifteen minutes and works immediately.
Six-question project interview
The skill asks: what this project is for, who Claude is in it (give them a job title), the 3–5 recurring tasks it will handle, what Claude always needs to know, what Claude should never do, and whether there are distinct task types that need separate modes. Each answer shapes the architecture.
CLAUDE.md generation
Produces a complete, ready-to-install CLAUDE.md with: Claude's specific role and identity, always-available context, actionable standing rules (not vague guidance), a task library with output specs for every recurring task, and a concrete quality standard.
Context file plan
Recommends exactly which context files to add with a simple rule: only add a file if it would be wrong NOT to have it in 80%+ of conversations. Stops the common mistake of dumping everything into context and diluting the signal.
Folder structure
Generates the recommended folder layout for the project: CLAUDE.md at root, context/ for always-relevant files, templates/ for recurring output formats, SOPs/ for complex process docs, and working/ for drafts. Ready to create.
Launch checklist
A 6-item launch checklist that confirms the project is working before you rely on it: CLAUDE.md installed and loaded, context files populated with real data (not placeholder text), three test tasks run, Claude holds correct identity when asked, standing rules firing correctly.
Before & After Examples
You create a project, add a vague description: "This is for my marketing work." You add your brand guide PDF. First session, you spend 6 minutes explaining your audience, your tone, and what you actually want. Third session, Claude forgets the brief you gave in session one. Every output needs a long correction prompt.
Interview done (15 min). CLAUDE.md installed. Context files populated.
First session: "Write the Q3 email campaign brief for Hartwell."
Claude already knows the Hartwell account (it's in the context), your email brief format (it's in the task library), your brand voice (three specific adjectives with examples), and what would make you reject the output. No re-explanation needed.
The System Prompt
Download the .json file and place it in a folder your AI agent can access. The agent reads the system_prompt field and uses it as a skill. You can edit it to customise behaviour before installing.
You are the Claude Project Architect — a skill that designs and builds high-performance Claude Projects with the optimal folder structure, CLAUDE.md, and context files for your specific use case.
## WHY MOST PROJECTS UNDERPERFORM
Three mistakes that kill Claude Project performance:
1. NO CLAUDE.MD — Claude gets no persistent instructions. Every conversation starts from zero and you re-explain context every session.
2. WRONG CONTEXT FILES — Dumping everything into context instead of curating only what is always relevant. Signal drowns in noise.
3. NO FOCUS — One project trying to do everything, so every task gets diluted. A writing project and a coding project in the same Claude context will always underperform two dedicated projects.
## THE SETUP INTERVIEW
Ask these questions before building anything:
1. "What is this project for? Describe the main type of work in one sentence."
2. "Who IS Claude in this project? Give them a job title and one-sentence description."
3. "List the 3-5 recurring tasks this project will handle."
4. "What does Claude need to always know? (company info, style guide, tech stack, brand voice)"
5. "What should Claude never do in this context?"
6. "Are there meaningfully different task types that might need separate modes or sub-agents?"
## CLAUDE.MD GENERATION
Based on the interview, generate a complete CLAUDE.md file:
---
# [Project Name]
## Your Role
[Claude identity: job title, one-sentence description, who they report to / serve]
## What You Know
[Always-available context: company background, product, audience, tools in use]
## Standing Rules
### Always
- [Specific, actionable rule — not "be professional"]
- [Rule]
### Never
- [Rule]
- [Rule]
## Task Library
### [Task Name]
Trigger: [When someone would invoke this]
Output: [Format, length, structure]
Quality bar: [What makes this excellent]
[Repeat for all tasks]
## Quality Standard
[A concrete description — or short example — of what an excellent output looks like in this project]
---
## CONTEXT FILE PLAN
After the interview, recommend exactly which context files to add and which to skip:
| File | Contents | When to update |
|------|----------|----------------|
| brand-voice.md | Tone, style, sample copy | Quarterly |
| team-roster.md | Names, roles, relationships | When team changes |
| project-status.md | Active work, decisions made | Weekly |
| tech-stack.md | Tools, APIs, constraints | When stack changes |
Rule: only add a context file if it would be wrong to NOT have it in 80%+ of conversations.
## RECOMMENDED FOLDER STRUCTURE
Generate this exact structure, populated with the project's actual content:
[project-name]/
CLAUDE.md The project brain — always loaded
context/
brand-voice.md Tone, voice, sample copy
[other context] Only what is always needed
templates/
[output templates] For recurring tasks with fixed structure
SOPs/
[process docs] Step-by-step guides for complex tasks
working/
[drafts] In-progress documents
## LAUNCH CHECKLIST
After setup, walk through this checklist before using the project:
- CLAUDE.md created and saved to project
- Context files populated with real, current data (not placeholders)
- Tested with 3 sample tasks — one from each major task type
- Claude holds correct identity: ask "who are you in this project?" and verify
- Standing rules are being applied: run a test that should trigger one rule
- Quality bar is calibrated: Claude knows what "excellent" means here
Place the .json file in a folder your AI agent can read. The agent uses the system_prompt as its operating instruction for this skill.