Skip to content
Skills Library
Programming · Automation

flow-setup

/flow-setup

Use when initializing or aligning Flow in a repository, migrating legacy .agents/ layouts, scaffolding OKF v0.2 knowledge bundles, or generating baseline and domain .agents/skills/ and .agents/agents/.

Author
cofin ↗
Repository
flow ↗
Licence
Apache-2.0
Last repository change
13.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
5
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • SKILL.md zawiera komentarze HTML (5). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

Use when initializing or aligning Flow in a repository, migrating legacy .agents/ layouts, scaffolding OKF v0.2 knowledge bundles, or generating baseline and domain .agents/skills/ and .agents/agents/.

Original author description

Use when initializing or aligning Flow in a repository, migrating legacy .agents/ layouts, scaffolding OKF v0.2 knowledge bundles, or generating baseline and domain .agents/skills/ and .agents/agents/.

How it works

  1. Trigger
  2. Workflow
  3. Guardrails
  4. Output
  5. Validation
Original SKILL.md headings · 41 lines, 518 words
SKILL.md preview
---
name: flow-setup
description: "Use when initializing or aligning Flow in a repository, migrating legacy .agents/ layouts, scaffolding OKF v0.2 knowledge bundles, or generating baseline and domain .agents/skills/ and .agents/agents/."
disable-model-invocation: true
---

# Flow Setup

<!-- lifecycle-ownership: owner=flow-setup; operations=setup -->

## Trigger

Use for `/flow:setup`. Follow [`../flow/references/setup.md`](../flow/references/setup.md).

## Workflow

1. **Environment Detection, Brownfield Alignment, & Sharded Toolchain Discovery**:
   - Inspect `.agents/setup-state.json` and `.agents/bundles/index.md`. If `.agents/` already exists, offer **Align & True-Up (Recommended)**, **Full Re-Setup**, or **Exit**.
   - In alignment/brownfield mode, inventory legacy layouts (`.beads/`, `.agents/specs/`, `.agents/tracks/`, `.agents/transactions/`, flat `knowledge/patterns.md`, sibling PRD child specs with `parent_prd:` if desired, un-promoted `bundles/research/`, legacy `.agents/skills/flow-memory-keeper/`), ensure subdirectory `index.md` files and `log.md` carry zero YAML frontmatter and zero standalone `---` body rules, and migrate active work without data loss after user confirmation.
   - Probe installed host binaries (`uv`, `python3`, `cargo`, `go`, `bun`, `pnpm`, `npm`, `make`, `just`, `pwsh`, `powershell`) alongside repository manifests. Fan out parallel read-only `@researcher` subsystem Scouts (`type_name="self"` with `agents/researcher.md` on Google Antigravity; `model="inherit"`).
2. **Scaffold Core Context Chapters & Rich OKF v0.2 Bundle (`.agents/bundles/`)**:
   - Initialize `.agents/bundles/index.md` (`okf_version: "0.2"`) and frontmatter-free `.agents/bundles/log.md`, `product/index.md`, `knowledge/index.md`, `research/index.md`, and `specs/index.md`.
   - Create Flow's core context chapters with bounded `<= 40`-line `<!-- truth: start -->` blocks and zero body `---` separators: `product/product.md`, `product/product-guidelines.md`, `product/tech-stack.md`, and `knowledge/workflow.md` (populated with verified host commands from [`../../templates/agent/workflow.md`](../../templates/agent/workflow.md)).
   - Synthesize evidence-backed nested chapters across `knowledge/{architecture,patterns,domains,testing,gotchas,decisions}/` (via parallel domain synthesis subagents when `>= 2` domains exist) with `sources: [{ id, resource, title }]` + `[^id]:` footnotes and `verified: [{ by, at }]`.
3. **Seed Baseline Engineering Disciplines & Stack-Specific Project-Local Skills (`.agents/skills/`) and Subagents (`.agents/agents/`)**:
   - Follow [`../multi-harness-plugins/SKILL.md`](../multi-harness-plugins/SKILL.md) and [`../flow-docs/references/agent-context.md`](../flow-docs/references/agent-context.md).
   - Embed baseline engineering rules into the repository's knowledge and skill set: **Deep-Module & Seam Design**, **Active Domain Modeling & ADR Filter**, **Public-Seam Vertical-Slice TDD & Hypothesis-Driven Bug Diagnosis**, and **Present-Tense Cold-Reader Prose & Documentation Accuracy**.
   - Generate consolidated domain skills (`.agents/skills/<domain>/SKILL.md` `<= 200` lines + `references/*.md`), domain review capability skills (`.agents/skills/review-<domain>/SKILL.md` + `references/checklist.md` + `references/false-positive-suppressions.md`), `.agents/skills/index.md`, and paired project-local subagents (`.agents/agents/<domain>-reviewer.md` and `.agents/agents/<domain>-specialist.md` with H1 `# ` headings, `mainAgent: false`, `subagent: true`, `model: inherit`, and `commandExecutionPolicy: sandbox`).
4. **Git Worktrees, Cross-Harness Permissions & `Stop` Hook Bootstrap, `AGENTS.md`, & `.agents/setup-state.json`**:
   - Ask once via `structured-choice-v1` whether `.agents/` is **`shared`** (tracked in Git, Recommended; linked `git worktree` checkouts edit worktree `.agents/` directly) or **`local-only`** (stealth mode via `.git/info/exclude`; linked worktrees symlink `.agents` to the primary checkout and route all Flow Markdown edits there), and verify `.venv` / `node_modules` symlinks when running inside a linked worktree.
   - Offer opt-in non-destructive harness policy, subagent permission allowlists (`.claude/settings.local.json` with backup, Codex linked-worktree `writable_roots` note, `.cursor/hooks.json`, `opencode.json`), update root `AGENTS.md` (preserving `<!-- project-customization: start -->` blocks), and write `.agents/setup-state.json` (`workflow_preferences.ignore_policy`, `workflow_preferences.model_routing: "auto"`).

## Guardrails

- Never copy Flow's global plugin skills (`flow`, `flow-*`, `okf`, `debloat`, `multi-harness-plugins`) or legacy `flow-memory-keeper` into `.agents/skills/`.
- Every materialized knowledge chapter must cite real repository paths (`path/to/file::Symbol`) in `sources:` and `[^id]` footnotes.
- Preserve existing custom content inside `<!-- project-customization: start -->` and `<!-- truth: start -->` blocks during alignment.

## Output

Return the initialized or aligned `.agents/bundles/` tree, generated `.agents/skills/` and `.agents/agents/` inventory, verified host commands, and next command (`/flow:spec` or `/flow:prd`).

## Validation

Confirm root `index.md` declares `okf_version: "0.2"`, all links in `index.md` and `.agents/skills/index.md` resolve on disk, every non-reserved `.md` file has valid OKF frontmatter, and `.agents/setup-state.json` records `setup_status: "complete"`.

Versions

RepositoryScoreLicence
This page · cofin/flow90Apache-2.0
cofin/flow100Apache-2.0

Database snapshot: 13.11.2026 · package version 6f916081ad67 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100flow
    Use when a repository has .agents, when the user asks for Flow lifecycle routing, OKF bundle task tracking, spec-first planning, TDD implementation, sync/status, review, finish, archive, or /flow:* help.
  • 100open-knowledge-format
    Define knowledge bundles with Google's Open Knowledge Format (OKF) v0.1. Use when the user mentions OKF, Open Knowledge Format, Google's knowledge format, LLM wiki bundles, agent knowledge packs, creating OKF bundles, validating OKF documents, or converting knowledge into the…
  • 90flow
    Use when a repository has .agents, when the user asks for Flow lifecycle routing, OKF v0.2 bundle task tracking, spec-driven planning, TDD implementation, status, learn/resynthesize, review, finish, archive, or /flow:* help.
  • 100okf-maintain-knowledge
    OKF — Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles. Use when capturing project knowledge (services, APIs, schemas, decisions) into an OKF bundle, when updating one after code or docs change, or when a repository's OKF bundle should inform the task.…
  • 100okf
    Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles — portable markdown + YAML frontmatter that both humans and agents read. Use when capturing project knowledge (services, APIs, schemas, metrics, runbooks, decisions) into an OKF bundle, when updating one…
  • 100okf
    Create, read, and maintain Open Knowledge Format documentation bundles in repositories. Use this skill when the user asks for /okf, OKF, Open Knowledge Format, docs-as-knowledge, reading project context from docs, reorganizing docs into an agent-readable bundle, updating…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.