ada-project-audit

Audits whole projects for drift between source code, traceability matrices, and documentation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Traceability matrices, status reports, and READMEs drift out of sync with actual source code over time, so plans built on them waste implementation effort on features that already exist or miss ones that do not. This Skill verifies documentation claims against real code and test evidence before planning, release, or modernization. ## Core Features & Use Cases - Parallel Source Audit: Delegates module-by-module reading of every source file to subagents, capturing implemented behavior, REQ references, TODOs, and test coverage. - Document Cross-Check: Diffs SRS requirement IDs against traceability matrices, validates appendix file lists and line counts, and flags stale status claims. - Legacy Health Mode: Extends the audit to inherited codebases by building and testing owned projects, checking demo surfaces, stub code, and security risks, then ranking findings by severity. - Use Case: Before drafting a multi-phase refactoring plan, run the audit to discover that requirements marked "Not Implemented" are already coded and tested, cutting the planned scope and producing a corrected traceability matrix. ## Quick Start Ask the agent to audit this project's implementation status, tests, documentation, and traceability drift, and to output severity-ranked file:line evidence with a correction order.

Frequently Asked Questions about ada-project-audit

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

FAQPage Schema
How do I audit a project for traceability drift before planning?

Run a source audit that reads every file via parallel subagents, then cross-check each "Not Implemented" requirement against actual code. Diff SRS requirement IDs against the traceability matrix with sort -u and comm to find orphans, and apply corrections before drafting any implementation plan.

How to verify documentation matches actual code implementation?

Treat source and executable evidence as the source of truth for current state, then check each documentation claim against it. Verify README feature claims, appendix file lists with find output, and component line counts with wc -l rather than trusting status documents.

When should I use a whole-project audit versus a pre-implementation check?

Use a whole-project audit for release readiness, post-refactoring verification, or legacy codebase assessment. For narrow validation of a single implementation plan before coding starts, a pre-implementation audit is the appropriate smaller-scope tool.

What does the legacy health audit mode check in old codebases?

Legacy health mode reads docs, manifests, dependencies, and source in dependency order, then builds and tests every owned project. It cross-checks demo surfaces, JS/native call chains, TODO/FIXME markers, and stub code, ranking exploitable or data-loss defects first.

Why do requirement counts differ between SRS and traceability documents?

SRS documents repeat requirement IDs in cross-references, appendices, and deleted lists, so naive grep counts inflate totals. Deduplicate with sort -u and diff the ID sets; new requirements added after the matrix was generated will also be missing from traceability.

When should I skip a full project audit?

Skip it for single-file changes, bug fixes that do not touch traceability, and greenfield projects with no secondary documentation. The audit's value comes from cross-checking existing documents against code, which requires those documents to exist.