claude

solution-audit

Continuous meta-quality audit system for solutions under development — evaluates coherence, architecture, documentation, onboarding, and UX across 7 dimensions with prioritized, actionable findings.

0 on GitHubby Nuno Salvacaov0.1.0MITupdated 1 month agodevelopment
/

Plugin solution-audit from marketplace nsalvacao-claude-code-plugins in nsalvacao/nsalvacao-claude-code-plugins. Commands read from the repo's manifest — 1 month ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (8)

  • Architecture Coherence

    This skill should be used when the user asks to "audit architecture", "check architecture drift", "find module coupling", "detect boundary violations", "review code structure", "check dependency direction", or needs to verify that declared architecture matches actual code organization and dependenci

  • CLI UX

    This skill should be used when the user asks to "audit CLI UX", "check command ergonomics", "review CLI help output", "evaluate command-line interface", "check flag consistency", "audit CLI discoverability", or needs to assess the usability, ergonomics, and consistency of a command-line interface.

  • Documentation Quality

    This skill should be used when the user asks to "audit documentation", "check doc quality", "find broken links", "review README", "check if docs are up to date", "assess documentation structure", or needs to evaluate whether documentation is accurate, useful, and well-organized beyond mere existence

  • Learnability and Workflow

    This skill should be used when the user asks to "audit learnability", "check workflow friction", "assess learning curve", "review user workflow", "find friction points", "evaluate cognitive load", "check progressive complexity", or needs to evaluate how learnable a solution is and whether its workfl

  • Onboarding Quality

    This skill should be used when the user asks to "audit onboarding", "check setup experience", "test quickstart", "evaluate time-to-first-success", "review installation steps", "assess new user experience", or needs to evaluate how easy it is for a new user to go from zero to first meaningful result.

  • Product Coherence

    This skill should be used when the user asks to "check if docs match code", "find ghost features", "audit product coherence", "detect naming drift", "find undocumented features", "check README accuracy", or needs to verify alignment between what a product promises and what it actually implements.

  • Spec Gap Analysis

    Use when comparing spec, blueprint, or requirements documents against actual implementation. Detects MISSING features (documented but not implemented), PARTIAL features (incomplete vs spec), EXTRA features (implemented but undocumented), and IMPLEMENTED features. Scores 0-100. Invoke when the user a

  • Textual UX

    This skill should be used when the user asks to "audit text UX", "check error messages", "review microcopy", "assess user-facing text", "check tone consistency", "find jargon leakage", "audit messaging quality", or needs to evaluate the quality and consistency of all user-facing text in a solution.

Slash commands (7)

  • /solution-audit:audit-coherence

    Audit product-to-implementation and architecture-to-code coherence

  • /solution-audit:audit-docs

    Audit documentation quality — accuracy, structure, and usefulness

  • /solution-audit:audit-onboarding

    Audit onboarding experience — setup clarity, prerequisites, time-to-first-success

  • /solution-audit:audit-report

    View, compare, and analyze previous audit reports

  • /solution-audit:audit-ux

    Comprehensive UX audit — CLI ergonomics, textual quality, learnability, and workflow friction

  • /solution-audit:audit

    Run comprehensive solution audit across all quality dimensions

  • /solution-audit:blueprint-review

    Parallel multi-agent review of a blueprint or spec document — spawns spec-reviewer, coherence-analyzer, and ux-reviewer in parallel with explicit output contracts and rate-limit resilience

Subagents (4)

  • coherence-analyzer

    Deep analysis agent for product-to-implementation and architecture-to-code coherence. Use this agent when thorough cross-referencing between documentation, architecture decisions, and actual code is needed to detect drift, ghost features, boundary violations, and structural misalignment. <example> C

  • solution-auditor

    Orchestrates comprehensive solution audits across all quality dimensions. Use this agent when a full, multi-dimensional quality assessment is needed, combining coherence analysis, documentation review, onboarding evaluation, and UX inspection into a unified report with prioritized findings. <example

  • spec-reviewer

    Specialized agent for comparing spec/blueprint documents against actual implementation. Detects implementation drift, ghost features, and undocumented capabilities. Use this agent when comparing a spec to code, reviewing a blueprint for implementation gaps, running /blueprint-review, or asked to "ch

  • ux-reviewer

    Deep UX analysis agent covering CLI ergonomics, textual communication quality, and learnability. Use this agent when a thorough user experience review is needed, examining command-line interfaces, user-facing text, error messages, workflow friction, and overall learnability from multiple angles. <ex

Hooks (3)

  • SessionStart
  • PostToolUse

    bash ${CLAUDE_PLUGIN_ROOT}/scripts/mark-stale.sh

  • Stop

    bash ${CLAUDE_PLUGIN_ROOT}/scripts/save-progress.sh

View source on GitHub

More from nsalvacao/nsalvacao-claude-code-plugins

All 14 plugins →

Hybrid gated-iterative lifecycle framework for AI/ML products — 7 phases, 6 formal gates (A–F), 31 agents, 16 skills, and full artefact management. Enterprise agile with governance overlay.

16 skills · 11 commands · hooks

0

Evidence-driven scorecard engine for ideas, MVPs, and evolving projects. Scores across 5 dimensions (wedge, friction, loop, timing, trust) using scientific frameworks (JTBD, TAM, ISO, Rogers, Mayer) with confidence-weighted scoring and PROCEED/ITERATE/KILL gates.

6 skills · 7 commands · 10 agents · 2 MCP servers · hooks

0

Cross-repository audit orchestration plugin for onboarding and quality assessment in any project, with deterministic outputs and SQLite-backed execution tracking.

5 skills · 5 commands · 14 agents

0

Enterprise-grade repository structure analyzer, validator, and scaffolder with intelligent automation

6 skills · 7 commands · 4 agents · hooks

0

Formal predictive waterfall lifecycle framework for AI/ML products — 8 phases, 8 formal gates (A–H), 33 agents, 15 skills, and full artefact management. For regulated environments with formal handovers and requirements traceability.

8 skills · 8 commands · hooks

0

Write feature specs, plan roadmaps, synthesise user research, and analyse competitors. Full PM workflow covered.

6 skills · 6 commands · 1 agent · hooks

0

Similar plugins

superpowers

claudecodex

Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques

15 skills · hooks

obra/superpowers 316,836

context7

claudecodex

Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your coding agent's context.

1 MCP server

upstash/context7 64,709

Build powerful, stateful CLI interfaces for any GUI application using the cli-anything harness methodology.

5 commands

HKUDS/CLI-Anything 58,665

5 skills + 35 modes + Material Passport pipeline. Includes v3.6.7 cross-model audit gate and v3.6.8 generator-evaluator contract.

5 skills · 16 commands · 4 agents · hooks

Imbad0202/academic-research-skills 56,698

Automates browser interactions for web testing, form filling, screenshots, and data extraction

12 skills

vercel-labs/agent-browser 50,373

Use Alibaba Open Code Review from local Codex.

2 skills

alibaba/open-code-review 50,068

Maintain solution-audit?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins14 plugins