kimchi:plan-synthesize

This command should be used to synthesize multiple cross-model plan revisions into a superior hybrid plan. Eighth stage of the Kimchi planning pipeline. Reads PLAN-REVISED-*.md files and outputs PLAN-SYNTHESIZED.md — the TRUE final plan.

7 stars

Best use case

kimchi:plan-synthesize is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

This command should be used to synthesize multiple cross-model plan revisions into a superior hybrid plan. Eighth stage of the Kimchi planning pipeline. Reads PLAN-REVISED-*.md files and outputs PLAN-SYNTHESIZED.md — the TRUE final plan.

Teams using kimchi:plan-synthesize should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/plan-synthesize/SKILL.md --create-dirs "https://raw.githubusercontent.com/Tromml/kimchi/main/plugins/kimchi/skills/plan-synthesize/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/plan-synthesize/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How kimchi:plan-synthesize Compares

Feature / Agentkimchi:plan-synthesizeStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

This command should be used to synthesize multiple cross-model plan revisions into a superior hybrid plan. Eighth stage of the Kimchi planning pipeline. Reads PLAN-REVISED-*.md files and outputs PLAN-SYNTHESIZED.md — the TRUE final plan.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Kimchi Plan Synthesize

<command_purpose>
Analyze all model-specific plan revisions, compare their findings and fixes, and create a superior hybrid plan that artfully blends the best of all worlds. This is the TRUE final plan that feeds into bead conversion.
</command_purpose>

## Input

Glob for `.kimchi/PLAN-REVISED-*.md` files. If none exist, tell the user: "No revised plans found. Run `/kimchi:plan-revise` in at least one model first."

Also read:
- `.kimchi/PLAN-DRAFT.md` — the baseline draft plan
- `.kimchi/REQUIREMENTS.md` — v1 boundary reference

## Process

### 1. Inventory Revisions

List all `.kimchi/PLAN-REVISED-*.md` files found. Extract model names from filenames. Report:
```
Found revisions from: claude, codex, gemini
Baseline: PLAN-DRAFT.md
```

### 2. Cross-Model Comparison

For each revision, extract:
- Issues found (from the Issues Found table)
- Changes made (from Summary of Changes)
- The revised plan itself

Build a comparison matrix:

**Agreement:** Issues found by multiple models (high confidence — fix these)
**Unique finds:** Issues found by only one model (evaluate carefully — could be insight or noise)
**Contradictions:** Where models disagree on approach (resolve with reasoning)

### 3. Synthesize

Apply ACFS-inspired synthesis logic:

> "3 competing LLMs reviewed the same plan. Analyze with an open mind. Be intellectually honest about what each model did better. Create a superior hybrid that artfully blends the best of all worlds."

Rules:
- **Unanimous issues:** Always fix. If all models found it, it's real.
- **Majority issues:** Fix unless there's a strong reason not to.
- **Unique issues:** Evaluate on merit. A single model can be right when others missed something.
- **Contradictions:** Pick the approach with the strongest reasoning. Explain why.
- **If only 1 revision exists:** Blend the draft and the single revision. The revision's fixes are accepted unless they introduce new problems.

### 4. Write Output

Write `.kimchi/PLAN-SYNTHESIZED.md`:

```markdown
# Synthesized Plan: [Feature Name]

**Synthesized:** [today's date]
**Sources:** PLAN-DRAFT.md, [list of PLAN-REVISED-*.md files]
**Models consulted:** [list of models]

## Cross-Model Comparison

| Issue | Claude | Codex | Gemini | Resolution |
|-------|--------|-------|--------|------------|
| [Issue description] | Found & fixed | Found & fixed | Not flagged | **Accepted** — unanimous/majority |
| [Issue description] | Not flagged | Found & fixed | Not flagged | **Accepted** — valid unique find |
| [Issue description] | Fix A | Fix B | Fix A | **Fix A** — [reasoning] |

## Synthesis Rationale

### What each model did well
- **Claude:** [specific strengths]
- **Codex:** [specific strengths]
- **Gemini:** [specific strengths]

### Key decisions
1. [Decision and reasoning]
2. [Decision and reasoning]

## Synthesized Plan

[Complete synthesized plan — full standalone plan ready for bead conversion]
```

Report: "Synthesis complete. Blended [N] model revisions into .kimchi/PLAN-SYNTHESIZED.md"
Suggest: "Run `/kimchi:beads` to convert the synthesized plan into bead specifications."

## Key Principles

- **Intellectual honesty**: Don't favor one model. Judge fixes on merit.
- **Full plan output**: The synthesized plan must be complete and standalone.
- **Reasoning over voting**: A well-reasoned minority position beats a shallow majority.
- **Preserve v1 scope**: Synthesis must not expand scope beyond REQUIREMENTS.md v1 boundary.
- **Works with 1+ revisions**: Even a single revision gets synthesized against the draft baseline.

Related Skills

kimchi:verification-before-completion

7
from Tromml/kimchi

Use when about to claim work is complete, fixed, or passing — before committing or creating PRs. Evidence before assertions, always.

kimchi:validate

7
from Tromml/kimchi

This command should be used to validate bead YAML files for standalone executability. Runs 4 validators (context completeness, deliverables clarity, test specification, isolation) and enriches failing beads. Eighth stage of the Kimchi planning pipeline.

kimchi:tdd

7
from Tromml/kimchi

Use when implementing any feature, bugfix, or behavior change — before writing implementation code. Enforces RED-GREEN-REFACTOR cycle.

kimchi:systematic-debugging

7
from Tromml/kimchi

Use when encountering any bug, test failure, or unexpected behavior — before proposing fixes. Enforces 4-phase root cause analysis.

kimchi:status

7
from Tromml/kimchi

This command should be used to check the current state of the Kimchi planning pipeline, including which stages have completed, what artifacts exist, and bead validation status.

kimchi:simplicity-enforcement

7
from Tromml/kimchi

Use when designing solutions, implementing features, or considering abstractions. Enforces YAGNI, minimal code, and preferring duplication over wrong abstraction.

kimchi:review

7
from Tromml/kimchi

This command should be used to run multi-persona review of the implementation plan. Five specialized personas critique the plan for scope creep, complexity, premature optimization, and test coverage. Fifth stage of the Kimchi planning pipeline. Produces .kimchi/PLAN-REVIEWED.md.

kimchi:reset

7
from Tromml/kimchi

This command should be used to clear the Kimchi working directory (.kimchi/) and start fresh. Preserves .beads/ directory. Use when starting a new planning session or recovering from a bad state.

kimchi:research

7
from Tromml/kimchi

This command should be used to investigate codebase patterns, frameworks, and existing implementations before planning. Third stage of the Kimchi planning pipeline. Produces .kimchi/RESEARCH.md.

kimchi:requirements

7
from Tromml/kimchi

This command should be used to extract and categorize requirements from CONTEXT.md into v1 (must have), v2 (next iteration), and out of scope. Second stage of the Kimchi planning pipeline. Produces .kimchi/REQUIREMENTS.md.

kimchi:refine

7
from Tromml/kimchi

This command should be used to iteratively improve the plan until quality threshold is reached or diminishing returns detected. Sixth stage of the Kimchi planning pipeline. Produces .kimchi/PLAN-DRAFT.md.

kimchi:plan

7
from Tromml/kimchi

This command should be used to run the Kimchi planning pipeline through refinement, transforming a vague idea into a draft plan ready for cross-model analysis. Orchestrates 6 stages: clarify, requirements, research, generate, review, refine. Use --full-auto to also run beads + validate after manual revise/synthesize.