5.3 KiB

Raw Blame History

Workflow: Synthesize Results

Model tier: Opus (requires intelligent synthesis and quality judgment)

When to use

Final step in any multi-workflow execution plan. Called after all execution subagents have completed and written their outputs.

Purpose

Read all previous step outputs, synthesize into a coherent deliverable, and produce the final user-facing artifact.

Inputs

plan_path: Path to current execution plan (.claude/plugin-data/cc-architect/plans/current-plan.md)
artifact_type: Type of final output (plugin, skill, workflow, command, description, audit)

Output

.claude/plugin-data/cc-architect/output/final.md

Phase 1: Locate Outputs

Read the execution plan to identify all previous step outputs.

Extract from plan:

List of output files from each completed step
Artifact type being produced
Request summary (what user wanted)

Build file manifest:

Step 1: .claude/plugin-data/cc-architect/tasks/{step-1-output}.md
Step 2: .claude/plugin-data/cc-architect/tasks/{step-2-output}.md
...

Phase 2: Read and Analyze

Read each output file in order.

For each file, extract:

Key findings or artifacts created
Decisions made
Warnings or issues flagged
Cross-references to other files

Build synthesis context:

Deduplicate overlapping information
Identify contradictions or conflicts
Note dependencies between outputs

Phase 3: Synthesize

Combine outputs according to artifact type.

Artifact Type: Plugin

# Plugin Created: {plugin-name}

## Summary
{One paragraph describing what was built}

## Files Created
| Path | Purpose |
|------|---------|
| `{path}` | {description} |

## Skill(s) Included
- **{skill-name}**: {brief description}

## Next Steps
1. {Actionable next step}
2. {Actionable next step}

## Configuration (if applicable)
{How to configure the plugin}

Artifact Type: Skill

# Skill Created: {skill-name}

## Summary
{One paragraph describing the skill's purpose and trigger}

## Files Created
| Path | Purpose |
|------|---------|
| `{path}` | {description} |

## Usage
Invoke with: `/{skill-name}` or triggered by: {trigger conditions}

## Workflows Included
- **{workflow-name}**: {when to use}

## Golden Examples Needed
{Suggest 1-2 golden examples user should create based on their domain}

## Next Steps
1. Test with a real use case
2. Create golden examples
3. Add invariants as patterns emerge

Artifact Type: Workflow

# Workflow Created: {workflow-name}

## Summary
{One paragraph describing what this workflow accomplishes}

## File Location
`{path-to-workflow}`

## Integration
{How this workflow is invoked - from which skill, with what triggers}

## Testing
{How to verify the workflow works correctly}

Artifact Type: Audit

# Audit Complete: {target-name}

## Verdict: {Ready / Not Ready}

## Summary
- Significant issues: {N}
- Minor issues: {N}
- Polish items: {N}

## Critical Findings
{List significant issues with severity and remediation}

## Recommendations
{Prioritized list of actions}

## Patterns Discovered
{Novel approaches worth considering for standards}

Artifact Type: Description

# Description Generated

## Result
`{the description string}`

## Escape Hatch Test
{Pass/Fail with reasoning}

## Usage
Add to frontmatter:
```yaml
description: {the description string}


---

## Phase 4: Quality Check

Before writing final output, verify:

**Completeness:**
- [ ] All execution steps represented in synthesis
- [ ] No orphaned outputs (created but not referenced)
- [ ] User's original request fully addressed

**Coherence:**
- [ ] No contradictory information
- [ ] Consistent terminology throughout
- [ ] Logical flow from problem to solution

**Actionability:**
- [ ] Clear next steps provided
- [ ] File paths are accurate and complete
- [ ] User can act on this without additional context

**Quality signals (Opus judgment):**
- Does this feel complete?
- Would a user be satisfied receiving this?
- Is anything important buried or unclear?

---

## Phase 5: Write Final Output

Write to: `.claude/plugin-data/cc-architect/output/final.md`

**Header:**
```markdown
# {Artifact Type}: {Name}

**Generated**: {date}
**Request**: {one-line summary}
**Status**: Complete

---

Body: Use appropriate artifact template from Phase 3.

Footer:

---

## Execution Details

| Step | Model | Output | Status |
|------|-------|--------|--------|
| {step} | {model} | {file} | Complete |

## Cleanup Pending
The following temporary files will be removed:
- {list of task files}

Error Handling

Missing output file:

Note which step failed
Include partial synthesis of completed steps
Flag incomplete sections clearly
Recommend re-running failed step

Conflicting outputs:

Present both versions
Note the conflict
Recommend resolution approach

Quality check failure:

Do not write incomplete synthesis
Return to orchestrator with specific gaps
Recommend additional steps needed

Anti-Patterns

Wrong	Right
Copy-paste raw outputs	Synthesize and deduplicate
Hide warnings from user	Surface all issues clearly
Skip quality check	Always verify before writing
Vague next steps	Specific, actionable guidance
Bury important findings	Lead with critical information

5.3 KiB Raw Blame History