metis-reconcile

/metis-reconcile

Read everything under docs/. Produce four reconcile artifacts: .metis/SYNTHESIS.md, .metis/INDEX.md, .metis/CONTRADICTIONS.md, .metis/QUESTIONS.md.

Preflight

Run references/reconcile-preflight.sh before reading. It exits non-zero if docs/ is missing (surface the error and stop). Otherwise it reports STATUS (fresh / rereconcile), SIZE_CLASS (small / medium / large), and counts for the corpus and any prior items.

On SIZE_CLASS=large, apply the slicing guidance in references/reconciling-docs.md.

Load

• The source docs under docs/.
• On rereconcile, the prior .metis/CONTRADICTIONS.md and .metis/QUESTIONS.md. Re-reconcile preserves prior items and re-checks them against the current corpus (per references/reconciling-docs.md) rather than starting over.

Do not load

• .metis/RESOLVED.md.
• .metis/BUILD.md.

Read first

references/reconciling-docs.md — read before drafting any of the output artifacts.

Write scope

Four files in .metis/. The preflight pre-creates stubs if absent, so all four exist before write time and Edit can target them on the first run.

• .metis/SYNTHESIS.md — full Write each run. The synthesis is regenerated from the current corpus, not patched.
• .metis/INDEX.md — Write from scratch on STATUS=fresh. On STATUS=rereconcile, prefer Edit: add, update, or remove individual entries surgically and leave unchanged entries in place.
• .metis/CONTRADICTIONS.md — same Edit-preferred discipline on rereconcile. Preserve items marked stale. Re-emitting unchanged items as Write output is the cost we're avoiding.
• .metis/QUESTIONS.md — same treatment as CONTRADICTIONS.md.

Do not write to .metis/RESOLVED.md, any source doc under docs/, or .metis/BUILD.md.

Invocation prompt

Trailing prompt: see ${CLAUDE_PLUGIN_ROOT}/references/command-prompts.md.

Return

One message to the user:

• Files written — four paths with item counts per CONTRADICTIONS.md / QUESTIONS.md (open / deferred / stale).
• Coverage — which docs were read in full vs. sliced, and any passages deliberately deferred to a later pass. On SIZE_CLASS=large, include the completeness caveat here.
• Next step — /metis-walk-open-items when there are open or stale items; /metis-build-spec when the open set is empty.