analysis-mode

When to Use

Trigger: !analisis, !analysis, multi-agent analysis. Read-only 4-phase pipeline. !analisis/!analysis as first token. Loading + P1/P4 detail -> reference. SCOPE GUARD: git diff --name-only HEAD~1|Measure-Object -Line. <10 files->HALT->load code-review-agent.

• EXCEPTION: --meta flag (!analisis --meta) bypasses scope guard — analysis is about WORK PROCESS, not code. Skip file-count; focus on workflow, communication, tooling, protocol. GATE: Forbidden: ctx_execute/Write/Edit/Bash(except git status/diff/log)/skill(except project-mapper). Allowed: Read/Grep/Glob/webfetch/websearch/project-mapper. Output->docs/mejoras/**. Forbidden->log BLOCKED:[tool][reason], continue. CONCISO: Concise output — no intros, straight to point.

P3: SYNTHESIZE

|Finding|Consensus|Risk|Files|Recommendation| UNANIMOUS(all)|MAJORITY(>=50%)|SPLIT(<50%)|OUTLIER(single). >30 findings->top-15, rest appendix.

Phase 4: CROSS-REFERENCE (evidence gate)

MANDATORY before any "whats missing"/"que falta"/"gaps" finding. Steps:

1. glob docs/mejoras/*.md
2. ctx_search(queries: ["analysis:<project>", "<topic> gaps"])
3. mem_search(query: "analysis:<project>")
4. Cross-ref: IF exists -> cite file:line. IF novel -> flag confidence: unvalidated.
5. NEVER speculation as fact — every claim MUST carry confidence: high|medium|low|unvalidated. Append cross-ref as ## Evidence Check to P3 synthesis in docs/mejoras/**.

OUTPUT

docs/mejoras/YYYY-MM-DD-<project>-analisis.md — Summary,Findings(8dims),Synthesis,RiskMatrix,Recs,Engram,Trend. Gate: Plan only — NO code/commit.

Reference

P1 ANALYZE + P4 PERSIST detail + loading -> docs/skills/analysis-mode/reference.md

Anti-Rationalization

Rationalization	Red Flag	Verification
"analisis directo sin pipeline 4-fases es mas rapido"	Bypasses evidence gate + 8-dim coverage	Must run P1->P4 pipeline; direct answer is AMARILLA pattern, not analysis-mode
"--meta no aplica aqui"	Scope guard misapplied to process analysis	--meta explicitly bypasses <10-file HALT; verify flag parsing before HALT
"4 fases es overkill para diff pequeno"	Phase skipping degrades trend + engram	Gate forbids Write but requires P3/P4; small diff -> code-review-agent, not partial analysis

Red Flags

• Doing work without checking output format -> STOP, re-read skill
• Second occurrence same rationalization -> force RED zone

Verification

• Output matches skill ## Output contract + file:line citaton
• cross-ref-check.ps1 -> SKILL.md OK

Refs

Cross-Refs: gap-analysis | project-mapper