# Microkeeper Motion Playbook

This repo contains the complete source for the Microkeeper Motion Playbook site and its two browser-made motion films.

## What is included

- The playbook website in `app/`
- The Hire to retire interactive film in `public/videos/hire-to-retire/`
- The AI agents showcase in `public/videos/ai-agents/`
- A reusable starter prompt, neutral brand-context template and motion-technique library in `public/resources/`
- An attributed link to Atlassian's public `DESIGN.md` as an external format example
- A representative timing plan and browser/FFmpeg renderer

Everything required by the starter prompt is included in this repo. There are no references to the original internal workspace folders.

## Run the complete playbook

Prerequisite: Node.js 22.13 or later.

```bash
npm install
npm run dev
```

The terminal will print the local URL. The complete site, both interactive films, resource downloads and prompts will be available there.

To verify a production build:

```bash
npm test
```

## Work directly on a film

The two film folders contain self-contained HTML, CSS, JavaScript and media assets. They can be copied into another repo or served with any basic local web server.

For the best LLM-agent context, open the full repo and ask the agent to inspect:

1. `public/resources/brand-context-template.md`, completed with your own public brand material
2. `public/resources/browser-motion-technique-prompt-library.md`
3. The relevant folder under `public/videos/`
4. `public/resources/example-edit-plan.json` and `example-browser-renderer.mjs` if an MP4 is required

Start with `public/resources/microkeeper-motion-starter-prompt.txt`, complete the brand-context template, replace the bracketed sections, and add any product screenshots, real terminology or audio required for the new story.
