All skills
failure-contract-design
FoundationJIT onlyanalysis-agent/task-agent/review-agent: use when retryable, terminal, timeout, partial-failure, or fallback semantics change across boundaries; skip unchanged failures.
- Group
- Backend engineering
- Supported roles
- MainAnalysisTaskReview
- Source
- SKILL.md
Use when
Trigger signals that make this skill the right owner
- failure meaning taxonomy retryable terminal timeout cancellation dependency partial degraded boundary translation safe representation cause preservation
Do not use when
Anti-triggers — as binding as the triggers above
- no task-local failure contract design decision is required
Required inputs
What must be supplied before this skill can decide anything
- current task contract
- selected primary Professional Skill
- task-local trigger evidence
Output contract
What this skill owes the next role
- Failure Contract with stable taxonomy, boundary translation, retryable or terminal meaning, partial or degraded outcomes, safe external and internal representations, preserved cause, negative-path evidence, specialist routes, and residual risk
Escalation signals
When this skill must hand the decision back
- Unclear failure semantics swallow errors leak raw internals confuse retry behavior hide partial failures and break async recovery
Loaded by
This skill never owns a task. These professionals may pull it in as Layer 3.
Targeted references
Each reference carries its own load condition. None of them enter context by default.
| Reference | Load when | Do not load when | Required by |
|---|---|---|---|
| benchmarks-and-patterns.mdbenchmark-pattern | Failure taxonomy, translation, retry, or degraded-state semantics need selection. | No material boundary or failure behavior changes. | TaskReviewAnalysis |
| checklist.mddecision-checklist | Failures span partial outcomes, cancellation, dependencies, or async terminal states. | One internal error remains fully contained. | TaskReviewAnalysis |
| evidence-patterns.mdevidence-pattern | Failure claims need fresh translation, redaction, and recovery tests. | No safety or retryability claim is being closed. | TaskReviewAnalysis |