mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-05 16:13:08 +08:00
- 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.
3.9 KiB
3.9 KiB
prefix, inner_loop, additional_members, message_types
| prefix | inner_loop | additional_members | message_types | ||||
|---|---|---|---|---|---|---|---|
| DISCUSS | false |
|
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 |
- 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 |
- Read all analysis and exploration results
- 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
- 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": "..."
}
- 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