ada-doc-comparison-analysis

Compares two technical documents and synthesizes an optimized version respecting phase boundaries.

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/wubing7755/Ada --skill ada-doc-comparison-analysis-wubing7755
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ada-doc-comparison-analysis
Source: https://github.com/wubing7755/Ada/tree/main/skills/software-development/ada-doc-comparison-analysis
Command: npx skills add https://github.com/wubing7755/Ada --skill ada-doc-comparison-analysis-wubing7755

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When you have two versions of a technical document (such as two SRS drafts) and need to know what each does well, manually identifying complementary strengths and merging them without breaking the document's scope is slow and error-prone. This Skill provides a structured methodology to compare both documents, map their complementary strengths, and produce an optimized version that respects requirements-phase boundaries. ## Core Features & Use Cases - Dimensioned Strengths Analysis: Produces strengths tables for each document across six dimensions: structural, navigational, format, completeness, readability, and maintainability. - Complementarity Mapping: Explicitly maps each document's strengths to the other's gaps, then proposes an optimized table of contents with move/add annotations. - Phase-Boundary Discipline: Prevents injecting implementation details (API signatures, algorithms, class diagrams) into requirements-phase artifacts like an SRS. - Use Case: You have an SRS draft and a well-structured reference SRS. Ask to analyze both, extract the reference's navigation aids (quick-finders, per-section indexes, traceability matrices), and apply them to your draft while keeping your existing AC numbering and bilingual conventions. ## Quick Start Ask the agent to read document A and document B, analyze each one's strengths, and produce an optimized version of B with a before/after comparison.

Frequently Asked Questions about ada-doc-comparison-analysis

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

FAQPage Schema
How do I compare two SRS documents and merge their best parts?

Read both documents completely, build a strengths table for each across six dimensions (structural, navigational, format, completeness, readability, maintainability), then map each document's strengths to the other's gaps. Propose an optimized table of contents with concrete before/after comparisons before editing.

What content is appropriate to add to a requirements-phase SRS?

Phase-appropriate additions include architecture diagrams, ER diagrams, lifecycle state diagrams, terminology tables, explicit AC numbering, requirement quick-finders, traceability matrices, and deferred-requirements appendices. Never inject implementation details like API signatures, algorithms, or class diagrams into a requirements document.

Can this comparison method be used for design docs or API specs?

Yes, the methodology applies to design docs, API specs, and other structured technical references, though SRS documents are the primary use case. The phase-boundary rules adjust to whatever artifact type you are optimizing.

When should I not use document comparison analysis?

Do not use it for comparing a document against a live product, for simple git diff/merge of two versions of the same file, or for single-document quality audits. Those scenarios need coverage analysis, version control tooling, or document review methods respectively.

Why do patch edits fail on large documents after multiple changes?

File content shifts after each edit, so previously unique match strings may no longer match. Always re-read the target area immediately before patching, anchor on section header text rather than line numbers, and make one logical change per patch call.