newproject

name	newproject
description	Scaffold a new research project with standard directory structure, CLAUDE.md template, and documented README. Use this at the start of every new project to ensure consistent organization.
allowed-tools	Bash(mkdir*), Bash(cp*), Bash(ls*), Write, Read
argument-hint	["project-name"]

New Project Scaffold

Create a new research project folder with Scott's standard structure. This skill is invoked at the start of every project.

What Gets Created

[project-name]/
├── CLAUDE.md              # Permanent research rules (copied from template)
├── README.md              # Project-specific overview (auto-generated)
├── code/
│   ├── R/
│   ├── python/
│   └── stata/
├── data/
│   ├── raw/               # Original source data (never modify)
│   └── clean/             # Cleaned/merged datasets
├── output/
│   ├── tables/
│   └── figures/
├── documents/             # Outside PDFs, papers (use /split-pdf on these)
├── decks/                 # Beamer presentations (rhetoric of decks)
├── notes/                 # Scratch notes, random ideas, misc
└── progress_logs/         # Session continuity across Claude conversations

Execution

1. Get the project name from the argument. If none provided, ask.

   • Convert spaces to hyphens, lowercase

2. Determine location — default is current working directory. Confirm if unclear.

3. Create all directories:

   mkdir -p [project-name]/{code/{R,stata,python},data/{raw,clean},output/{figures,tables},documents,decks,notes,progress_logs}
   

4. Copy CLAUDE.md from ~/mixtapetools/claude/CLAUDE.md:

   • Replace [Your Name] with Scott
   • Update project name in the overview section

5. Generate README.md with:

   • Project title
   • Visual directory tree in a fenced code block (monospace)
   • Explanation of each folder's purpose
   • Note that CLAUDE.md is copied from a permanent template and edited per-project
   • Note that README.md is for project-specific documentation
   • Note that progress_logs/ maintains continuity across Claude sessions
   • Placeholder sections: Overview, Collaborators, Status, Key Files

   The README must include this tree block:

   ```
   [project-name]/
   ├── CLAUDE.md              # Research rules & estimation philosophy (permanent)
   ├── README.md              # This file — project-specific notes
   ├── code/
   │   ├── R/                 # R scripts
   │   ├── python/            # Python scripts
   │   └── stata/             # Stata do-files
   ├── data/
   │   ├── raw/               # Original source data (never modify these)
   │   └── clean/             # Cleaned and merged datasets
   ├── output/
   │   ├── tables/            # Generated tables (LaTeX, CSV)
   │   └── figures/           # Generated figures (PDF, PNG)
   ├── documents/             # Outside papers and PDFs (split with /split-pdf)
   ├── decks/                 # Beamer presentations (rhetoric of decks philosophy)
   ├── notes/                 # Scratch notes, ideas, miscellaneous
   └── progress_logs/         # Session logs for continuity across Claude conversations
   ```
   

6. Create initial progress log at progress_logs/YYYY-MM-DD_setup.md:

   • Record the creation date
   • List next steps as a checklist

7. Report success — show structure with ls, remind user to update CLAUDE.md.