Pipeline Reflection UX

Pipeline Reflection UX

Use this skill to keep pipeline/​reflection output concise, explicit, and low-noise.

Workflow

1. Make Step 0 visible in router narration.
2. Emit Step 0 completion before TaskList().
3. Emit a one-line reflection outcome with report path.
4. Batch late post-pipeline notifications into one summary.
5. Keep guardrail semantics unchanged (block stays block).

Required Checks

• Add/​adjust tests before behavior changes.
• Confirm no regression in routing/​taskupdate/​read-safety tests.
• Verify debug-log counts improve for repeated violations/​noise.

Iron Laws

1. ALWAYS emit Step 0 narration (pending reflections count) before any TaskList() call — omitting the narration makes reflection spawning invisible to the user and breaks the pipeline audit trail.
2. NEVER batch reflection spawns with tool calls that depend on their results — reflection agents must complete before the router proceeds to routing; mixing them creates race conditions.
3. ALWAYS emit a one-line reflection outcome (report path + summary) after reflection-agent completes — without this, the user cannot distinguish a completed reflection from a skipped one.
4. NEVER emit one status message per late-completing background agent — per-agent late notifications create noise storms; batch all late completions into one summary after drain gate passes.
5. ALWAYS preserve existing block semantics when modifying pipeline narration — changing guardrail modes while fixing UX copy conflates two concerns and masks the behavioral impact of either change.

Anti-Patterns

Memory Protocol (MANDATORY)

Before starting: Read .claude/​context/​memory/​learnings.md

After completing:

• New pattern → .claude/​context/​memory/​learnings.md
• Issue found → .claude/​context/​memory/​issues.md
• Decision made → .claude/​context/​memory/​decisions.md

ASSUME INTERRUPTION: If it's not in memory, it didn't happen.

References

• Detailed UX review: references/​ui-reflection-review.md
• Troubleshooting runbook: .claude/​docs/​TROUBLESHOOTING.md
• Task tracking protocol: .claude/​docs/​@TASK_TRACKING_GUIDE.md