Files
Claude-Code-Workflow/.claude/skills/team-ultra-analyze/role-specs/discussant.md
catlog22 bbdd1840de Add document standards, quality gates, and templates for team lifecycle phases
- Introduced `document-standards.md` to define YAML frontmatter schema, naming conventions, and content structure for spec-generator outputs.
- Created `quality-gates.md` outlining per-phase quality gate criteria and scoring dimensions for spec-generator outputs.
- Added templates for architecture documents, epics and stories, product briefs, and requirements PRD to streamline documentation in respective phases.
2026-03-04 23:54:20 +08:00

3.9 KiB

prefix, inner_loop, additional_members, message_types
prefix inner_loop additional_members message_types
DISCUSS false
success error
discussion_processed error

Discussant

Process analysis results and user feedback. Execute direction adjustments, deep-dive explorations, or targeted Q&A based on discussion type. Update discussion timeline.

Phase 2: Context Loading

Input Source Required
Task description From task subject/description Yes
Session path Extracted from task description Yes
Analysis results <session>/analyses/*.json Yes
Exploration results <session>/explorations/*.json No
  1. Extract session path, topic, round, discussion type, user feedback:
Field Pattern Default
sessionFolder session:\s*(.+) required
topic topic:\s*(.+) required
round round:\s*(\d+) 1
discussType type:\s*(.+) "initial"
userFeedback user_feedback:\s*(.+) empty
  1. Read all analysis and exploration results
  2. Aggregate current findings, insights, open questions

Phase 3: Discussion Processing

Select strategy by discussion type:

Type Mode Description
initial inline Aggregate all analyses: convergent themes, conflicts, top discussion points
deepen cli Use CLI tool to investigate open questions deeper
direction-adjusted cli Re-analyze via ccw cli from adjusted perspective
specific-questions cli Targeted exploration answering user questions

initial: Cross-perspective summary -- identify convergent themes, conflicting views, top 5 discussion points and open questions from all analyses.

deepen: Use CLI tool for deep investigation:

Bash({
  command: `ccw cli -p "PURPOSE: Investigate open questions and uncertain insights; success = evidence-based findings
TASK: • Focus on open questions: <questions> • Find supporting evidence • Validate uncertain insights • Document findings
MODE: analysis
CONTEXT: @**/* | Memory: Session <session-folder>, previous analyses
EXPECTED: JSON output with investigation results | Write to <session>/discussions/deepen-<num>.json
CONSTRAINTS: Evidence-based analysis only
" --tool gemini --mode analysis --rule analysis-trace-code-execution`,
  run_in_background: false
})

direction-adjusted: CLI re-analysis from adjusted focus:

Bash({
  command: `ccw cli -p "Re-analyze '<topic>' with adjusted focus on '<userFeedback>'" --tool gemini --mode analysis`,
  run_in_background: false
})

specific-questions: Use CLI tool for targeted Q&A:

Bash({
  command: `ccw cli -p "PURPOSE: Answer specific user questions about <topic>; success = clear, evidence-based answers
TASK: • Answer: <userFeedback> • Provide code references • Explain context
MODE: analysis
CONTEXT: @**/* | Memory: Session <session-folder>
EXPECTED: JSON output with answers and evidence | Write to <session>/discussions/questions-<num>.json
CONSTRAINTS: Direct answers with code references
" --tool gemini --mode analysis`,
  run_in_background: false
})

Phase 4: Update Discussion Timeline

  1. Write round content to <session>/discussions/discussion-round-<num>.json:
{
  "round": 1, "type": "initial", "user_feedback": "...",
  "updated_understanding": { "confirmed": [], "corrected": [], "new_insights": [] },
  "new_findings": [], "new_questions": [], "timestamp": "..."
}
  1. Append round section to <session>/discussion.md:
### Round <N> - Discussion (<timestamp>)
#### Type: <discussType>
#### User Input: <userFeedback or "(Initial discussion round)">
#### Updated Understanding
**Confirmed**: <list> | **Corrected**: <list> | **New Insights**: <list>
#### New Findings / Open Questions

Update <session>/wisdom/.msg/meta.json under discussant namespace:

  • Read existing -> merge { "discussant": { round, type, new_insight_count, corrected_count } } -> write back