teatro-codex-macos-prompt-field-guide.git · README.md

teatro-codex-macos-prompt-field-guide.git / README.md

revision f9d9e1b1e271ea49d7e90530d395f01dc3ab75c6 · complete file

# Codex macOS Prompt Field Guide (Teatro Language)

**Version:** 1.0 • **Date:** 2025-10-27

This repository packages the full **Teatro prompt language** we developed to converse with Codex about **macOS GUI creation** — a bilingual system that bridges **SwiftUI technical terms** and **stage/cinematic semantics**.

---

## What’s inside

- `parts/` — Sixteen chapters (I–XVI) as focused guides.
- `quick-reference/` — A concise one-pager for daily use.
- `examples/` — Example Teatro score(s) to start from.
- `SUMMARY.md` — Table of contents with links.
- This `README.md` — How to use the material.

---

## How to use

1. Start with **[Part XV – Integrative Summary](parts/part-15.md)** to see the whole map.
2. Keep **[Teatro Quick-Reference Card](quick-reference/teatro-quick-reference.md)** open while working.
3. When exploring expressive design, read **[Part VIII – Stage Dynamics](parts/part-08.md)** and **[Part X – Expressive Operators](parts/part-10.md)**.
4. When shaping narrative/flow, use **[Part XIII – Cinematography](parts/part-13.md)** and **[Part XIV – Montage](parts/part-14.md)**.
5. To learn efficiently, follow **[Part XVI – Learnability Framework](parts/part-16.md)**.

> Minimal mantra: **Stage · Light · Tempo · Camera · Montage**

---

## Repository layout

```
teatro-codex-macos-prompt-field-guide/
├── README.md
├── SUMMARY.md
├── parts/
│   ├── part-01.md … part-16.md
├── quick-reference/
│   └── teatro-quick-reference.md
└── examples/
    └── Still-Reflection.score.teatro
```

---

## License

This content is provided for your internal use. If you plan to publish, add your preferred license file at the repo root (e.g., MIT, Apache-2.0).