joelborellis/agents-mocumentary
Maybe the most fun repo I will ever work on. Not intended to build an application but the framework - using Claude Code - for developing a Mocumentary film.
npx skills add joelborellis/agents-mocumentaryREADME
Mockumentary Screenplay Project
A feature film screenplay in the mockumentary genre—fictional comedy shot in documentary style.
What This Is
This project uses Claude Code to develop a mockumentary screenplay from concept through pitch-ready materials. The workflow is supported by specialized skills that handle each phase of development.
Current Status
Phase: Concept Development (in progress)
This project is in active development. I'm currently working through the initial concept phase—defining the satirical target, establishing the world, and shaping the premise.
What you can explore now: dev/concept.md — the working concept document where the mockumentary's foundation is being developed.
Research artifacts: dev/research/ contains assets and artifacts created along the way—workflow diagrams, reference materials, and exploratory work produced during development. Worth a look if you want to see the process behind the project.
As the project progresses through subsequent phases (characters, structure, screenplay, revision, pitch), additional artifacts will appear in their respective directories.
The Genre
Mockumentary presents fictional stories as if they were real documentaries. The comedy comes from:
- Deadpan tone: Characters are completely earnest about absurd situations
- Talking head interviews: Characters speak directly to camera, often revealing more than they intend
- The gap: What characters believe about themselves vs. what we see
- Documentary conventions: Found footage, B-roll, camera acknowledged by subjects
Reference films: This Is Spinal Tap, Best in Show, The Office, Parks & Rec, What We Do in the Shadows
Project Phases
| Phase | What Happens |
|---|---|
| Concept Development | Premise, satirical target, world rules, stakes |
| Character & Story Foundation | Ensemble cast, character profiles, talking head voices |
| Structure & Outlining | Act breaks, sequences, documentary framing |
| Screenplay Writing | Pages in Fountain format |
| Revision & Polish | Comedy punch-up, tonal consistency, dialogue polish |
| Pitch Preparation | Logline, synopsis, one-pager, deck |
File Structure
project-root/
├── README.md ← You are here
├── Claude.md ← Project state tracker
├── script/
│ ├── screenplay.fountain
│ ├── treatment.md
│ └── outline.md
├── characters/
│ └── [character-name].md
├── pitch/
│ ├── logline.txt
│ ├── synopsis.md
│ ├── one-pager.md
│ └── deck/
└── dev/
├── concept.md
├── research/
└── revisions/
How to Work
- Track progress in
Claude.mdby checking off phases as you complete them - Work conversationally for creative exploration (concept, characters, dialogue)
- Use plan mode only when stepping back to assess structure or troubleshoot
- Document decisions in
dev/so context carries across sessions
Skills
This project uses six specialized skills:
mockumentary-concept— Premise and satirical angle developmentmockumentary-characters— Character creation with documentary voicesmockumentary-structure— Outlining with mockumentary conventionsmockumentary-screenplay— Fountain format screenplay writingmockumentary-revision— Polish and punch-up passesmockumentary-pitch— Pitch materials creation
Skills trigger automatically based on what you're working on.
Getting Started
Begin by developing your concept in dev/concept.md:
- What's being satirized?
- Why is a documentary crew there?
- What's at stake?
- Who are the key characters and what are their blind spots?
Then progress through phases, updating Claude.md as you go.