claude-code-workflow 7.2.15 → 7.2.16

package/.codex/skills/team-brainstorm/roles/ideator/role.md

@@ -0,0 +1,69 @@
+---
+role: ideator
+prefix: IDEA
+inner_loop: false
+message_types: [state_update]
+---
+
+# Ideator
+
+Multi-angle idea generator. Divergent thinking, concept exploration, and idea revision as the Generator in the Generator-Critic loop.
+
+## Phase 2: Context Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Session folder | Task description (Session: line) | Yes |
+| Topic | <session>/.msg/meta.json | Yes |
+| Angles | <session>/.msg/meta.json | Yes |
+| GC Round | <session>/.msg/meta.json | Yes |
+| Previous critique | <session>/critiques/*.md | For revision tasks only |
+| Previous ideas | <session>/.msg/meta.json generated_ideas | No |
+
+1. Extract session path from task description (match "Session: <path>")
+2. Read .msg/meta.json for topic, angles, gc_round
+3. Detect task mode:
+
+| Condition | Mode |
+|-----------|------|
+| Task subject contains "revision" or "fix" | GC Revision |
+| Otherwise | Initial Generation |
+
+4. If GC Revision mode:
+   - Glob critique files from <session>/critiques/
+   - Read latest critique for revision context
+5. Read previous ideas from .msg/meta.json generated_ideas state
+
+## Phase 3: Idea Generation
+
+### Mode Router
+
+| Mode | Focus |
+|------|-------|
+| Initial Generation | Multi-angle divergent thinking, no prior critique |
+| GC Revision | Address HIGH/CRITICAL challenges from critique |
+
+**Initial Generation**:
+- For each angle, generate 3+ ideas
+- Each idea: title, description (2-3 sentences), key assumption, potential impact, implementation hint
+
+**GC Revision**:
+- Focus on HIGH/CRITICAL severity challenges from critique
+- Retain unchallenged ideas intact
+- Revise ideas with revision rationale
+- Replace unsalvageable ideas with new alternatives
+
+**Output**: Write to `<session>/ideas/idea-<num>.md`
+- Sections: Topic, Angles, Mode, [Revision Context if applicable], Ideas list, Summary
+
+## Phase 4: Self-Review
+
+| Check | Pass Criteria | Action on Failure |
+|-------|---------------|-------------------|
+| Minimum count | >= 6 (initial) or >= 3 (revision) | Generate additional ideas |
+| No duplicates | All titles unique | Replace duplicates |
+| Angle coverage | At least 1 idea per angle | Generate missing angle ideas |
+
+After passing checks, update shared state:
+- Append new ideas to .msg/meta.json generated_ideas
+- Each entry: id, title, round, revised flag

package/.codex/skills/team-brainstorm/roles/synthesizer/role.md

@@ -0,0 +1,57 @@
+---
+role: synthesizer
+prefix: SYNTH
+inner_loop: false
+message_types: [state_update]
+---
+
+# Synthesizer
+
+Cross-idea integrator. Extracts themes from multiple ideas and challenge feedback, resolves conflicts, generates consolidated proposals.
+
+## Phase 2: Context Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Session folder | Task description (Session: line) | Yes |
+| All ideas | <session>/ideas/*.md files | Yes |
+| All critiques | <session>/critiques/*.md files | Yes |
+| GC rounds completed | <session>/.msg/meta.json gc_round | Yes |
+
+1. Extract session path from task description (match "Session: <path>")
+2. Glob all idea files from <session>/ideas/
+3. Glob all critique files from <session>/critiques/
+4. Read all idea and critique files for synthesis
+5. Read .msg/meta.json for context (topic, gc_round, generated_ideas, critique_insights)
+
+## Phase 3: Synthesis Execution
+
+| Step | Action |
+|------|--------|
+| 1. Theme Extraction | Identify common themes across ideas, rate strength (1-10), list supporting ideas |
+| 2. Conflict Resolution | Identify contradictory ideas, determine resolution approach, document rationale |
+| 3. Complementary Grouping | Group complementary ideas together |
+| 4. Gap Identification | Discover uncovered perspectives |
+| 5. Integrated Proposal | Generate 1-3 consolidated proposals |
+
+**Integrated Proposal Structure**:
+- Core concept description
+- Source ideas combined
+- Addressed challenges from critiques
+- Feasibility score (1-10), Innovation score (1-10)
+- Key benefits list, Remaining risks list
+
+**Output**: Write to `<session>/synthesis/synthesis-<num>.md`
+- Sections: Input summary, Extracted Themes, Conflict Resolution, Integrated Proposals, Coverage Analysis
+
+## Phase 4: Quality Check
+
+| Check | Pass Criteria | Action on Failure |
+|-------|---------------|-------------------|
+| Proposal count | >= 1 proposal | Generate at least one proposal |
+| Theme count | >= 2 themes | Look for more patterns |
+| Conflict resolution | All conflicts documented | Address unresolved conflicts |
+
+After passing checks, update shared state:
+- Set .msg/meta.json synthesis_themes
+- Each entry: name, strength, supporting_ideas

package/.codex/skills/team-brainstorm/specs/pipelines.md

@@ -0,0 +1,72 @@
+# Pipeline Definitions — team-brainstorm
+
+## Available Pipelines
+
+### Quick Pipeline (3 beats, strictly serial)
+
+```
+IDEA-001 → CHALLENGE-001 → SYNTH-001
+[ideator]   [challenger]   [synthesizer]
+```
+
+### Deep Pipeline (6 beats, Generator-Critic loop)
+
+```
+IDEA-001 → CHALLENGE-001 → IDEA-002(fix) → CHALLENGE-002 → SYNTH-001 → EVAL-001
+```
+
+GC loop check: if critique.severity >= HIGH → create IDEA-fix → CHALLENGE-2 → SYNTH; else skip to SYNTH
+
+### Full Pipeline (7 tasks, fan-out parallel ideation + GC)
+
+```
+[IDEA-001 + IDEA-002 + IDEA-003](parallel) → CHALLENGE-001(batch) → IDEA-004(fix) → SYNTH-001 → EVAL-001
+```
+
+## Task Metadata Registry
+
+| Task ID | Role | Phase | Dependencies | Description |
+|---------|------|-------|-------------|-------------|
+| IDEA-001 | ideator | generate | (none) | Multi-angle idea generation |
+| IDEA-002 | ideator | generate | (none) | Parallel angle (Full pipeline only) |
+| IDEA-003 | ideator | generate | (none) | Parallel angle (Full pipeline only) |
+| CHALLENGE-001 | challenger | challenge | IDEA-001 (or all IDEA-*) | Devil's advocate critique and feasibility challenge |
+| IDEA-004 | ideator | gc-fix | CHALLENGE-001 | Revision based on critique (GC loop, if triggered) |
+| CHALLENGE-002 | challenger | gc-fix | IDEA-004 | Re-critique of revised ideas (GC loop round 2) |
+| SYNTH-001 | synthesizer | synthesize | last CHALLENGE-* | Cross-idea integration, theme extraction, conflict resolution |
+| EVAL-001 | evaluator | evaluate | SYNTH-001 | Scoring, ranking, priority recommendation, final selection |
+
+## Checkpoints
+
+| Trigger | Location | Behavior |
+|---------|----------|----------|
+| Generator-Critic loop | After CHALLENGE-* | If severity >= HIGH → create IDEA-fix task; else proceed to SYNTH |
+| GC loop limit | Max 2 rounds | Exceeds limit → force convergence to SYNTH |
+| Pipeline stall | No ready + no running | Check missing tasks, report to user |
+
+## Completion Conditions
+
+| Mode | Completion Condition |
+|------|---------------------|
+| quick | All 3 tasks completed |
+| deep | All 6 tasks (+ any skipped GC tasks) completed |
+| full | All 7 tasks (+ any skipped GC tasks) completed |
+
+## Shared State (meta.json)
+
+| Role | State Key |
+|------|-----------|
+| ideator | `generated_ideas` |
+| challenger | `critique_insights` |
+| synthesizer | `synthesis_themes` |
+| evaluator | `evaluation_scores` |
+
+## Message Types
+
+| Role | Types |
+|------|-------|
+| coordinator | `pipeline_selected`, `gc_loop_trigger`, `task_unblocked`, `error`, `shutdown` |
+| ideator | `ideas_ready`, `ideas_revised`, `error` |
+| challenger | `critique_ready`, `error` |
+| synthesizer | `synthesis_ready`, `error` |
+| evaluator | `evaluation_ready`, `error` |

package/.codex/skills/team-brainstorm/specs/team-config.json

@@ -0,0 +1,86 @@
+{
+  "team_name": "team-brainstorm",
+  "team_display_name": "Team Brainstorm",
+  "description": "Head brainstorming team with Generator-Critic loop, shared memory, and dynamic pipeline selection",
+  "version": "1.0.0",
+
+  "roles": {
+    "coordinator": {
+      "task_prefix": null,
+      "responsibility": "Topic clarification, complexity assessment, pipeline selection, convergence monitoring",
+      "message_types": ["pipeline_selected", "gc_loop_trigger", "task_unblocked", "error", "shutdown"]
+    },
+    "ideator": {
+      "task_prefix": "IDEA",
+      "responsibility": "Multi-angle idea generation, concept exploration, divergent thinking",
+      "message_types": ["ideas_ready", "ideas_revised", "error"]
+    },
+    "challenger": {
+      "task_prefix": "CHALLENGE",
+      "responsibility": "Devil's advocate, assumption challenging, feasibility questioning",
+      "message_types": ["critique_ready", "error"]
+    },
+    "synthesizer": {
+      "task_prefix": "SYNTH",
+      "responsibility": "Cross-idea integration, theme extraction, conflict resolution",
+      "message_types": ["synthesis_ready", "error"]
+    },
+    "evaluator": {
+      "task_prefix": "EVAL",
+      "responsibility": "Scoring and ranking, priority recommendation, final selection",
+      "message_types": ["evaluation_ready", "error"]
+    }
+  },
+
+  "pipelines": {
+    "quick": {
+      "description": "Simple topic: generate → challenge → synthesize",
+      "task_chain": ["IDEA-001", "CHALLENGE-001", "SYNTH-001"],
+      "gc_loops": 0
+    },
+    "deep": {
+      "description": "Complex topic with Generator-Critic loop (max 2 rounds)",
+      "task_chain": ["IDEA-001", "CHALLENGE-001", "IDEA-002", "CHALLENGE-002", "SYNTH-001", "EVAL-001"],
+      "gc_loops": 2
+    },
+    "full": {
+      "description": "Parallel fan-out ideation + Generator-Critic + evaluation",
+      "task_chain": ["IDEA-001", "IDEA-002", "IDEA-003", "CHALLENGE-001", "IDEA-004", "SYNTH-001", "EVAL-001"],
+      "gc_loops": 1,
+      "parallel_groups": [["IDEA-001", "IDEA-002", "IDEA-003"]]
+    }
+  },
+
+  "innovation_patterns": {
+    "generator_critic": {
+      "generator": "ideator",
+      "critic": "challenger",
+      "max_rounds": 2,
+      "convergence_trigger": "critique.severity < HIGH"
+    },
+    "shared_memory": {
+      "file": "shared-memory.json",
+      "fields": {
+        "ideator": "generated_ideas",
+        "challenger": "critique_insights",
+        "synthesizer": "synthesis_themes",
+        "evaluator": "evaluation_scores"
+      }
+    },
+    "dynamic_pipeline": {
+      "selector": "coordinator",
+      "criteria": "topic_complexity + scope + time_constraint"
+    }
+  },
+
+  "collaboration_patterns": ["CP-1", "CP-3", "CP-7"],
+
+  "session_dirs": {
+    "base": ".workflow/.team/BRS-{slug}-{YYYY-MM-DD}/",
+    "ideas": "ideas/",
+    "critiques": "critiques/",
+    "synthesis": "synthesis/",
+    "evaluation": "evaluation/",
+    "messages": ".workflow/.team-msg/{team-name}/"
+  }
+}