Read the docs corpus and produce SYNTHESIS.md, INDEX.md, CONTRADICTIONS.md, and QUESTIONS.md in .metis/.
Install via CLI
openskills install gsaranti/pantheon---
name: metis-reconcile
description: Read the docs corpus and produce SYNTHESIS.md, INDEX.md, CONTRADICTIONS.md, and QUESTIONS.md in .metis/.
disable-model-invocation: true
---
# /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.
No comments yet. Be the first to comment!