Skip to main content

Quick Start

Install JARFIS and run your first AI-driven software development workflow with 11 specialized agents and structured phases.

Last updated: Sun Mar 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Ship software with AI — one slash command, eleven expert agents, structured phases with human gates.

Prerequisites

Before you begin, ensure you have:

  • Claude Code (Anthropic) — JARFIS runs natively inside Claude Code as a slash command workflow
  • A Claude account with API access
  • Git >= 2.x (for branch management in Phase 0)
  • The JARFIS GitHub repository cloned or accessible

Installation

JARFIS is installed via the install.sh script from the GitHub repository. Run the following in your terminal:

bash install.sh

Note: There is no /jarfis:install command. Installation is done exclusively through bash install.sh.

Run Your First Workflow

Open Claude Code in your project directory and start a workflow:

/jarfis:work Build a user authentication system with JWT tokens

JARFIS will classify your request (Phase T — Triage) and then guide you through structured phases, each handled by specialized AI agents.

The 9 Phases

Every workflow progresses through up to 9 phases. Phases may be skipped when not applicable (e.g., Phase 3 is skipped if no UI is needed):

T
Triage
Request classification into A/B/C types
0
Pre-flight
Git sync, branch creation, learning files loaded
1
Discovery
PO reverse-questions, Working Backwards, PRD, feasibility
Gate 1
Approve / Revise / Abort
2
Architecture & Planning
Impact analysis, design, API spec, task breakdown, test strategy
3
UX Design
Screen design, SVG assets, design tokens (conditional — only when UI is needed)
Gate 2
Approve / Revise / Abort
4
Implementation
BE/FE/DevOps parallel implementation
4.5
Operational Readiness
Deployment strategy, rollback plan, ops readiness
5
Review & QA
API contract verification, Tech Lead + QA + Security reviews
Gate 3
Approve / Revise & re-review / Abort / Revisit design
6
Retrospective
Learning accumulation (global learnings + project context)

The 11 Agents

JARFIS orchestrates 11 specialized agents, each activated only when relevant:

PO
Product Owner
Reverse-questions, Working Backwards, PRD authoring
AR
Architect
Feasibility evaluation, impact analysis, architecture design, ADR
TL
Tech Lead
API spec review, task breakdown, code review, retrospective
UX
UX Designer
Screen design, interaction design, SVG asset creation, design tokens
BE
Backend Engineer
Backend implementation
FE
Frontend Engineer
Frontend implementation
DO
DevOps/SRE
Infrastructure and CI/CD implementation
QA
QA Engineer
Test strategy, QA verification
SE
Security Engineer
Pre-review security analysis, security review
ADV
Advocate
Argues for proposed solutions, defends trade-off decisions
CRT
Critic
Challenges assumptions, identifies risks and weaknesses

Human Gates

JARFIS includes 3 gates where your explicit approval is required before proceeding:

Gate 1 — After Phase 1 (Discovery)
Review the PRD, feasibility analysis, and scope before architecture begins.
ApproveReviseAbort
Gate 2 — After Phase 2 & 3 (Architecture + UX)
Review architecture decisions, API specs, task breakdown, and UX designs before implementation.
ApproveReviseAbort
Gate 3 — After Phase 5 (Review & QA)
Final quality gate before retrospective. Review all code, tests, and security findings.
ApproveRevise & re-reviewAbortRevisit design

Next Steps