AgentFlow 1.0 · Checkout-first evaluation

Inspect the fit before AgentFlow writes to your project.

AgentFlow 1.0 requires Node.js 20 or newer, Git, and pnpm for the source checkout. The npm package is not published, so pin the v1.0.0 tag and review the checkout you intend to use.

Clone and install repository dependencies

git clone https://github.com/smota/agentflow-sdlc.git
cd agentflow-sdlc
git checkout v1.0.0
pnpm install --frozen-lockfile

Inspect the environment read-only

node bin/cli.mjs doctor-env --target C:/work/project --json

Generate the assisted onboarding handoff
```
node bin/cli.mjs onboarding-prompt --target C:/work/project
```
The prompt asks the active assistant to inspect project policy, tools, agents, branch strategy, and validation expectations before proposing changes.
Review before initialization
Confirm the chosen version, target path, planned files, project-owned instructions, and repository-specific validation. Run the selected version’s CLI help and docs before any write command.

Already adopted?

Update without overwriting project-owned decisions.

node bin/cli.mjs update-prompt --target C:/work/project
node bin/cli.mjs doctor --target C:/work/project

The assisted update path uses the framework lock and read-only inspection before proposing sync. Divergent, project-managed files remain visible instead of being silently replaced.

Read the CLI manual Assisted onboarding docs ↗

Decision boundary

Adoption is a repository change.

Preserve and merge existing project instructions.
Keep dependencies and lockfiles project-scoped.
Ask before changing GitHub automation, agent settings, hooks, or branch protection.
Validate the installed files and the project’s own commands after adoption.