/brainstorming-workflows

name: brainstorming-workflows
description: Explores user workflows through targeted questions about pipeline modes, pain points, routine tasks, and human intervention points to inform agent system design. Use when exploring workflows after analysis. Use when user says "explore workflows", "brainstorm workflows", "what should I automate". Use when called by analyzing-agent-systems.

Brainstorming Workflows

Overview

**Brainstorming workflows IS targeted exploration of how users actually work, what frustrates them, and what can be automated.**

The analysis report tells you what the system looks like; brainstorming tells you what the user needs. These are different data sources — never skip one because the other exists.

**Core principle:** Ask about failures before wishes.

Routing

**Pattern:** Chain **Handoff:** user-confirmation **Next:** `planning-agent-systems` **Chain:** main

Task Initialization (MANDATORY)

Follow [task initialization protocol](../../references/task-initialization.md).

**Tasks:** 1. Import analysis findings 2. Pipeline mode exploration 3. Pain point discovery 4. Routine task identification 5. Human intervention point discovery 6. Component type judgment 7. Produce workflow summary

Announce: "Created 7 tasks. Starting execution..."

Task 1: Import Analysis Findings

**Goal:** Load analysis report and let user select which findings to address.

**If analysis report path was provided:** 1. Read the analysis report 2. Present restructuring recommendations grouped by priority 3. Ask: "The analysis report suggests these improvements. Which ones do you want to address this time?" 4. Present as checklist for user to select 5. Selected items become requirements in workflow summary

**If no analysis report:** Note that no analysis was done, proceed to Task 2.

**Skip questions in later tasks that the analysis already answered.**

**Verification:** User has confirmed which findings to address (or no analysis exists).

Task 2: Pipeline Mode Exploration

**Goal:** Determine how workflows connect and what state management they need.

**Important:** Read [references/exploration-questions.md](references/exploration-questions.md) for the question bank (Pipeline section).

**Rules:**

• Ask **ONE question at a time** about workflow entry points, step counts, work scope
• Classify each workflow as **owner-pipe** or **chain-pipe**
• Determine if script-managed state is needed (based on step count + work scope)
• Skip questions answered by the analysis report

**Verification:** Each identified workflow has mode + state management decision.

Task 3: Pain Point Discovery

**Goal:** Find where the current agent system fails or is missing.

**Important:** Read [references/exploration-questions.md](references/exploration-questions.md) for the question bank (Pain Point section).

**Rules:**

• Ask about past failures, missing automation, repeated corrections
• For each pain point, note the likely component type (rule / hook / skill / CLAUDE.md)
• Ask **ONE question at a time**

**Verification:** Pain points documented with root cause and component type.

Task 4: Routine Task Identification

**Goal:** Find repetitive small tasks that could be automated.

**Important:** Read [references/exploration-questions.md](references/exploration-questions.md) for the question bank (Routine Task section).

**Rules:**

• Ask about daily repetitive work, search patterns, format/check tasks
• For each task, note automation approach and component type
• Ask **ONE question at a time**

**Verification:** Routine tasks documented with automation approach.

Task 5: Human Intervention Point Discovery

**Goal:** Find where humans must review, approve, or intervene in the workflows.

**Important:** Read [references/exploration-questions.md](references/exploration-questions.md) for the question bank (Human-in-the-Loop section).

**Rules:**

• Ask about irreversible operations, external visibility, trust boundaries
• For each intervention point, note the type: **review checkpoint** / **confirmation gate** / **guardrail trigger**
• These findings directly affect Task 6 — intervention points determine which components need `user-confirmation` handoff vs auto-invoke
• Ask **ONE question at a time**

**Required question — quality gate loop:**

Ask: "When a reviewer reports issues, do you want fixes applied automatically before re-reviewing (auto loop), or do you want to confirm each fix before continuing (manual loop)?"

Record the answer — this determines whether review skills use `auto-invoke` or `user-confirmation` handoff to the next fixing step.

**Verification:** Intervention points documented with type and affected workflow step. Quality gate loop preference recorded.

Task 6: Component Type Judgment

**Goal:** Map every discovered need to the right component type.

For each pain point, routine task, intervention point, and analysis finding:

• Behavioral constraint → **rule**
• Automated check → **hook** (PostToolUse or PreToolUse)
• Multi-step workflow → **skill**
• Independent execution → **agent** (subagent)
• Simple instruction → **CLAUDE.md** addition

**Present the mapping to user for confirmation.**

Challenge any over-engineering: "Can this be a rule instead of a skill?"

Read [references/anthropic-patterns.md](references/anthropic-patterns.md) for the complexity ladder — prefer lowest level that works.

**Verification:** Every need mapped to component type, user confirmed.

Task 7: Produce Workflow Summary

**Goal:** Write structured summary to `.rcc/{timestamp}-workflows.md`.

**Important:** Read [references/summary-template.md](references/summary-template.md) for the full summary format.

**Include:** pipeline mode mapping, pain points, routine tasks, human intervention points, component recommendations.

**Handoff:** "Workflow summary complete. Continue to plan agent system components?"

• If yes → invoke `planning-agent-systems` skill, pass workflow summary path