Flow Setup

Trigger

Use for setup only.

Repository & Stack Detection: Detect language, framework, canonical commands (test, lint, typecheck), and existing Flow configuration.
Scaffold Hierarchical OKF Layout: Initialize .agents/bundles/index.md (with okf_version: "0.2"). Create product/product.md, product/tech-stack.md, and knowledge/workflow.md; create knowledge/patterns/<topic>.md chapters and their directory only when repository evidence supports them.
Standalone Project Skills Option: Ask whether to install a standalone, project-local Flow dependency closure into .agents/skills/. This prompt defaults to skip and installation requires explicit opt-in. Treat the standalone copy as an alternative to the global plugin, not an overlay.
Validation & State Write: Verify bundle links and OKF frontmatter compliance, then write .agents/setup-state.json with setup_status: complete.