How sorretai/icm works
ICM is a filesystem-based workflow architecture: one agent reads workspace and stage instructions, loads scoped references and prior artifacts, then writes editable outputs for later stages and human review. Numbered stages encode order; markdown files are the handoff and state mechanism. The repository demonstrates this pattern through course-deck, script-animation, voice-animation, and workspace-builder workspaces, with domain skills and configuration alongside them. The README documents the general sequencing and context model; edges for example workspaces reflect their documented stage order, not inspected runtime orchestration.
Main entry points: 02-script/CONTEXT.md Script · 03-voice/CONTEXT.md Voice Production · 04-animate/CONTEXT.md Animation · generate-audio.py Narration Tool
Components 34
ICM Core
- Folder Conventions
_core/CONVENTIONS.md - Workspace Templates
_core/templates - Workspace Context
workspaces/course-deck-production/CONTEXT.md
Course Deck
- Setup Questionnaire
workspaces/course-deck-production/setup/questionnaire.md - Brand and Design
workspaces/course-deck-production/design-system/CONTEXT.md - Source Extraction
workspaces/course-deck-production/stages/01-extraction/CONTEXT.md - Curriculum
workspaces/course-deck-production/stages/02-curriculum/CONTEXT.md - Slide Outline
workspaces/course-deck-production/stages/03-outline/CONTEXT.md - Deck Generation
workspaces/course-deck-production/stages/04-generation/CONTEXT.md - QA and Delivery
workspaces/course-deck-production/stages/05-qa-delivery/CONTEXT.md - PPTX Skills
workspaces/course-deck-production/skills/pptx/SKILL.md
Script Animation
- Script Context
workspaces/script-to-animation/CONTEXT.md - Script Writing
workspaces/script-to-animation/stages/01-script/CONTEXT.md - Animation Spec
workspaces/script-to-animation/stages/02-spec/CONTEXT.md - Animation Build
workspaces/script-to-animation/stages/03-build/CONTEXT.md - Remotion Guidance
workspaces/script-to-animation/skills/remotion-best-practices/SKILL.md
Voice Animation
- Voice Workflow
workspaces/voice-driven-animation/CONTEXT.md - Research
workspaces/voice-driven-animation/stages/01-research/CONTEXT.md - Script
workspaces/voice-driven-animation/stages/02-script/CONTEXT.md - Voice Production
workspaces/voice-driven-animation/stages/03-voice/CONTEXT.md - Animation
workspaces/voice-driven-animation/stages/04-animate/CONTEXT.md - Render
workspaces/voice-driven-animation/stages/05-render/CONTEXT.md - Narration Tool
workspaces/voice-driven-animation/skills/elevenlabs-narration/scripts/generate-audio.py - Whisper Transcription
workspaces/voice-driven-animation/skills/whisper-beat-finder/scripts/transcribe.py - Beat Timing
workspaces/voice-driven-animation/skills/whisper-beat-finder/scripts/find-beats.py
Workspace Builder
- Builder Context
workspaces/workspace-builder/CONTEXT.md - Workflow Discovery
workspaces/workspace-builder/stages/01-discovery/CONTEXT.md - Workflow Mapping
workspaces/workspace-builder/stages/02-mapping/CONTEXT.md - Workspace Scaffolding
workspaces/workspace-builder/stages/03-scaffolding/CONTEXT.md - Questionnaire Design
workspaces/workspace-builder/stages/04-questionnaire-design/CONTEXT.md - Workspace Validation
workspaces/workspace-builder/stages/05-validation/CONTEXT.md
Other components
- Practitioner
- Single Agent
- ElevenLabs
Connections 34
- Practitioner → Single Agent: provides task
- Single Agent → Folder Conventions: reads conventions
- Single Agent → Workspace Context: reads routing
- Workspace Templates → Workspace Context: informs structure
- Practitioner → Setup Questionnaire: sets preferences
- Single Agent → Brand and Design: loads references
- Single Agent → Source Extraction: executes stage
- Source Extraction → Curriculum: hands off output
- Curriculum → Slide Outline: hands off output
- Slide Outline → Deck Generation: hands off output
- Deck Generation → QA and Delivery: hands off deck
- Single Agent → PPTX Skills: loads guidance
- Single Agent → Script Context: reads routing
- Script Context → Script Writing: routes task
- Script Writing → Animation Spec: hands off output
- Animation Spec → Animation Build: hands off specification
- Single Agent → Remotion Guidance: loads guidance
- Single Agent → Voice Workflow: reads routing
- Voice Workflow → Research: routes task
- Research → Script: hands off output
- Script → Voice Production: hands off script
- Voice Production → Animation: hands off audio
- Animation → Render: hands off composition
- Narration Tool → Script: reads script
- Narration Tool → ElevenLabs: requests speech
- Whisper Transcription → Voice Production: reads audio
- Whisper Transcription → Beat Timing: writes transcript
- Beat Timing → Animation: emits beat timings
- Single Agent → Builder Context: reads routing
- Builder Context → Workflow Discovery: routes task
- Workflow Discovery → Workflow Mapping: hands off findings
- Workflow Mapping → Workspace Scaffolding: hands off map
- Workspace Scaffolding → Questionnaire Design: hands off workspace
- Questionnaire Design → Workspace Validation: hands off questionnaire