Lightweight spec framework

Build the right thing, and build it right

agentic-fy is a lightweight and configurable framework for creating and managing software specifications, keeping you and your coding agents aligned as the work evolves.

Synopsis

With agentic-fy, you capture what you want to build in a spec and keep your team and coding agents aligned as the work evolves.

We help you refine the requirements, validate that they describe the right thing, and verify that the implementation matches what was agreed.

In essence, agentic-fy helps you build the right thing and build it right.

Installation

A Node.js CLI (version 20.19.0 or newer). Install it globally:

# install
npm install -g @agentic-fy/agentic-fy

# or run without installing
npx @agentic-fy/agentic-fy --version
Workflow

Five phases to turn an idea into a change that's implemented, verified, and archived.

01
agentic-fy explore
Map the problem and understand the codebase.
02
agentic-fy propose
Draft proposal.md, specs/, design.md, tasks.md.
03
agentic-fy apply
Implement tasks from the specification.
04
agentic-fy verify
Check the implementation matches the spec.
05
agentic-fy archive
Archive completed changes.
Compatibility

Connect the MCP server to any compatible AI assistant.

Kiro Cursor GitHub Copilot Claude Windsurf any MCP client
How it works

One change, one folder

Each unit of work lives in agentic-fy/changes/ with the proposal, design, tasks, and specs together.

Artifacts build on each other

proposal → specs → design → tasks. Enablers, not gates: go back and adjust as you learn.

CLI + agent

The CLI creates and tracks the artifacts; the AI agent, via MCP, reads the plan and writes the code.

Agree before you code

You and the AI look at the same plan before a single line is written.