Skill: Audit Domain 7 — Reliability & Edge Cases

SkillDev tools

Audit the reliability domain — error handling, retries, idempotency, race conditions, partial failures, timeouts, graceful degradation. Run as part of /audit Phase E.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Skill: Audit Domain 7 — Reliability & Edge Cases skill

What this skill tells your AI

The instructions your AI receives, as published by wolverin0/clawtrol in .claude/skills/audit-domain-07-reliability/SKILL.md and read by ahel’s review.

This skill audits one specific domain. It runs in an isolated subagent context spawned by the audit-orchestrator. The subagent loads this skill and the audit rules, runs against the audit scope, and returns a ~2K-token findings report.

Pre-flight

view @.claude/context/audit-rules.md

If you have findings from previous audit phases (hard stops, Tambon, blind spots), the orchestrator passes them as input. Use them — don't re-discover findings other phases already produced. Specifically:

  • Hard stops related to this domain: H5
  • Blind spots that route to this domain: B2, B5, B6, B10, B11

If the orchestrator didn't pass you these inputs, do NOT re-run the hard-stops or blind-spots walks. Audit your domain only and trust the orchestrator to stitch.

Scope

Error handling completeness, retry logic, idempotency, race conditions, partial failures, timeouts, graceful degradation, circuit breakers, bulkheads.

Key questions to answer

For each, find the evidence and report it. The questions are the audit's spine — every finding maps back to one of them.

  1. Does every external call have a timeout?
  2. Are retries bounded (no infinite retry loops)?
  3. Are write operations idempotent where they need to be?
  4. Are partial failures handled (multi-step ops that succeed halfway)?
  5. Are exceptions logged with enough context to debug, or just swallowed?
  6. Does the app degrade gracefully when a dependency is down?

Files most likely to have findings

Don't read everything. Read these files first:

  • external API client wrappers
  • any 'retry' / 'backoff' utility
  • webhook handlers
  • background job handlers
  • transaction boundaries

If you exhaust these and the budget allows, expand outward. Otherwise, report what you found and note what you didn't read.

Process

  1. Re-read the rules. R1-R7 apply to every finding. Especially R2 (quote before cite) — for a domain skill running in a subagent, the subagent's context is fresh; don't assume you remember a file from a previous turn.

  2. Walk the key questions. For each question, run the relevant detection commands (greps, file reads, schema lookups). Capture evidence at path:line. Verify by reading the actual code.

  3. Cross-reference orchestrator inputs. If the orchestrator passed hard-stops or blind-spots findings tagged for this domain, include them in your report. Don't re-investigate; just include with the provided evidence.

  4. Triage. For each finding, set severity per the audit rubric and exploitability per R4.

  5. Produce the domain report.

Output format

═══════════════════════════════════════════════════════════════════════
  DOMAIN 7: Reliability & Edge Cases
═══════════════════════════════════════════════════════════════════════

▶ FOUNDER VIEW

[2-4 sentences in plain English. Sample tone:]
When something goes wrong (network blip, DB hiccup, third-party outage) — does the app recover, or does it corrupt state?

▶ TECHNICAL EVIDENCE

Scope of this domain audit:
  Files read:        <count>
  Files skipped:     <count> (reason: outside scope or low-priority)

Findings:

  F-7.1 — <one-line title>
    Severity:        Critical | High | Medium | Low
    Exploitability:  EXPLOITABLE-NOW | EXPLOITABLE-LOW-EFFORT | BAD-PRACTICE | UNKNOWN
    Hard-stop:       H<N> if applicable
    Blind-spot:      B<N> if applicable

    Evidence:
      <path:line>  <one-line description>

    What's wrong:
      <one paragraph>

    Why it matters:
      <one sentence>

    Recommended fix:
      <one paragraph; for full fix prompt, use /audit-fix F-7.1>

    Verification after fix:
      <command>

  F-7.2 ...

Summary:
  Total findings: <count>
  By severity:    <counts>
  Most urgent:    <which finding ID>

[SECTION COMPLETE: Domain 7]

If the domain has zero findings:

▶ TECHNICAL EVIDENCE

  ✅ No findings in this domain.

  Verification:
    <commands run that produced no signal>

  Confidence: High | Medium | Low
  Reason for low confidence: <if applicable>

Failure modes to refuse

  • ❌ Producing findings without path:line citations (R1)
  • ❌ Citing a path you didn't read (R2)
  • ❌ Re-running hard-stops or blind-spots walks (orchestrator did this)
  • ❌ Including findings outside this domain's scope (route them to the right domain instead)
  • ❌ Soft-pedaling a Critical to Medium because "it's a small app" (R3)
  • ❌ Skipping section completion marker (R6)

Signals

GitHub stars
42
Forks
7
Last commit
Jul 2026
Advanced
Catalog kind
skill
Gateway key
audit-domain-07-reliability
Source
github.com/wolverin0/clawtrol