# small-scripts

A collection of small, standalone utility scripts for daily use. Scripts are symlinked into `~/sbin` for PATH availability.

## Approach

This project uses **spec-driven development** (OpenSpec) as a testbed for agent-driven development and refinement:

1. Every script starts with a spec in `specs/`
2. Every script supports `--dryrun` to preview actions without side effects
3. Every script has a test in `tests/` that validates dryrun behaviour against the spec

## Scripts

| Script | Purpose | Status |
|--------|---------|--------|
| *(none yet)* | | |

## Quick Start

```bash
# Run all tests
./tests/run-all.sh

# Symlink a script into ~/sbin
ln -sf "$(pwd)/scripts/<name>" ~/sbin/<name>
```

## Milestones

| # | Description | Status |
|---|-------------|--------|
| M1 | Project setup, first script | In progress |