Jon Chery
2c08c778a9
REQ-221: skills/ directory with 9 Atelier-derived skill files mapped to the BA.A citizen-developer catalog: api, security, data, testing, observability, errors, devops, infrastructure-as-code, compliance. Each names the Atelier source path, distills first-principles to the citizen-dev-relevant subset, links to agent-checklist triggers, maps to BA.A 5-skill catalog. REQ-222: docs/skills.md index (9-skill table, Atelier provenance, 8 core principles C1-C8, consumption instructions, reference-only domains, excluded domains). PROJECT.md BA.A decision extended with the Atelier-derived skill catalog reference. ---ci--- project: acdl phase: 4 milestone: v1.18 status: execute requirements: covered: [REQ-221, REQ-222] partial: [] ---/ci---
34 lines
1.5 KiB
Markdown
34 lines
1.5 KiB
Markdown
# Skill: Errors
|
|
|
|
> **Atelier source:** `domains/errors/` (first-principles + patterns)
|
|
> **Core principles:** C1 Correctness, C7 Observability
|
|
> **BA.A mapping:** web API, worker, scheduled job
|
|
> **Consumer:** read this before authoring error handling.
|
|
|
|
## First Principles (citizen-developer-relevant subset)
|
|
|
|
- **Errors are not swallowed silently.** A bare `except: pass` is a bug.
|
|
Every caught error is either handled, re-raised, or logged with context.
|
|
- **Errors are specific.** Not `raise Exception("something went wrong")`
|
|
— a named exception with the what/where/why.
|
|
- **Errors preserve context.** The error carries the request ID, the
|
|
user, the action — enough to debug without reproducing.
|
|
- **Recovery is attempted when possible; fail fast when not.** Retry
|
|
transient errors with backoff; fail fast on invariant violations.
|
|
|
|
## Agent-Checklist Triggers (§ Errors)
|
|
|
|
- Errors are not swallowed silently
|
|
- Errors are specific (not generic "something went wrong")
|
|
- Errors preserve context (where, when, why, what)
|
|
- Recovery is attempted when possible; fail fast when not
|
|
|
|
## How Nova Uses This
|
|
|
|
Nova's confidence signal (D-040) uses error events as one of its 6 inputs.
|
|
The error skill ensures your application's errors are structured enough to
|
|
feed the signal: specific error types, preserved context, no silent
|
|
swallows. The platform's `report_error` Lambda action (D-055) creates a
|
|
GitHub issue on the platform repo when the pipeline fails — your
|
|
application errors should be structured enough to flow through the same
|
|
path. |