design-contractslisted
Install: claude install-skill zero8dotdev/smriti
# smriti Design Contract Guardrails
This skill activates whenever you are **adding or modifying a CLI command**,
**changing JSON output**, **touching telemetry/logging code**, or **altering
config defaults** in the smriti project.
---
## Contract 1 — Dry Run
### Mutating commands MUST support `--dry-run`
The following commands write to disk, the database, or the network. Every one of
them **must** honour `--dry-run`:
| Command | Expected guard pattern |
| ------------ | ----------------------------------------------------------------------------- |
| `ingest` | `const dryRun = hasFlag(args, "--dry-run");` then no DB/file writes when true |
| `embed` | same |
| `categorize` | same |
| `tag` | same |
| `share` | same |
| `sync` | same |
| `context` | already implemented — keep it |
When `--dry-run` is active:
- `stdout` must describe **what would happen** (e.g. `Would ingest N sessions`).
- `stderr` must note what was skipped (`No changes were made (--dry-run)`).
- Exit code f