agent-wf

A CLI tool to automatically configure AI Agent rules, instructions, and workflows for your project.

Features

• Generates base rules enforcing docs/ logging and commit shortcuts ("1").
• Supports multiple AI IDEs simultaneously:
  • Cursor: .cursorrules
  • Zed: .zed/prompts/project-rules.md
  • Antigravity (Gemini): .gemini/rules.md
• Prompts for technology stack (Frontend, Backend, Fullstack) to generate precise framework-specific instructions.
• Includes pre-built AI Agent Workflows inside .agents/workflows, such as:
  • Core Agent Routine: Enforces a strict Plan -> Todo -> Implement -> Recheck -> Result -> Mark Done flow for the agent.
  • Auto Git Commit: Teaches the agent to read git diff and write conventional commit messages.
  • Web Research: Best practices for having the agent search documentation.
• Integrates automatically with Vercel Labs Skills (skills.sh):
  • React Best Practices (vercel-labs/react-best-practices)
  • Web Design Guidelines (vercel-labs/web-design-guidelines)

Installation

You can run it directly without installing permanently:

npx agent-wf

Or install it globally:

npm install -g agent-wf

Usage

Navigate to your workspace directory and run the command:

cd my-nextjs-app
npx agent-wf

Follow the interactive prompts to select your project type, IDEs, and Workflows you want to scaffold!

Non-Interactive Setup (CLI Options)

You can completely bypass the interactive prompts by passing the options directly:

npx agent-wf -p frontend -i antigravity -f all

Available Options:

• -p, --project <type>: Project type (frontend, backend, fullstack)
• -i, --ide <types>: Comma-separated target IDEs (cursor, zed, antigravity)
• -f, --features <types>: Comma-separated features/skills (e.g. agent-routine, git-commit, web-research, etc.). Use all to select every available feature at once.

How it Works (Triggering Workflows)

Once the CLI finishes generating the files, your AI IDE (Cursor, Zed, or Antigravity) will automatically detect the rules located in .cursorrules, .zed/prompts/project-rules.md, or .gemini/rules.md.

These rules instruct the AI Editor on how to behave. Workflows are stored in .agents/workflows/ and can be triggered on demand.

To trigger a workflow, use a slash command in the AI chat:

1. Agent Routine: /agent-routine — Starts the Plan → Todo → Implement → Document Result → Mark Done flow.
2. Git Commit: /git-commit — Reads git diff and generates a conventional commit message.
3. Code Review: /code-review — Reviews the provided diff for issues and improvements.
4. Daily Standup: /daily-standup — Generates a daily standup report from recent git history.
5. Browser Testing: /browser-testing — Runs browser-based testing and recording.
6. Figma Design: /figma-implement-design — Translates a Figma design to production code.
7. UI/UX Pro Max: /ui-ux-pro-max — Generates a design system and UI/UX guidelines.
8. Commit Shortcut: Type 1 into the AI chat to immediately git add ., generate a commit message, and push.

🧠 Workflow Router (Smart Auto-Detection)

If you select the Workflow Router skill during setup, you don't need to remember slash commands at all! The agent will automatically analyze your input and select the right workflow:

• "Build a login page" → triggers agent-routine
• "Review my code" → triggers code-review
• "1" → triggers git-commit
• "Generate standup" → triggers daily-standup

The skill is installed at .agents/skills/workflow-router/SKILL.md and is referenced in the generated rules.

Note on Skills: If you selected Vercel Labs or Antigravity Skills, those rules are downloaded into .agents/skills/. Your code editor will naturally observe those guidelines (e.g., UX/UI best practices, React boundaries) when writing or reviewing code!

Manual Skills Installation

Sometimes npx might fail to install the skills automatically during the scaffolding process depending on your local network or permissions. If your .agents/skills directory is empty after running the setup, you can manually install the skills by running these commands at the root of your project:

1. Vercel Labs: React Best Practices

npx -y skills add vercel-labs/agent-skills@react-best-practices

2. Vercel Labs: Web Design Guidelines

npx -y skills add vercel-labs/agent-skills@web-design-guidelines

3. Figma Implement Design

npx -y skills add figma/mcp-server-guide@implement-design

4. UI/UX Pro Max

npx -y skills add nextlevelbuilder/ui-ux-pro-max-skill@ui-ux-pro-max