DevFlow

DevFlow is a portable workflow for turning ideas into GitHub issues, implementing them, validating changes, and reviewing pull requests with a consistent engineering process. Every workflow is driven by natural language, for example "Use DevFlow to implement issue #123".

Requirements: git, and the GitHub CLI (gh) for issue and PR workflows. Optional: web access for research, and the OpenSpec CLI (@fission-ai/openspec 1.x) in repositories that use OpenSpec.

Workflow Map

• Setup/configuration: read references/setup.md when the user asks to configure DevFlow for a repository, create project-local workflow configuration, or adapt templates.
• Feature planning: read references/feat.md when the user asks to create a feature spec, bug spec, or GitHub issue.
• Implementation: read references/dev.md when the user asks to implement a GitHub issue or open a development branch for one, or to open a PR for work already committed on the current branch, which needs no issue.
• Validation: read references/check.md when the user asks to run tests, lint, type checks, build checks, or quality gates.
• PR review: read references/review-pr.md when the user asks to review a pull request, validate a PR branch, or approve/request changes.
• Research: read references/research.md when the user asks to investigate a technology, architecture, or requirement before planning.
• Epic planning: read references/epic.md when the user asks to plan a large initiative or split work into phases/issues.
• Worktrees: read references/worktrees.md before creating, working in, or removing a git worktree, such as when a workflow runs in isolation.
• OpenSpec/OPSX: read references/openspec.md before running any openspec or /opsx:* command, or when configuring OpenSpec for a repository.

Workflow Handoffs