Kaizen Guided Execution Pipeline
Normalize, contextualize, and validate todos through the guided execution block chain
The Guided Execution pipeline is a sequence of Kaizen blocks that turn raw todos into normalized, contextualized, time-bounded tasks with prompts, monitoring, and validation. Use it when you want structured task execution with intent inference, time windows, and completion validation.
Pipeline Order
Run blocks in this order. Each block consumes output from the previous step:
- Kaizen Todos – Fetch todos (or use another source).
- Todo Normalizer (
kaizen_todo_normalizer) – Normalize text, tags, intent, effort, urgency. - Context Extractor (
kaizen_context_extractor) – Add prerequisites, dependencies, blockers. - Intent Derivation (
kaizen_intent_derivation) – Define outcomes and success criteria. - Time Window (
kaizen_time_window) – Create execution windows and check-ins. - Prompt Generator (
kaizen_prompt_generator) – Generate start, nudge, and completion prompts. - Execution Monitor (
kaizen_execution_monitor) – Track progress and detect anomalies. - Completion Validator (
kaizen_completion_validator) – Validate against success criteria. - Reflection (
kaizen_reflection) – Adapt effort and prompts from execution data. - Streak Validator (
kaizen_streak_validator) – Optional; validate completions against streak rules (e.g. after activity trigger).
Block Types
| Step | Block Type | Purpose |
|---|---|---|
| 1 | kaizen_todos | Fetch todos to process |
| 2 | kaizen_todo_normalizer | Normalize into predictable structure |
| 3 | kaizen_context_extractor | Extract context and dependencies |
| 4 | kaizen_intent_derivation | Derive intents and success criteria |
| 5 | kaizen_time_window | Create execution windows |
| 6 | kaizen_prompt_generator | Generate prompts for start/nudge/completion |
| 7 | kaizen_execution_monitor | Monitor execution and trigger prompts |
| 8 | kaizen_completion_validator | Validate completion |
| 9 | kaizen_reflection | Reflect and adapt |
| 10 | kaizen_streak_validator | Optional; validate streak rules |
Referencing Outputs
Use block output references to connect the pipeline. Standard syntax is <block_id.outputName>.
Example:
- Normalizer output:
<kaizen_todo_normalizer_1.normalizedTodos>or<kaizen_todo_normalizer_1.normalizedTodoIds> - Context Extractor input: reference normalizer output
- Intent Derivation input: reference context extractor output
- Time Window input: reference intent derivation output
- Prompt Generator input: reference time window and intent outputs
- Execution Monitor input: reference prompt generator and time window outputs
- Completion Validator input: reference execution monitor and intent outputs
- Reflection input: reference completion validator and execution monitor outputs
See Reference syntax for trigger vs block output syntax.
Common Use Cases
- Structured task execution: Normalize todos → set time windows → generate prompts → monitor → validate.
- Habit/streak workflows: After todo completion (activity trigger), run Streak Validator to check streak rules, then conditionally unlock badge or notify.
- Learning loop: Use Reflection to adapt effort estimates and prompt style for future runs.
Optional Steps
You can shorten the pipeline depending on needs:
- Minimal: Todos → Normalizer → Context Extractor → Intent Derivation (no time window or prompts).
- With validation: Add Completion Validator after Execution Monitor; optionally add Reflection.
- With streaks: Add Streak Validator after an activity trigger (todo completed) or after Completion Validator.
Guided execution blocks use deterministic rules for most processing. Some blocks support optional AI for ambiguous cases; check each block's documentation for AI-related options.