mcpField
L
ln-640-pattern-evolution-auditor

ln-640-pattern-evolution-auditor

github.com/levnikolaevichTesting & quality584382 installsUpdated 2d ago
Repository

About ln-640-pattern-evolution-auditor

A coordinator skill that delegates architecture reviews across seven specialized auditors, covering patterns, boundaries, contracts, dependencies, modernization, structure, and configuration. It requires research before scoring and produces a final audit report with a remediation plan.

Key features

  1. 01Coordinate seven architecture auditors
  2. 02Research before pattern scoring
  3. 03Review boundaries and API contracts
  4. 04Aggregate and deduplicate findings
  5. 05Produce a report and remediation plan

Use cases

  1. 01Assess the fit of existing architecture patterns
  2. 02Check layer ownership and boundaries
  3. 03Review API contracts and dependency topology
  4. 04Organize architecture findings into remediation steps

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-640-pattern-evolution-auditor

After installing, type/ln-640-pattern-evolution-auditorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
architecture_audit_worker_boundaries.md
audit_final_report_contract.md
epistemic_protocol.md
evaluation_coordinator_runtime_contract.md
evaluation_research_contract.md
evaluation_summary_contract.md
layer_rules.md
meta_analysis_protocol.md
research_tool_fallback.md

Details

From the project README

Paths: File paths (references/, ../ln-*) are relative to this skill directory.

Type: L2 Coordinator Category: 6XX Audit

Pattern Evolution Auditor

Mandatory Read

MANDATORY READ: Load references/evaluation_coordinator_runtime_contract.md, references/evaluation_summary_contract.md, references/evaluation_research_contract.md MANDATORY READ: Load references/audit_final_report_contract.md MANDATORY READ: Load references/architecture_audit_worker_boundaries.md MANDATORY READ: Load references/research_tool_fallback.md Conditional read: load references/epistemic_protocol.md only when source confidence or claim uncertainty affects issue validation.

Purpose

  • audit architecture/design evolution: pattern fitness, layer ownership, service/API contracts, dependency topology, modernization, physical structure, and configuration boundaries
  • coordinate exactly ln-641 through ln-647
  • require research before pattern scoring

Runtime Contract

Runtime family:

  • evaluation-runtime

Identifier:

  • pattern-audit

Phase order:

  1. PHASE_0_CONFIG
  2. PHASE_1_DISCOVERY
  3. PHASE_2_RESEARCH
  4. PHASE_3_BOUNDARY_AUDITS
  5. PHASE_4_PATTERN_ANALYSIS
  6. PHASE_5_AGGREGATE
  7. PHASE_6_REPORT
  8. PHASE_7_SELF_CHECK

Worker Set

  • ln-641-pattern-fitness-auditor
  • ln-642-layer-ownership-boundary-auditor
  • ln-643-api-contract-auditor
  • ln-644-dependency-topology-auditor
  • ln-645-architecture-modernization-auditor
  • ln-646-project-structure-auditor
  • ln-647-configuration-boundary-auditor

Worker Invocation (MANDATORY)

Host Skill Invocation: Skill(skill: "...", args: "...") is mandatory delegation.

  • Claude: call the Skill tool exactly as shown.
  • Codex: if no Skill tool exists, locate the named skill in available skills, read its SKILL.md, treat args as $ARGUMENTS, execute that skill workflow, then return here with its result/artifact.
  • Do not inline worker logic or mark the worker complete without executing the target skill.

Use the Skill tool for delegated workers. Do not inline worker logic inside the coordinator.

TodoWrite format (mandatory):

  • Resolve audit scope and build manifest
  • Load architecture patterns and layers
  • Run best-practice research
  • Run boundary and contract audits
  • Analyze pattern compliance and gaps
  • Aggregate worker findings
  • Generate final audit report and remediation plan
  • Verify cleanup and self-check

Representative invocations:

Skill(skill: "ln-641-pattern-fitness-auditor", args: "{scope}")
Skill(skill: "ln-642-layer-ownership-boundary-auditor", args: "{scope}")
Skill(skill: "ln-643-api-contract-auditor", args: "{scope}")
Skill(skill: "ln-644-dependency-topology-auditor", args: "{scope}")
Skill(skill: "ln-645-architecture-modernization-auditor", args: "{scope}")
Skill(skill: "ln-646-project-structure-auditor", args: "{scope}")
Skill(skill: "ln-647-configuration-boundary-auditor", args: "{scope}")

Workflow

  1. Start evaluation-runtime.
  2. Discover candidate patterns and applicability.
  3. Run mandatory research first:
    • official docs or standards
    • MCP Ref
    • Context7 when library/framework patterns are involved
    • current web best-practice research
  4. Run boundary audits before pattern scoring.
  5. Run pattern analysis only after boundary results and research exist.
  6. Aggregate scores and worker findings by reading every worker report_path, normalizing actions from references/architecture_audit_worker_boundaries.md, deduplicating issues, resolving worker conflicts, and validating actionable problems against references/evaluation_research_contract.md.
  7. Write .hex-skills/runtime-artifacts/runs/{run_id}/audit-report/ln-640--final-report.md with remediation plan per references/audit_final_report_contract.md.
  8. Remove temporary worker markdown reports and record cleanup evidence.
  9. Write the evaluation-coordinator summary with report_path set to the final report.

Definition of Done

  • Evaluation runtime started
  • Pattern applicability resolved
  • Best-practice research completed
  • Boundary audit summaries recorded
  • Pattern analysis summaries recorded
  • Worker set remained exactly ln-641 through ln-647
  • Worker conflicts resolved with architecture_audit_worker_boundaries.md
  • Final report and remediation plan written
  • Temporary worker markdown reports removed
  • evaluation-coordinator summary written
  • Runtime completed

Meta-Analysis

Optional reference: load references/meta_analysis_protocol.md only when the user asks for post-run meta-analysis or protocol-formatted run reflection.

When requested after the coordinator run, analyze the session per protocol section 7 and include the protocol-formatted output with the final pattern audit result.

References

  • Workers: ../ln-641-pattern-fitness-auditor/SKILL.md, ../ln-642-layer-ownership-boundary-auditor/SKILL.md, ../ln-643-api-contract-auditor/SKILL.md, ../ln-644-dependency-topology-auditor/SKILL.md, ../ln-645-architecture-modernization-auditor/SKILL.md, ../ln-646-project-structure-auditor/SKILL.md, ../ln-647-configuration-boundary-auditor/SKILL.md
  • Shared pattern refs: references/layer_rules.md; pattern and scoring manuals are local to ../ln-641-pattern-fitness-auditor/references/

Version: 2.0.0 Last Updated: 2026-02-08

Comments

Markdown supported