Skip to content

docs: add example .preflight/ config and triage YAML files#296

Open
TerminalGravity wants to merge 4 commits intomainfrom
docs/preflight-config-examples
Open

docs: add example .preflight/ config and triage YAML files#296
TerminalGravity wants to merge 4 commits intomainfrom
docs/preflight-config-examples

Conversation

@TerminalGravity
Copy link
Collaborator

Adds well-commented example config.yml and triage.yml to examples/.preflight/ so users can copy them into their project root and customize. Every field is documented inline with descriptions of valid values and defaults.

The examples README already referenced these files but they didn't actually exist.

Adds a ready-to-use CLAUDE.md template that makes Claude Code
automatically run preflight_check on prompts. Users can copy it
into their project to get preflight working without manual tool calls.

Referenced from Quick Start in README and examples/README.
- CLI now responds to --help/-h with usage info, profiles, and links
- CLI now responds to --version/-v with package version
- Previously, any flag just launched the interactive wizard
- Fixed README badge from Node 18+ to Node 20+ (matches engines field)
Adds well-commented example config.yml and triage.yml to examples/.preflight/
so users can copy them into their project root and customize. Every field is
documented inline with descriptions of valid values and defaults.
Copy link
Collaborator Author

@TerminalGravity TerminalGravity left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great addition. The example CLAUDE.md is exactly what new users need. TROUBLESHOOTING.md covers the common failure modes well. --help and --version on the CLI are overdue basics. Ready to merge.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant