docs: add probitas init command and maxFailures configuration

- Add probitas init command documentation to Quick Start section
- Document configuration file name variants and priority order
- Add maxFailures option for fail-fast mode support
- Update configuration example to JSONC format with comments

Author: lambdalisue

docs/configuration.md

@@ -5,15 +5,36 @@ all available options and common configuration patterns.
 
 ## Project Configuration
 
-Configure Probitas CLI defaults in a `probitas.json` file in your project root:
+Configure Probitas CLI defaults in a configuration file in your project root.
 
-```json
+### Configuration File Names
+
+Probitas looks for configuration files in this priority order:
+
+1. `probitas.json` - Standard JSON format
+2. `probitas.jsonc` - JSON with comments (recommended)
+3. `.probitas.json` - Hidden JSON format
+4. `.probitas.jsonc` - Hidden JSON with comments
+
+The first file found is used. JSONC files support `//` and `/* */` comments.
+
+### Configuration Options
+
+```jsonc
 {
+  // Glob patterns for scenario file discovery
   "includes": ["probitas/**/*.probitas.ts"],
+  // Glob patterns to exclude from discovery
   "excludes": ["**/*.skip.probitas.ts"],
+  // Output reporter (list, json)
   "reporter": "list",
+  // Maximum parallel scenario execution (0 = unlimited)
   "maxConcurrency": 4,
+  // Maximum failures before stopping (0 = unlimited)
+  "maxFailures": 0,
+  // Default timeout for scenarios
   "timeout": "30s",
+  // Default selectors for filtering scenarios
   "selectors": ["!tag:wip"]
 }
 ```
@@ -23,10 +44,26 @@ Configure Probitas CLI defaults in a `probitas.json` file in your project root:
 | `includes`       | Glob patterns for scenario file discovery | `["probitas/**/*.probitas.ts"]` |
 | `excludes`       | Glob patterns to exclude from discovery   | `[]`                            |
 | `reporter`       | Output reporter: `list`, `json`           | `"list"`                        |
-| `maxConcurrency` | Maximum parallel scenario execution       | unlimited                       |
+| `maxConcurrency` | Maximum parallel scenario execution       | unlimited (`0`)                 |
+| `maxFailures`    | Maximum failures before stopping          | unlimited (`0`)                 |
 | `timeout`        | Default timeout for scenarios             | `"30s"`                         |
 | `selectors`      | Default selectors for filtering scenarios | `[]`                            |
 
+### maxFailures
+
+Controls when the test runner stops execution:
+
+- `0` (default): Run all scenarios regardless of failures
+- `1`: Fail-fast mode - stop immediately on first failure
+- `n`: Stop after n failures
+
+```jsonc
+{
+  // Fail-fast: stop on first failure
+  "maxFailures": 1
+}
+```
+
 ### Selectors
 
 Selectors filter which scenarios to run. The format is `[!][type:]value`:
@@ -50,7 +87,7 @@ This runs scenarios with `api` tag AND without `slow` tag.
 
 ### CLI Override
 
-Command-line options override `probitas.json` settings:
+Command-line options override configuration file settings:
 
 ```bash
 # Override reporter
@@ -59,6 +96,9 @@ probitas run --reporter json
 # Override concurrency
 probitas run --max-concurrency 1
 
+# Fail-fast mode
+probitas run --max-failures 1
+
 # Add selectors (combined with config selectors)
 probitas run -s tag:smoke
 ```

docs/overview.md

@@ -65,6 +65,28 @@ nix profile install github:jsr-probitas/cli
 
 ## Quick Start
 
+### Initialize a Project
+
+Create a new Probitas project with example files:
+
+```bash
+# Create probitas/ directory with example files
+probitas init
+
+# Create custom directory
+probitas init -d scenarios
+
+# Overwrite existing files
+probitas init --force
+```
+
+This creates:
+
+- `example.probitas.ts` - Example scenario file
+- `probitas.jsonc` - Configuration file with defaults
+
+### Your First Scenario
+
 ```typescript
 import { client, expect, scenario } from "jsr:@probitas/probitas";