- name
SKILL.md
El archivo de la skill permanece en el repositorio del publicador.
Pega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add ericrisco/rsc-harness --skill analyze -a cursor -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add ericrisco/rsc-harness --skill analyze -a claude-code -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add ericrisco/rsc-harness --skill analyze -a codex -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add ericrisco/rsc-harness --skill analyze -a grok -yEnvía el mensaje copiado en un chat de Grok Bot. El Bot obtiene este SKILL.md de GitHub y lo añade a las skills que comparten todos tus Bots.
Install this skill: https://github.com/ericrisco/rsc-harness/tree/HEAD/skills/analyzeDel publicador
You have a constitution, a spec, a plan and a task list. Four artifacts written at four different moments, by a mind that drifted a little each time. analyze reads all four against each other and surfaces where they disagree. It is the cheapest place in the whole chain to catch a problem — a contradiction found here costs a sentence; the same contradiction found mid-implement costs a rewrite.
Sixth phase of the rsc-sdd chain (constitution → specify → clarify → plan → tasks → analyze → implement); the method itself lives in ../asdd/SKILL.md. It is a gate, not a worker: it produces a report and stops. The user reads the findings and decides what to fix, and which phase to send each fix back to.
Report only. Resolve nothing. Never edit the constitution, spec, plan or tasks; never open a code file to "just fix it"; never silently reconcile a contradiction by picking a side. This one is absolute because a gate that quietly fixes things stops being a gate: the user never learns the spec was wrong, the plan built on the old assumption stays stale, and the "consistency check" has manufactured a new inconsistency. Name the conflict, show both sides with locations, propose where it should be resolved, hand the decision back.
Model tier: heavy (adversarial cross-reading). Resolve and apply it per ../asdd/references/model-routing.md; routing is off unless models.enabled: true in 02-DOCS/wiki/sdd/config.yaml.
Register. Read technical_level in 02-DOCS/wiki/harness/user-profile.md before reporting; with no profile, use analogies and say the harness has not set the register yet. The register changes how the report reads, never what gets checked; the six analyses always run in full.
The report is the same for every reader: a finding table (severity, the two artifacts, the conflict in one line), a one-line why it matters per CRITICAL/HIGH finding, and per finding the recommended resolution phase and the trade-off of leaving it. For a non-technical reader, explain the consequence at implement time with an everyday analogy so they can choose.
Read all four before analyzing. The rsc-sdd artifacts live under 02-DOCS/wiki/sdd/, indexed from 02-DOCS/wiki/index.md (the Knowledge map; root CLAUDE.md keeps only a short pointer to it):
If any artifact is missing, stop and say so — analyze cannot gate what isn't there. Name the missing one and the phase that produces it. If a <slug> is ambiguous (several specs), ask which feature is being gated; do not analyze all of them blindly.
Run every one. Each compares a specific pair (or the whole set against the constitution) and emits findings.
clarify (spec) or tasks (missing done-check).
implement/parallel dispatch tasks to context-isolated developer subagents that see only their own task, also confirm the plan carries a §0 Global Constraints block (verbatim project-wide values) and that every task whose correctness depends on a contract it doesn't own has an Interfaces block (Consumes/Produces, exact signatures). A constraint or neighbor-signature that lives only in prose is invisible to the blind worker — flag a missing carrier as AMBIGUOUS (it will surface as drift or breakage at implement time). See ../plan/references/plan-template.md §0 and ../tasks/SKILL.md (Per-task Interfaces).A copy-able table that makes gaps and drift visible at a glance:
REQ-ID | Spec requirement (short) | Plan section | Task(s) | Status
------ | ------------------------------- | ------------ | ------- | ----------
R1 | Email/password sign-up | §3 Auth | T2,T3 | covered
R2 | Rate-limit login (5/min/IP) | §3 Auth | — | GAP
R3 | — | §5 Webhooks | T9 | DRIFT
R4 | "Fast" search | §4 Search | T6 | AMBIGUOUS (no metric)
GAP — spec requirement with no task → it won't be built.DRIFT — plan/task with no spec requirement → unrequested scope.AMBIGUOUS — covered but not specific enough to verify later.covered — traces cleanly spec → plan → task.Rank every finding so the user triages fast:
implement.Produce a single consistency report:
GATE: PASS (zero CRITICAL/HIGH) or GATE: BLOCKED (one or more CRITICAL/HIGH), with the counts.# | Severity | Type | Artifact A (loc) | Artifact B (loc) | Conflict | Resolve in (phase).clarify for spec ambiguity, plan for missing architecture, tasks for a missing done-check, constitution if a principle itself is wrong). If findings pour in across all six checks, the artifacts diverged badly — recommend re-running clarify/plan before a line-by-line analyze is even useful.Write the report to 02-DOCS/wiki/sdd/analysis/<slug>.md (create the dir if absent) and index it in 02-DOCS/wiki/index.md under the sdd/ topic, so the next phase and the harness can find it. It is an OKF v0.1 wiki article: open it with YAML frontmatter carrying a non-empty type: (use type: analysis), a timestamp in ISO 8601, and standard markdown links — never wikilinks. The report is the artifact analyze owns — it is the only thing analyze writes. Per-run point-in-time; overwrite on re-run, the wiki keeps history.
Render it in the orient voice, in the user's register. Do not log a decision to decisions.md — analyze decides nothing; the phase that resolves the finding logs its own decision.
End with the parseable block every SDD phase shares, so the dispatcher can chain without
interpreting prose (contract: ../asdd/SKILL.md):
{
"status": "complete|blocked|failed",
"executive_summary": "Cross-read of spec/plan/tasks against the constitution; findings ranked.",
"artifact": "02-DOCS/wiki/sdd/analysis/<slug>.md",
"next_recommended": "implement",
"risk": "low|medium|high",
"skill_resolution": {
"used": ["analyze"],
"missing": [],
"fallback": [],
"compact_rules": ["Read adversarially across artifacts, not inside one.", "A finding without a location is an opinion."]
},
"evidence": ["report path exists", "blockers listed with artifact + location", "constitution conflicts named"]
}
On GATE: PASS (or once the user consciously accepts the remaining MEDIUM/LOW findings), proceed to implement — execute the tasks with TDD discipline, delegating concrete test tooling to the relevant stack skill (fastapi, nextjs, go, flutter, postgresdb). On GATE: BLOCKED, route each CRITICAL/HIGH finding to its owning phase (clarify, plan, tasks, or constitution), let the user resolve, then re-run analyze. The gate only opens once.
Use when constitution, spec, plan and tasks all exist and you want them cross-read against each other before any code is written — the rsc-sdd pre-implementation gate. Reports coverage gaps, contradic
---name: analyzedescription: Use when constitution, spec, plan and tasks all exist and you want them cross-read against each other before…---# skills/analyze/SKILL.mdResumen general
Use when constitution, spec, plan and tasks all exist and you want them cross-read against each other before any code is written — the rsc-sdd pre-implementation gate. Reports coverage gaps, contradictions, duplication, ambiguity and scope drift; edits nothing. NOT the task breakdown (that is `tasks`), NOT the coding (that is `implement`), NOT the post-code test gate (that is `verify`), NOT resolving ambiguity (that is `clarify`).
Preguntas frecuentes
Descarga skills/analyze/SKILL.md desde el publicador, o copia la ruta y abre el repositorio. PlugMCP lista la skill y no aloja el archivo.
El publicador lo mantiene en https://github.com/ericrisco/rsc-harness.
Claude, Cursor, Codex y Grok Build pueden leer un SKILL.md que añadas desde el repositorio del publicador. Grok Bot lo instala cuando envías en un chat el enlace a la carpeta de la skill en GitHub.