# rindig/interpreted-context-methdology architecture

> Architecture diagram of the GitHub repository rindig/interpreted-context-methdology, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-06-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rindig/interpreted-context-methdology
- Repository: https://github.com/rindig/interpreted-context-methdology

## Overview

1. **What this repo is**
   This is not a software application in the usual sense; it is a repository of **filesystem-based AI workflows**. The core idea is that folder structure, markdown prompts, and staged output files replace a traditional orchestration framework.

2. **Repository-level layers**
   The root contains the methodology and the reusable scaffolding:
   - `README.md` explains the ICM approach.
   - `CLAUDE.md` is the always-loaded top-level agent entrypoint.
   - `_core/` holds the canonical conventions, placeholder syntax, and reusable templates.
   - `workspaces/` contains concrete workflows for different domains.

3. **The architectural unit: a workspace**
   Each workspace is a self-contained pipeline with its own:
   - `CLAUDE.md` and `CONTEXT.md` for routing and role definition
   - `setup/` questionnaire for one-time configuration
   - `shared/` domain-wide constants or resources
   - `skills/` specialized knowledge bundles and helper scripts
   - `stages/` numbered stage folders with `CONTEXT.md`, `references/`, and `output/`

4. **How data moves**
   The main data flow is **stage output becomes the next stage’s input**. Each stage writes plain-text artifacts into its `output/` directory, and later stages read those files. Humans can edit the output between stages, so the filesystem is both the transport layer and the review surface.

5. **How agents are scoped**
   The repo uses a layered context model:
   - root-level Claude instructions
   - workspace-level routing context
   - stage-level contracts in each `CONTEXT.md`
   - stage references and shared knowledge
   - working artifacts from previous stages
   This keeps each stage narrowly focused and prevents loading the whole repo into context.

6. **Conventions as the real framework**
   `_core/CONVENTIONS.md` is the central policy document. It defines the rules that make the system work: one stage per job, one-way references, canonical sources, selective file loading, checkpoints, audits, and questionnaire-driven setup. This file functions like the architecture spec for all workspaces.

7. **Workspace-builder subsystem**
   `workspaces/workspace-builder` is itself an ICM pipeline for generating new ICM workspaces. Its stages are:
   - discovery
   - mapping
   - scaffolding
   - questionnaire design
   - validation
   This is the meta-workflow that standardizes how new workspaces are created and ensures they follow the conventions.

8. **Course-deck-production pipeline**
   `workspaces/course-deck-production` turns unstructured source material into polished slide decks. Its stages are:
   - extraction
   - curriculum
   - outline
   - generation
   - QA delivery
   Supporting assets include a `design-system/`, shared course metadata, and a PPTX skill bundle with OOXML tooling. This workspace is heavily oriented around PowerPoint/PPTX structure, slide patterns, and output validation.

9. **Script-to-animation pipeline**
   `workspaces/script-to-animation` converts a content idea into a script, then into an animation specification, then into Remotion build output. Its stages are:
   - script
   - spec
   - build
   It includes frontend design guidance plus Remotion best-practices docs, which indicate that the final deliverable is code-driven motion graphics rather than a static document.

10. **Voice-driven-animation pipeline**
    `workspaces/voice-driven-animation` is a more media-rich pipeline:
    - research
    - script
    - voice
    - animate
    - render
    It adds external-media steps through dedicated skills for ElevenLabs narration generation and Whisper-based beat detection/transcription. This workspace bridges text, audio, timing analysis, and Remotion scene construction.

11. **Skills as portable capability packs**
    The `skills/` folders are reusable knowledge and helper-script bundles. They are not stages themselves; they are selectively loaded support material. Examples include:
    - PPTX/OOXML handling and validation scripts
    - Remotion scene and composition best practices
    - ElevenLabs audio generation
    - Whisper transcription and beat finding
    These skills materially shape how stage outputs are produced.

12. **Shared, stable configuration versus run-specific artifacts**
    The repo separates durable configuration from run output:
    - `shared/` and `design-system/` hold stable reference material
    - `references/` under each stage encode stage-specific rules
    - `output/` contains transient artifacts for the current run
    Output folders are intentionally empty in the repo except for `.gitkeep`, reinforcing that the important runtime state is generated per execution.

13. **Human-in-the-loop control points**
    This architecture is built for sequential workflows with review gates. Stages can include checkpoints and audits, so the agent pauses, the human can steer, and then the pipeline continues. That makes the system closer to a controlled production line than an autonomous agent swarm.

14. **Boundary of the whole system**
    The repo’s boundary is the workspace folder itself. There is no central server, queue, or database. The important integration points are:
    - markdown files as prompts and contracts
    - local folders as state
    - external tools only where a workspace requires them, such as Remotion, PowerPoint/OOXML tooling, ElevenLabs, or Whisper
    The architecture is therefore local-first, file-first, and intentionally transparent.

Main entry points: [`_core/CONVENTIONS.md`](https://github.com/rindig/interpreted-context-methdology/blob/main/_core/CONVENTIONS.md) (Conventions), [`workspaces/script-to-animation/CONTEXT.md`](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/CONTEXT.md) (Script context), [`workspaces/course-deck-production/CONTEXT.md`](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/CONTEXT.md) (Course context), [`workspaces/workspace-builder/CONTEXT.md`](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/CONTEXT.md) (Builder context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_root["Repo root"]
  node_readme["README<br/>methodology<br/>[README.md]"]
  node_root_claude["Root Claude<br/>agent entrypoint<br/>[CLAUDE.md]"]
end

subgraph group_core["Core framework"]
  node_conventions["Conventions<br/>architecture spec<br/>[CONVENTIONS.md]"]
  node_placeholders["Placeholders<br/>syntax"]
  node_workspace_claude_tpl["Claude template"]
  node_workspace_context_tpl["Context template"]
  node_stage_context_tpl["Stage template"]
  node_questionnaire_tpl["Questionnaire template"]
end

subgraph group_ws_builder["Workspace builder"]
  node_builder_claude["Builder Claude<br/>workspace entrypoint<br/>[CLAUDE.md]"]
  node_builder_context["Builder context<br/>workspace routing<br/>[CONTEXT.md]"]
  node_builder_refs["Builder refs<br/>reference set"]
  node_builder_setup["Builder setup<br/>questionnaire<br/>[questionnaire.md]"]
  node_builder_discovery["Discovery<br/>stage<br/>[CONTEXT.md]"]
  node_builder_mapping["Mapping<br/>stage<br/>[CONTEXT.md]"]
  node_builder_scaffold["Scaffolding<br/>stage<br/>[CONTEXT.md]"]
  node_builder_questions["Questionnaire design<br/>stage<br/>[CONTEXT.md]"]
  node_builder_validate["Validation<br/>stage<br/>[CONTEXT.md]"]
end

subgraph group_course_deck["Course deck production"]
  node_course_claude["Course Claude<br/>workspace entrypoint<br/>[CLAUDE.md]"]
  node_course_context["Course context<br/>workspace routing<br/>[CONTEXT.md]"]
  node_course_design["Design system<br/>shared design<br/>[CONTEXT.md]"]
  node_course_shared["Shared assets<br/>shared metadata<br/>[course-meta.md]"]
  node_course_pptx["PPTX skill<br/>tooling skill<br/>[SKILL.md]"]
  node_course_extract["Extraction<br/>stage<br/>[CONTEXT.md]"]
  node_course_outline["Outline<br/>stage<br/>[CONTEXT.md]"]
  node_course_generate["Generation<br/>stage<br/>[CONTEXT.md]"]
  node_course_qa["QA delivery<br/>stage<br/>[CONTEXT.md]"]
end

subgraph group_script_anim["Script to animation"]
  node_script_claude["Script Claude<br/>workspace entrypoint<br/>[CLAUDE.md]"]
  node_script_context["Script context<br/>workspace routing<br/>[CONTEXT.md]"]
  node_brand_vault["Brand vault<br/>brand guidance<br/>[CONTEXT.md]"]
  node_remotion_skill["Remotion skill<br/>tooling skill<br/>[SKILL.md]"]
  node_script_stage["Script<br/>stage<br/>[CONTEXT.md]"]
  node_spec_stage["Spec<br/>stage<br/>[CONTEXT.md]"]
  node_build_stage["Build<br/>stage<br/>[CONTEXT.md]"]
end

subgraph group_voice_anim["Voice-driven animation"]
  node_voice_claude["Voice Claude<br/>workspace entrypoint<br/>[CLAUDE.md]"]
end

node_readme -->|"explains"| node_conventions
node_root_claude -->|"loads"| node_conventions
node_conventions -->|"shapes"| node_workspace_claude_tpl
node_conventions -->|"shapes"| node_workspace_context_tpl
node_conventions -->|"shapes"| node_stage_context_tpl
node_conventions -->|"shapes"| node_questionnaire_tpl
node_builder_claude -->|"routes"| node_builder_context
node_builder_context -->|"uses"| node_builder_refs
node_builder_context -->|"boots"| node_builder_setup
node_builder_context -->|"starts"| node_builder_discovery
node_builder_discovery -->|"feeds"| node_builder_mapping
node_builder_mapping -->|"feeds"| node_builder_scaffold
node_builder_scaffold -->|"feeds"| node_builder_questions
node_builder_questions -->|"feeds"| node_builder_validate
node_builder_validate -->|"checks"| node_conventions
node_course_claude -->|"routes"| node_course_context
node_course_context -->|"uses"| node_course_design
node_course_context -->|"uses"| node_course_shared
node_course_context -->|"uses"| node_course_pptx
node_course_context -->|"starts"| node_course_extract
node_course_extract -->|"feeds"| node_course_outline
node_course_outline -->|"feeds"| node_course_generate
node_course_generate -->|"feeds"| node_course_qa
node_script_claude -->|"routes"| node_script_context
node_script_context -->|"uses"| node_brand_vault
node_script_context -->|"uses"| node_remotion_skill
node_script_context -->|"starts"| node_script_stage
node_script_stage -->|"feeds"| node_spec_stage
node_spec_stage -->|"feeds"| node_build_stage
node_voice_claude -.->|"aligns with"| node_script_context
node_script_context -.->|"inherits"| node_stage_context_tpl

click node_readme "https://github.com/rindig/interpreted-context-methdology/blob/main/README.md"
click node_root_claude "https://github.com/rindig/interpreted-context-methdology/blob/main/CLAUDE.md"
click node_conventions "https://github.com/rindig/interpreted-context-methdology/blob/main/_core/CONVENTIONS.md"
click node_placeholders "https://github.com/rindig/interpreted-context-methdology/blob/main/_core/placeholder-syntax.md"
click node_workspace_claude_tpl "https://github.com/rindig/interpreted-context-methdology/blob/main/_core/templates/workspace-claude-template.md"
click node_workspace_context_tpl "https://github.com/rindig/interpreted-context-methdology/blob/main/_core/templates/workspace-context-template.md"
click node_stage_context_tpl "https://github.com/rindig/interpreted-context-methdology/blob/main/_core/templates/stage-context-template.md"
click node_questionnaire_tpl "https://github.com/rindig/interpreted-context-methdology/blob/main/_core/templates/questionnaire-template.md"
click node_builder_claude "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/CLAUDE.md"
click node_builder_context "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/CONTEXT.md"
click node_builder_refs "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/references/conventions-reference.md"
click node_builder_setup "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/setup/questionnaire.md"
click node_builder_discovery "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/01-discovery/CONTEXT.md"
click node_builder_mapping "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/02-mapping/CONTEXT.md"
click node_builder_scaffold "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/03-scaffolding/CONTEXT.md"
click node_builder_questions "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/04-questionnaire-design/CONTEXT.md"
click node_builder_validate "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/05-validation/CONTEXT.md"
click node_course_claude "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/CLAUDE.md"
click node_course_context "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/CONTEXT.md"
click node_course_design "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/design-system/CONTEXT.md"
click node_course_shared "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/shared/course-meta.md"
click node_course_pptx "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/skills/pptx/SKILL.md"
click node_course_extract "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/stages/01-extraction/CONTEXT.md"
click node_course_outline "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/stages/03-outline/CONTEXT.md"
click node_course_generate "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/stages/04-generation/CONTEXT.md"
click node_course_qa "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/stages/05-qa-delivery/CONTEXT.md"
click node_script_claude "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/CLAUDE.md"
click node_script_context "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/CONTEXT.md"
click node_brand_vault "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/brand-vault/CONTEXT.md"
click node_remotion_skill "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/skills/remotion-best-practices/SKILL.md"
click node_script_stage "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/stages/01-script/CONTEXT.md"
click node_spec_stage "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/stages/02-spec/CONTEXT.md"
click node_build_stage "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/stages/03-build/CONTEXT.md"
click node_voice_claude "https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/voice-driven-animation/CLAUDE.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme,node_root_claude toneBlue
class node_conventions,node_placeholders,node_workspace_claude_tpl,node_workspace_context_tpl,node_stage_context_tpl,node_questionnaire_tpl toneAmber
class node_builder_claude,node_builder_context,node_builder_refs,node_builder_setup,node_builder_discovery,node_builder_mapping,node_builder_scaffold,node_builder_questions,node_builder_validate toneMint
class node_course_claude,node_course_context,node_course_design,node_course_shared,node_course_pptx,node_course_extract,node_course_outline,node_course_generate,node_course_qa toneRose
class node_script_claude,node_script_context,node_brand_vault,node_remotion_skill,node_script_stage,node_spec_stage,node_build_stage toneIndigo
class node_voice_claude toneTeal
```

## Components

### Repo root

Methodology and top-level entrypoints

- [README](https://github.com/rindig/interpreted-context-methdology/blob/main/README.md): methodology · Explains the ICM approach and repository structure · `README.md`
- [Root Claude](https://github.com/rindig/interpreted-context-methdology/blob/main/CLAUDE.md): agent entrypoint · Always-loaded top-level instructions for the repository · `CLAUDE.md`

### Core framework

Shared conventions, syntax, and templates

- [Conventions](https://github.com/rindig/interpreted-context-methdology/blob/main/_core/CONVENTIONS.md): architecture spec · Canonical rules for staged, file-based workflows · `_core/CONVENTIONS.md`
- [Placeholders](https://github.com/rindig/interpreted-context-methdology/blob/main/_core/placeholder-syntax.md): syntax · Placeholder and substitution syntax used across templates · `_core/placeholder-syntax.md`
- [Claude template](https://github.com/rindig/interpreted-context-methdology/blob/main/_core/templates/workspace-claude-template.md): template · Reusable template for workspace-level Claude instructions · `_core/templates/workspace-claude-template.md`
- [Context template](https://github.com/rindig/interpreted-context-methdology/blob/main/_core/templates/workspace-context-template.md): template · Reusable template for workspace routing context · `_core/templates/workspace-context-template.md`
- [Stage template](https://github.com/rindig/interpreted-context-methdology/blob/main/_core/templates/stage-context-template.md): template · Reusable template for stage-level context contracts · `_core/templates/stage-context-template.md`
- [Questionnaire template](https://github.com/rindig/interpreted-context-methdology/blob/main/_core/templates/questionnaire-template.md): template · Reusable template for setup questionnaires · `_core/templates/questionnaire-template.md`

### Workspace builder

Meta-workflow for generating new workspaces

- [Builder Claude](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/CLAUDE.md): workspace entrypoint · Workspace-level routing instructions for generating workspaces · `workspaces/workspace-builder/CLAUDE.md`
- [Builder context](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/CONTEXT.md): workspace routing · Defines the workspace-builder role and execution model · `workspaces/workspace-builder/CONTEXT.md`
- [Builder refs](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/references/conventions-reference.md): reference set · Conventions references and examples used by the builder · `workspaces/workspace-builder/references/conventions-reference.md`
- [Builder setup](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/setup/questionnaire.md): questionnaire · Initial setup questionnaire for the builder workspace · `workspaces/workspace-builder/setup/questionnaire.md`
- [Discovery](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/01-discovery/CONTEXT.md): stage · Finds the source material and constraints for a new workspace · `workspaces/workspace-builder/stages/01-discovery/CONTEXT.md`
- [Mapping](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/02-mapping/CONTEXT.md): stage · Maps the intended pipeline structure to conventions · `workspaces/workspace-builder/stages/02-mapping/CONTEXT.md`
- [Scaffolding](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/03-scaffolding/CONTEXT.md): stage · Generates the workspace structure and baseline files · `workspaces/workspace-builder/stages/03-scaffolding/CONTEXT.md`
- [Questionnaire design](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/04-questionnaire-design/CONTEXT.md): stage · Designs the setup questionnaire for the new workspace · `workspaces/workspace-builder/stages/04-questionnaire-design/CONTEXT.md`
- [Validation](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/workspace-builder/stages/05-validation/CONTEXT.md): stage · Checks the generated workspace against conventions · `workspaces/workspace-builder/stages/05-validation/CONTEXT.md`

### Course deck production

Pipeline for turning source material into slide decks

- [Course Claude](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/CLAUDE.md): workspace entrypoint · Workspace-level instructions for course deck production · `workspaces/course-deck-production/CLAUDE.md`
- [Course context](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/CONTEXT.md): workspace routing · Defines the course-deck-production workspace role and flow · `workspaces/course-deck-production/CONTEXT.md`
- [Design system](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/design-system/CONTEXT.md): shared design · Stable visual guidance for slide formatting and typography · `workspaces/course-deck-production/design-system/CONTEXT.md`
- [Shared assets](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/shared/course-meta.md): shared metadata · Reusable course metadata and producer identity · `workspaces/course-deck-production/shared/course-meta.md`
- [PPTX skill](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/skills/pptx/SKILL.md): tooling skill · PPTX and OOXML tooling, validation, and transformation helpers · `workspaces/course-deck-production/skills/pptx/SKILL.md`
- [Extraction](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/stages/01-extraction/CONTEXT.md): stage · Pulls source material into structured notes · `workspaces/course-deck-production/stages/01-extraction/CONTEXT.md`
- [Outline](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/stages/03-outline/CONTEXT.md): stage · Shapes curriculum content into slide-ready structure · `workspaces/course-deck-production/stages/03-outline/CONTEXT.md`
- [Generation](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/stages/04-generation/CONTEXT.md): stage · Builds deck artifacts from the outline and design system · `workspaces/course-deck-production/stages/04-generation/CONTEXT.md`
- [QA delivery](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/course-deck-production/stages/05-qa-delivery/CONTEXT.md): stage · Validates output and prepares final delivery · `workspaces/course-deck-production/stages/05-qa-delivery/CONTEXT.md`

### Script to animation

Pipeline from content idea to Remotion build

- [Script Claude](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/CLAUDE.md): workspace entrypoint · Workspace-level instructions for script-to-animation · `workspaces/script-to-animation/CLAUDE.md`
- [Script context](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/CONTEXT.md): workspace routing · Defines the script-to-animation workspace role and flow · `workspaces/script-to-animation/CONTEXT.md`
- [Brand vault](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/brand-vault/CONTEXT.md): brand guidance · Voice and identity constraints for script and animation output · `workspaces/script-to-animation/brand-vault/CONTEXT.md`
- [Remotion skill](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/skills/remotion-best-practices/SKILL.md): tooling skill · Remotion scene anatomy and best-practice rules · `workspaces/script-to-animation/skills/remotion-best-practices/SKILL.md`
- [Script](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/stages/01-script/CONTEXT.md): stage · Creates the narrative script from the content idea · `workspaces/script-to-animation/stages/01-script/CONTEXT.md`
- [Spec](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/stages/02-spec/CONTEXT.md): stage · Converts the script into an animation specification · `workspaces/script-to-animation/stages/02-spec/CONTEXT.md`
- [Build](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/script-to-animation/stages/03-build/CONTEXT.md): stage · Produces the Remotion build output · `workspaces/script-to-animation/stages/03-build/CONTEXT.md`

### Voice-driven animation

Pipeline adding research, narration, and render steps

- [Voice Claude](https://github.com/rindig/interpreted-context-methdology/blob/main/workspaces/voice-driven-animation/CLAUDE.md): workspace entrypoint · Workspace-level instructions for voice-driven animation · `workspaces/voice-driven-animation/CLAUDE.md`

## Connections

- README → Conventions: explains · Methodology documentation points to the governing conventions
- Root Claude → Conventions: loads · Top-level agent instructions rely on the shared policy file
- Conventions → Claude template: shapes · Workspace instructions are derived from the canonical conventions
- Conventions → Context template: shapes · Workspace routing context follows the same architecture rules
- Conventions → Stage template: shapes · Stage contracts are standardized by the conventions
- Conventions → Questionnaire template: shapes · Setup questionnaires are convention-driven
- Builder Claude → Builder context: routes · Workspace entrypoint delegates into workspace-specific context
- Builder context → Builder refs: uses · The builder consults conventions references and examples
- Builder context → Builder setup: boots · The builder begins with a questionnaire-driven setup
- Builder context → Discovery: starts · Execution begins with discovery
- Discovery → Mapping: feeds · Discovery output becomes mapping input
- Mapping → Scaffolding: feeds · Mapping drives workspace scaffolding
- Scaffolding → Questionnaire design: feeds · Scaffolding informs questionnaire design
- Questionnaire design → Validation: feeds · Questionnaire design is validated before completion
- Validation → Conventions: checks · Validation compares the generated workspace against the core rules
- Course Claude → Course context: routes · Course workspace entrypoint delegates into workspace context
- Course context → Design system: uses · Slide production uses the design system as stable guidance
- Course context → Shared assets: uses · Shared metadata and identity shape deck production
- Course context → PPTX skill: uses · PPTX skill bundle supports generation and validation
- Course context → Extraction: starts · The pipeline begins with extraction
- Extraction → Outline: feeds · Extraction output informs outline creation
- Outline → Generation: feeds · Outline drives deck generation
- Generation → QA delivery: feeds · Generated deck artifacts move into QA delivery
- Script Claude → Script context: routes · Workspace entrypoint delegates into workspace context
- Script context → Brand vault: uses · Brand guidance constrains script and animation choices
- Script context → Remotion skill: uses · Remotion best practices guide the build pipeline
- Script context → Script: starts · The pipeline begins with script creation
- Script → Spec: feeds · Script output becomes animation spec input
- Spec → Build: feeds · Specification drives the final build stage
- Voice Claude → Script context: aligns with · Voice-driven animation shares the same workspace-style routing model
- Script context → Stage template: inherits · Workspace stage contexts follow the shared stage contract template