projects/<project-name>/
├── dashboard.html a snapshot of this project's calendar, to zip and share
├── project.json
├── README.txt what each folder is for
├── source/ INPUTS (yours): long videos, <video>.transcript.txt, brief.txt
│ └── downloads/ videos and captions saved by `fetch` from a link
├── plan/ DECISIONS: plan.json, metadata.json, schedule.json, stats.json, sample-stats.json (test data, only while on), schedule-history.log, report.md
├── videos/ FINAL: 001.mp4, 002.mp4 and so on (what gets posted; the dashboard plays these)
├── thumbs/ 001.jpg and so on (posters)
└── work/ DISPOSABLE: cache, QA images, logs. Safe to delete at any time.
| Kind | Folders | Who writes it |
|---|---|---|
| Inputs | source/ |
You |
| Decisions | plan/ |
Claude writes plan.json, metadata.json and report.md; the tool owns schedule.json, stats.json and schedule-history.log |
| Deliverables | videos/, thumbs/, dashboard.html |
The tool |
| Disposable | work/ |
The tool |
source/downloads/ counts as an input too: fetch writes it, and you can delete a download once you're done with the project.
Nobody edits plan/schedule.json, videos/, thumbs/ or work/ by hand. Deleting work/ only costs a little time: the next run rebuilds caches. (It also holds render-log.json, so the next render re-renders everything and schedule needs a render first.)
- The dashboard loads videos and posters by relative path, so
dashboard.htmlmust stay next tovideos/andthumbs/. Move or zip the whole project folder as one unit. - Output names are zero-padded ids with no spaces:
001.mp4,002.jpg. - Project names use lowercase letters, digits and hyphens.
index.html is the live dashboard for every project: open it once and keep it open. It reads projects/dashboard-data.js (gitignored, rewritten by the CLI) and updates itself.
schedule-ledger.json (gitignored) records which posting slots each account has taken across all projects. config/local.json (gitignored) holds your own time zone, account and handle overrides.