Synthesis

/synthesis - Traceability and Quality Validation

Version: 4.1.0 | EFL Pattern: P1 + P3 + P5 + P6 Role: Sub-Orchestrator for semantic traceability and completion decision Pipeline: After /collect, before /commit-push-pr or /rsil-plan

1. Purpose

Synthesis Sub-Orchestrator that:

1. Delegates analysis to specialized agents (P1)
2. Performs semantic requirement-deliverable matching (P3)
3. Validates quality (consistency, completeness, coherence)
4. Executes Phase 3.5 Review Gate (P5)
5. Tracks convergence across iterations (P6)
6. Makes COMPLETE or ITERATE decision

2. Invocation

/synthesis                    # Standard (80% threshold)
/synthesis --strict           # Strict mode (95% threshold)
/synthesis --lenient          # Lenient mode (60% threshold)
/synthesis --dry-run          # Analysis only, no decision
/synthesis --workload <slug>  # Explicit workload

3. Execution Flow

/synthesis (Sub-Orchestrator)
    |
    +-- Phase 0: Context Loading
    |   +-- Read requirements from /clarify
    |   +-- Read collection report from /collect
    |   +-- Load iteration history
    |
    +-- Phase 1: Agent Delegation (P1)
    |   +-- Agent 1: Phase 3-A Semantic Matching
    |   +-- Agent 2: Phase 3-B Quality Validation
    |
    +-- Phase 2: Convergence Detection (P6)
    |   +-- Compare with previous iteration
    |   +-- Detect improvement stall
    |
    +-- Phase 3.5: Review Gate (P5)
    |   +-- Holistic verification
    |
    +-- Phase 4: Decision
        +-- COMPLETE -> /commit-push-pr
        +-- ITERATE -> /rsil-plan

4. L1/L2/L3 Output Format

L1 Summary (returned to main context)

taskId: synthesis-{timestamp}
agentType: synthesis
status: success
summary: "Coverage 85%, Decision: COMPLETE"

decision: "COMPLETE"
coverage: 85.0
threshold: 80
criticalIssues: 0

l2Path: .agent/prompts/{slug}/synthesis/synthesis_report.md
requiresL2Read: false
nextActionHint: "/commit-push-pr"

eflMetrics:
  agentDelegation: true
  internalIterations: 2
  reviewGatePassed: true
  converged: false

L2 Report Structure

# Synthesis Report

## Summary
| Metric | Value |
|--------|-------|
| Coverage | 85.0% |
| Threshold | 80% |
| Decision | COMPLETE |

## Traceability Matrix
| Requirement | Status | Deliverables |
|-------------|--------|--------------|
| REQ-001 | covered | file1.py |

## Quality Validation
- Consistency: PASSED
- Completeness: PASSED
- Coherence: PASSED

## Decision
**COMPLETE** - Proceed to /commit-push-pr

5. Semantic Matching (Phase 3-A)

Unlike keyword matching, semantic analysis:

• Understands requirement intent
• Matches conceptual relationships
• Assigns confidence scores (0.0-1.0)
• Considers architectural patterns

Coverage Classification:

• Covered (100%): confidence >= 0.7
• Partial (50%): 0.4 <= confidence < 0.7
• Missing (0%): confidence < 0.4

6. Quality Validation (Phase 3-B)

3C Checks:

1. Consistency: No duplicate/conflicting implementations
2. Completeness: All P0 requirements covered, tests exist
3. Coherence: Components integrate properly

7. Convergence Detection (P6)

Tracks iteration progress:

• Improvement rate < 5% -> converged
• Critical issues not reducing -> escalate
• Coverage plateau (3 iterations < 2%) -> manual review
• Max iterations (5) -> force escalate

8. Decision Logic

9. Integration Points

Input Dependencies

Output Destinations

10. Handoff Contract

handoff:
  skill: "synthesis"
  workload_slug: "{slug}"
  status: "completed"
  next_action:
    skill: "/commit-push-pr"  # or "/rsil-plan"
    arguments: "--workload {slug}"
    reason: "Coverage {X}% - {COMPLETE|ITERATE}"

Version History