Skip to main content
Firedrill discovers resource files recursively beneath the sourceRoot in firedrill.json. The following layout is recommended, not required.

Naming and formats

Use descriptive kebab-case filenames and the resource suffixes .tool, .scenario, .target, .drill, and .suite. YAML, YML, and JSON are supported for every resource. Tool behavior is JavaScript or TypeScript. Identity lives in each file’s id, not its path. You can change a display title without moving the file. If you move a Tool declaration, update its relative behavior-module path.

What belongs in Git

Generated evidence may contain synthetic records and agent output. Keep .firedrill/ out of version control even when the data is not production data.

Root configuration

toolPackages selects installed reusable Tools. Repository-owned Tool declarations under sourceRoot remain available without publishing a package.

Author the files

See how world, Tool, scenario, target, drill, and suite source relate.