# Flow > Flow is a way to build software with AI agents: you decide what to build, agents do the work. Portable skills for the agent you use, opinionated Next.js starters, and docs that people and agents can search. Flow is used by talking to your agent: install the skills once with `npx skills add gaboesquivel/flow-skills`, then say what you want ("explore this", "spec it", "build it", "ship it"). No skill must be named. Every page on https://flow-skills-md.vercel.app is also Markdown: append `.md` (home is https://flow-skills-md.vercel.app/index.md) or send `Accept: text/markdown`. Source: https://github.com/gaboesquivel/flow-skills · version 0.3.0 · commit da88c48271c0 ## Start here - [Get started](https://flow-skills-md.vercel.app/docs/get-started.md): install Flow and use your existing agent - [Methodology](https://flow-skills-md.vercel.app/methodology.md): the practice, not a pipeline - [Skills catalog](https://flow-skills-md.vercel.app/skills.md): every skill grouped, with phrases and install commands - [Full content](https://flow-skills-md.vercel.app/llms-full.txt): every guide, capability, article, and skill as one Markdown file ## Skills - [sync-docs](https://flow-skills-md.vercel.app/skills/sync-docs.md): Update the project's PRODUCT.md, DESIGN.md, GLOSSARY.md, and ARCHITECTURE.md to match accepted direction, and write the Flow block on request. Say "sync the docs". (Context alignment) - [explore](https://flow-skills-md.vercel.app/skills/explore.md): Talk through a product, feature, or plan as a product-engineering partner who knows the project's goals and constraints, weighs what already exists, and helps decide what is worth building and how you will know. Say "explore this". (Delivery) - [to-spec](https://flow-skills-md.vercel.app/skills/to-spec.md): Turn the conversation into a numbered draft spec using project conventions, and accept it when approved. Say "spec it". (Delivery) - [to-tasks](https://flow-skills-md.vercel.app/skills/to-tasks.md): Break a plan, spec, or conversation into verifiable vertical-slice tasks with blockers, listed in the spec's Tasks checklist. Say "break it down". (Delivery) - [build](https://flow-skills-md.vercel.app/skills/build.md): Implement an authorized change on a branch, then review, fix, check, and confirm the branch is live, without merging. Say "build it". (Delivery) - [review](https://flow-skills-md.vercel.app/skills/review.md): Review work in a fresh context against intent, the spec, and root context, on top of /code-review, and repair confirmed defects; "review only" stays read-only. Say "review it". (Delivery) - [ship](https://flow-skills-md.vercel.app/skills/ship.md): Land work on the default branch without asking: build and verify it first when needed, then merge and check the shipped commit is live; or push a branch with no pull request. Say "ship it". (Delivery) - [research](https://flow-skills-md.vercel.app/skills/research.md): Investigate a question or a competitive landscape from sources and record a dated, sourced note another session can decide from. Say "research X". (Product discovery) - [align](https://flow-skills-md.vercel.app/skills/align.md): Check whether the product still fits its goals and users and what the outcome evidence shows; read-only. Say "check alignment". (Product discovery) - [domain-modeling](https://flow-skills-md.vercel.app/skills/domain-modeling.md): Settle project terms and record them in GLOSSARY.md; offer decision records sparingly. Say "what do we call this". (Shared language) - [council](https://flow-skills-md.vercel.app/skills/council.md): Get independent expert views and an evidence-based synthesis on a consequential decision; advisory only. Say "ask the council". (Advisory) - [experience](https://flow-skills-md.vercel.app/skills/experience.md): Walk a working product as its user would and report observed friction with evidence; read-only. Say "walk the experience". (Advisory) - [design](https://flow-skills-md.vercel.app/skills/design.md): Compare visual directions, let the user choose, and record the chosen identity in DESIGN.md; prototype layout variants or a throwaway spike. Say "design this". (Design) - [write-agents](https://flow-skills-md.vercel.app/skills/write-agents.md): Write or edit concise agent instructions and project context. Say "write agent instructions". (Writing) - [start](https://flow-skills-md.vercel.app/skills/start.md): Start a new project from flow-next or flow-mono with verified setup, renamed identity, and an initial Git commit. Say "start a Next.js project". (Project start) ## Guides - [Get started](https://flow-skills-md.vercel.app/docs/get-started.md): Install Flow and use your existing agent. Phrases, delivery modes, and work without a spec. - [A flexible working practice](https://flow-skills-md.vercel.app/docs/methodology.md): How the principles apply in practice: intent, evidence, design, connected context, and dogfooding. - [Principles](https://flow-skills-md.vercel.app/docs/principles.md): Optional methodology themes: validation, observability, agentic, lean, and velocity. - [What Flow is](https://flow-skills-md.vercel.app/docs/product.md): Mission, definition, the eight principles, success metrics, and the Flow ecosystem. - [Skill catalog reference](https://flow-skills-md.vercel.app/docs/skill-catalog.md): Every skill, the phrase that reaches it, and when to use it. - [Agent and host compatibility](https://flow-skills-md.vercel.app/docs/agent-compatibility.md): Install paths, invocation styles, and Flow mode across agent hosts. - [Glossary](https://flow-skills-md.vercel.app/docs/glossary.md): Project-specific meanings and essential distinctions. ## Capabilities - [Intent-to-verified delivery](https://flow-skills-md.vercel.app/capabilities/verified-delivery.md): How Flow carries a change from stated intent to a reviewed, checked, landed commit, and what each kind of evidence along the way does and does not prove. (Delivery & Execution) - [Scope and cost control](https://flow-skills-md.vercel.app/capabilities/scope-cost-control.md): How Flow uses an appetite and a scope guard to keep agent work inside what an increment is worth, and why that is a trade-off practice rather than a spending limit. (Delivery & Execution) - [Security and human control](https://flow-skills-md.vercel.app/capabilities/security-human-control.md): Where Flow's guidance helps an agent act within your authority, where real enforcement comes from instead, and which changes still wait for a person. (Trust & Reliability) ## Articles - [What counts as verified delivery?](https://flow-skills-md.vercel.app/blog/intent-to-verified-delivery.md): One real change to Flow's own delivery lifecycle, followed from intent through implementation, review, checks, and liveness, with what each piece of evidence does and does not prove. (2026-11-02) ## Starters - [flow-next](https://flow-skills-md.vercel.app/starters/flow-next.md): One focused Next.js app with a public Assistant, a protected Operator, and agent-facing MCP surfaces. Repository: https://github.com/gaboesquivel/flow-next - [flow-mono](https://flow-skills-md.vercel.app/starters/flow-mono.md): A minimal Turborepo with a Next.js app in apps/web and shared UI components in packages/ui. Repository: https://github.com/gaboesquivel/flow-mono ## Agent interfaces - [Search API](https://flow-skills-md.vercel.app/api/search?q=ship): `GET /api/search?q=&limit=1-25&kind=skill|doc|decision|starter|capability|article`, ranked results with canonical URLs - Ask API: `POST https://flow-skills-md.vercel.app/api/ask` with `{"question": "..."}`, source-grounded answer with citations - MCP (Streamable HTTP, read-only, no auth): https://flow-skills-md.vercel.app/api/mcp; tools: search_flow, list_skills, get_skill, get_doc, ask_flow - [MCP discovery](https://flow-skills-md.vercel.app/.well-known/mcp.json), [server card](https://flow-skills-md.vercel.app/.well-known/mcp/server-card.json), [AI catalog](https://flow-skills-md.vercel.app/.well-known/ai-catalog.json) - [OpenAPI 3.1](https://flow-skills-md.vercel.app/openapi.json) - [Sitemap](https://flow-skills-md.vercel.app/sitemap.xml) - [For agents](https://flow-skills-md.vercel.app/agents.md): contracts, examples, and error format ## Optional - [Decisions index](https://flow-skills-md.vercel.app/docs/decisions.md): 70 numbered decision records with rationale - [Curated Flow Skills distribution](https://flow-skills-md.vercel.app/docs/decisions/0001-curated-distribution.md) - [Maintain Flow skills as local source](https://flow-skills-md.vercel.app/docs/decisions/0002-local-skill-ownership.md) - [Skill naming and catalog shape](https://flow-skills-md.vercel.app/docs/decisions/0003-skill-naming.md) - [Portable skill catalog and distribution](https://flow-skills-md.vercel.app/docs/decisions/0004-portable-skill-catalog.md) - [Misc group and tldr skill](https://flow-skills-md.vercel.app/docs/decisions/0005-misc-tldr-skill.md) - [Flow Lite skill and flat documentation](https://flow-skills-md.vercel.app/docs/decisions/0006-flow-lite-and-flat-docs.md) - [Official Flow product identity in PRODUCT.md](https://flow-skills-md.vercel.app/docs/decisions/0007-flow-product-identity.md) - [Leading words and visual summaries](https://flow-skills-md.vercel.app/docs/decisions/0008-leading-words-and-visual-summaries.md) - [Adopter product context is not Flow's identity](https://flow-skills-md.vercel.app/docs/decisions/0009-adopter-product-context.md) - [Optional start skill authorized](https://flow-skills-md.vercel.app/docs/decisions/0010-optional-start-skill.md) - [Replaceable homepage and GenUI playground routes](https://flow-skills-md.vercel.app/docs/decisions/0011-homepage-and-genui-playground.md) - [Start bootstrap library modules](https://flow-skills-md.vercel.app/docs/decisions/0012-start-bootstrap-lib.md) - [Restore selected engineering skills](https://flow-skills-md.vercel.app/docs/decisions/0013-restore-engineering-skills.md) - [Handoff skill](https://flow-skills-md.vercel.app/docs/decisions/0014-handoff-skill.md) - [Rename to-tasks and restore domain-modeling](https://flow-skills-md.vercel.app/docs/decisions/0015-tasks-and-domain-modeling.md) - [Start bootstraps in place and reads the template from the request](https://flow-skills-md.vercel.app/docs/decisions/0016-start-in-place.md) - [Coexist with Claude Code built-in skills](https://flow-skills-md.vercel.app/docs/decisions/0017-claude-code-skill-coexistence.md) - [Interview extracts the user's intent](https://flow-skills-md.vercel.app/docs/decisions/0018-interview-extracts-intent.md) - [Voice-first invocation](https://flow-skills-md.vercel.app/docs/decisions/0019-voice-first-invocation.md) - [Flow mode: conversational delivery and in-session task orchestration](https://flow-skills-md.vercel.app/docs/decisions/0020-flow-mode.md) - [Autonomous explore and ship: GitHub issues, grouped pull requests](https://flow-skills-md.vercel.app/docs/decisions/0021-autonomous-explore-and-ship.md) - [Start runs explore alongside the bootstrap](https://flow-skills-md.vercel.app/docs/decisions/0022-start-runs-explore.md) - [Agent-first, API-first principle](https://flow-skills-md.vercel.app/docs/decisions/0023-agent-first.md) - [Gated hand-offs and outward writes](https://flow-skills-md.vercel.app/docs/decisions/0024-gated-hand-offs.md) - [Wave checkpoints and visual review](https://flow-skills-md.vercel.app/docs/decisions/0025-wave-checkpoints.md) - [Process depth, one setup path, and the spec–decision boundary](https://flow-skills-md.vercel.app/docs/decisions/0026-process-depth.md) - [Progress board skill](https://flow-skills-md.vercel.app/docs/decisions/0027-progress-board-skill.md) - [Build opens the pull request; ship lands accepted work](https://flow-skills-md.vercel.app/docs/decisions/0028-build-and-ship.md) - [Spec issues and fast parallel builds](https://flow-skills-md.vercel.app/docs/decisions/0029-spec-issues.md) - [Asked delivery mode and local mode without a remote](https://flow-skills-md.vercel.app/docs/decisions/0030-asked-delivery-and-local-mode.md) - [Fan out by default](https://flow-skills-md.vercel.app/docs/decisions/0031-fan-out-by-default.md) - [Local build lands on main; ship publishes and verifies](https://flow-skills-md.vercel.app/docs/decisions/0032-local-build-lands-ship-verifies.md) - [Shared files do not move the reviewed head](https://flow-skills-md.vercel.app/docs/decisions/0033-shared-files-and-reviewed-head.md) - [No ceremony without a spec](https://flow-skills-md.vercel.app/docs/decisions/0034-no-ceremony-without-a-spec.md) - [Open the spec issue at acceptance](https://flow-skills-md.vercel.app/docs/decisions/0035-spec-issue-on-acceptance.md) - [One explore depth, deeper research on request](https://flow-skills-md.vercel.app/docs/decisions/0036-one-explore-depth.md) - [Git for delivery, GitHub for GitHub mode](https://flow-skills-md.vercel.app/docs/decisions/0037-git-for-delivery-github-for-github-mode.md) - [Direction changes are confirmed and recorded](https://flow-skills-md.vercel.app/docs/decisions/0038-direction-changes-are-confirmed-and-recorded.md) - [Build never requires a spec](https://flow-skills-md.vercel.app/docs/decisions/0039-build-never-requires-a-spec.md) - [Ship verifies liveness, not the journey](https://flow-skills-md.vercel.app/docs/decisions/0040-ship-verifies-liveness.md) - [Product alignment skill](https://flow-skills-md.vercel.app/docs/decisions/0041-align-skill.md) - [Outcome-first build and ship](https://flow-skills-md.vercel.app/docs/decisions/0042-outcome-build-and-ship.md) - [Workers when they pay, checks once per head](https://flow-skills-md.vercel.app/docs/decisions/0043-workers-when-they-pay.md) - [Fast delivery: checks once, liveness only, review when it pays](https://flow-skills-md.vercel.app/docs/decisions/0044-fast-delivery.md) - [Templates pin flow-skills; one owner per workflow](https://flow-skills-md.vercel.app/docs/decisions/0045-templates-pin-flow-skills.md) - [Portable measurement assistance](https://flow-skills-md.vercel.app/docs/decisions/0046-measurement-assistance.md) - [Trusted LLM review, record checks in validate](https://flow-skills-md.vercel.app/docs/decisions/0047-trusted-review-and-local-record-checks.md) - [Delivery phrases are approvals](https://flow-skills-md.vercel.app/docs/decisions/0048-delivery-phrases-are-approvals.md) - [The agent does the work](https://flow-skills-md.vercel.app/docs/decisions/0049-agent-does-the-work.md) - [GitHub governance preset](https://flow-skills-md.vercel.app/docs/decisions/0050-github-governance-preset.md) - [Design skill for visual direction](https://flow-skills-md.vercel.app/docs/decisions/0051-design-skill.md) - [Git-first, best-effort coordination](https://flow-skills-md.vercel.app/docs/decisions/0052-git-first-coordination.md) - [Delivery appetite and scope protection](https://flow-skills-md.vercel.app/docs/decisions/0053-delivery-appetite-and-scope.md) - [Native capabilities before Flow machinery](https://flow-skills-md.vercel.app/docs/decisions/0054-native-capability-first-sessions.md) - [Capability-based GitHub and host-triggered builds](https://flow-skills-md.vercel.app/docs/decisions/0055-capability-based-github-and-host-triggered-builds.md) - [Contract-first tests, no UI tests by default](https://flow-skills-md.vercel.app/docs/decisions/0056-contract-first-tests.md) - [Draft workspace, checks on ready](https://flow-skills-md.vercel.app/docs/decisions/0057-draft-workspace-ready-checks.md) - [Fresh-context review, effort by risk](https://flow-skills-md.vercel.app/docs/decisions/0058-review-passes-and-risk-tiers.md) - [Vercel CI vs GitHub Actions: staying on GitHub Actions for now](https://flow-skills-md.vercel.app/docs/decisions/0059-github-actions-over-vercel-ci.md) - [Build slices by area](https://flow-skills-md.vercel.app/docs/decisions/0060-slice-by-area.md) - [Eve as the default agent runtime in Flow starters](https://flow-skills-md.vercel.app/docs/decisions/0061-eve-default-agent-runtime.md) - [Claude Code first](https://flow-skills-md.vercel.app/docs/decisions/0062-claude-code-first.md) - [Decision-record threshold](https://flow-skills-md.vercel.app/docs/decisions/0063-decision-record-threshold.md) - [Cursor plugin](https://flow-skills-md.vercel.app/docs/decisions/0064-cursor-plugin.md) - [Verification proportional to risk](https://flow-skills-md.vercel.app/docs/decisions/0065-proportional-verification.md) - [Specs sized by delivery, not length](https://flow-skills-md.vercel.app/docs/decisions/0066-specs-sized-by-delivery.md) - [Flow boundaries: plugin, starters, scripts, host](https://flow-skills-md.vercel.app/docs/decisions/0067-flow-boundaries.md) - [The experience skill and the new-skill test](https://flow-skills-md.vercel.app/docs/decisions/0068-experience-skill.md) - [Direction changes gate at adoption, not discussion](https://flow-skills-md.vercel.app/docs/decisions/0069-direction-changes-at-adoption.md) - [A research skill, clearer names, and an outcome in every initiative spec](https://flow-skills-md.vercel.app/docs/decisions/0070-research-and-clearer-names.md)