borghei/Claude-Skills / engineering/spec-driven-workflow
spec-driven-workflow
VerifiedRun development from an executable specification with traceable requirement IDs and merge-time coverage gates. Use when starting a greenfield feature, reviving a stale spec, or gating merges on requirement coverage.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 19.0 KB |
| assets/sample_requirements.json | config | 5.3 KB |
| assets/sample_spec.md | markdown | 1.9 KB |
| assets/sample_trace_index.json | config | 899 B |
| assets/spec-template.md | markdown | 3.2 KB |
| references/conversation-capture-and-implementation-loop.md | markdown | 7.3 KB |
| references/spec-writing-guide.md | markdown | 9.6 KB |
| references/traceability-model.md | markdown | 9.0 KB |
| scripts/spec_lint.py | script | 8.2 KB |
| scripts/spec_parse.py | script | 8.2 KB |
| scripts/trace_coverage.py | script | 8.4 KB |
assets/sample_spec.md
View on GitHub# API Key Rotation — Specification
This sample deliberately mixes precise and ambiguous requirements so the linter
produces findings on its own sample data.
## Key Issuance
- The issuance service must generate a 32-byte key using a CSPRNG and return it exactly once.
- Given a valid tenant, when POST /keys is called, then a 32-byte key is returned with status 201.
- Given the same key, when GET /keys/{id} is called, then the secret is absent from the response.
- The issuance service must reject requests from tenants holding 10 or more active keys with status 429.
- Given a tenant with 10 active keys, when POST /keys is called, then status 429 is returned.
- Keys must be fast to generate.
- The system should be user-friendly and secure.
## Rotation
- The rotation job must mark a key as pending-revocation 14 days before its expiry timestamp.
- Given a key expiring in 14 days, when the rotation job runs, then its state is pending-revocation.
- The rotation job must send one notification per pending-revocation transition, at most once per key.
- Given a key already notified, when the rotation job runs again, then no second notification is sent.
- Notifications should be delivered.
- It must handle several edge cases and/or retries appropriately.
## Revocation
- The revocation endpoint must invalidate a key within 5 seconds of the call returning 204.
- Given a revoked key, when it is used within 5 seconds, then status 401 is returned.
- Audit records must be written for every revocation by the audit service.
- Given a revocation, when the audit log is queried, then a record with actor and timestamp exists.
- Revoked keys must not be reissued. TBD whether reuse of the key ID is permitted.
## Non-Functional
- The rotation job must complete a 100,000-key sweep in under 90 seconds at p95.
- Given 100,000 keys, when the sweep runs, then p95 wall time is under 90 seconds.
- The service should be scalable and performant under load.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |