analyze

Audit a jig spec against related artifacts and emit a markdown findings report.

5|Updated May 12, 2026
One-click install
npx skills add https://github.com/ramboz/jig --skill analyze-ramboz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze
Source: https://github.com/ramboz/jig/tree/main/skills/analyze
Command: npx skills add https://github.com/ramboz/jig --skill analyze-ramboz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-artifact consistency reporting for jig specs helps teams detect drift and conflicts between a spec and its related artifacts (ADR decisions, architecture, principles, and terminology) without changing any files.

Core Features & Use Cases

  • Non-destructive, cross-artifact audit across the six-category taxonomy (Duplication, Ambiguity, Underspecification, Principle Violations, Coverage Gaps, Terminology Drift).
  • Reads primary inputs: one spec.md and any sibling slice-NN-.md files, plus read-only references from docs/product-vision.md, docs/decisions/.md, docs/memory/glossary.md, and docs/architecture.md.
  • Produces a markdown findings report to stdout, including a severity-sorted findings list, a per-category coverage summary, and recommended next steps.

Quick Start

Run the skill on a single spec to surface cross-artifact drift without writing any files.

Frequently Asked Questions about analyze

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check for drift between a spec and architecture decisions?

To check for spec drift against architecture decisions, you can audit a spec.md file alongside its sibling slice files and reference docs to detect cross-artifact inconsistencies. The audit compares the spec against ADRs, architecture, principles, and glossary entries.

What is cross-artifact consistency reporting for software specs?

Cross-artifact consistency reporting detects drift and conflicts between a spec and its related artifacts, such as ADR decisions, architecture principles, and terminology, without modifying any files. It surfaces issues across six categories including duplication and ambiguity.

How do I run a non-destructive spec audit without writing files?

You run a non-destructive spec audit by executing the skill on a single spec.md and its slice-NN-*.md files. It reads reference docs like product-vision.md and decisions, then emits a markdown findings report directly to stdout without writing any files.

What does a six-category spec audit report include?

A six-category spec audit report includes a severity-sorted findings list, a per-category coverage summary, and recommended next steps. The six categories are Duplication, Ambiguity, Underspecification, Principle Violations, Coverage Gaps, and Terminology Drift.

Can I audit spec slices against a glossary and product vision docs?

Yes, you can audit spec slices against a glossary and product vision docs. The audit reads read-only reference inputs including docs/memory/glossary.md, docs/product-vision.md, docs/architecture.md, and docs/decisions to evaluate consistency with the target spec.

What are the limitations of auditing spec drift across artifacts?

A key limitation of this cross-artifact audit is that it only evaluates a single jig spec at a time and outputs findings strictly to stdout. It does not write files or automatically resolve the detected drift, coverage gaps, or terminology conflicts.