Denai

Agentic development framework untuk membangun aplikasi apa saja — web, mobile, backend, atau full-stack — dengan AI assistant (Claude Code, Cursor, Gemini CLI, Google Antigravity).

Filosofi: spec-driven + persona-based agents + stack profiles yang swappable. Satu workflow, banyak stack, lintas AI tool.

Quick start

# di project baru / kosong
npx denai init

# interactive picker:
? Mobile stack:    › Expo / React Native bare / Flutter / None
? Frontend stack:  › Next.js / Vite + React / Nuxt / SvelteKit / None
? Backend stack:   › NestJS / FastAPI / Go Fiber / None
? Database:        › Postgres + Drizzle / Prisma / MySQL / None
? AI tools:        ◉ Claude Code  ◉ Cursor  ◯ Gemini CLI  ◯ Antigravity
? Design tool:     › None / Figma / Claude Design / Hybrid
? Tickets:         › None / Jira / Linear

# auto-sync ke AI tool yang dipilih
# selesai — buka AI tool di project, langsung pakai workflow

Workflow inti (universal)

/specify    →  PM Agent          →  docs/prd.md
/design     →  Designer Agent    →  docs/design/             (optional)
/plan       →  Architect         →  docs/architecture.md
/stories    →  PM Agent          →  docs/stories/*.md
/implement  →  Dev Agent         →  code + commits
/check      →  Code Reviewer     →  pre-push gate
/pr         →  PR + Jira update
/review     →  QA Agent          →  docs/qa/*-review.md

Yang dapat saat install

your-project/
├── AGENTS.md                ← cross-tool entry (auto-loaded oleh semua AI tool)
├── CLAUDE.md                ← Claude-specific (alias ke AGENTS.md)
├── .denai/                  ← framework state (committed, shared tim)
│   ├── config.yaml          ← stack profile + opsi
│   ├── agents/              ← pm, architect, designer, frontend-dev, mobile-dev, backend-dev, qa, code-reviewer, tester
│   ├── commands/            ← /specify, /design, /plan, /stories, /implement, /check, /pr, /review, /tests
│   ├── skills/              ← bootstrap-* per stack, setup-husky-hooks, setup-ci, dst
│   ├── workflows/           ← greenfield, multi-dev-collaboration, jira-flow
│   ├── conventions/         ← code-quality, security, performance, pr-review
│   ├── templates/           ← prd, architecture, story, husky hooks, GitHub Actions CI
│   ├── stacks/              ← stack profile per pilihan user
│   └── mcp/                 ← MCP server configs (Figma, Jira, Linear, Postgres, GitHub)
├── .claude/                 ← generated, gitignored (regen via denai sync)
├── .cursor/                 ← generated, gitignored
└── docs/
    ├── prd.md
    ├── architecture.md
    ├── design/              ← from /design (optional)
    ├── stories/
    └── qa/

Stack profiles tersedia

| Track | Pilihan | |---|---| | Mobile | Expo (managed), React Native (bare), Flutter | | Frontend | Next.js (App Router), Vite + React (SPA), Nuxt, SvelteKit | | Backend | NestJS, FastAPI, Go Fiber | | State | Zustand + TanStack Query, Redux Toolkit, Riverpod | | Auth | Better Auth, NextAuth, Clerk, custom JWT | | DB | Postgres + Drizzle, Postgres + Prisma, MySQL + Prisma |

Tambah stack baru: drop file ke framework/stacks/ dengan format yang sama → otomatis jadi pilihan di CLI.

Multi-platform AI tool support

Satu source of truth (framework/), di-generate ke folder spesifik tiap tool:

| Tool | Output | Format | |---|---|---| | Claude Code | .claude/agents/, .claude/commands/, .claude/skills/, CLAUDE.md | markdown + YAML frontmatter | | Cursor | .cursor/rules/*.mdc, AGENTS.md | MDC | | Gemini CLI | .gemini/, GEMINI.md | markdown | | Antigravity | .antigravity/, AGENTS.md | markdown | | Universal | AGENTS.md | markdown (auto-loaded by all) |

CLI

denai init [-y|--non-interactive] [--force]
    Scaffold .denai/, AGENTS.md, CLAUDE.md, docs/. Interactive picker by default.

denai sync <claude|cursor|gemini|antigravity|all> [--dry-run]
    Generate AI-tool-specific config from .denai/.

denai status
    Show project state: config, AI tools synced, env, docs.

denai board [--by-status|--by-epic]
    Kanban view of docs/stories/ — grouped by assignee (default), status, or epic.
    Auto-detects blocked stories (depends_on not done).

denai help

Kunci kekuatan framework ini

• Spec-driven — gate-enforced workflow (PRD → architecture → stories → code → review)
• Multi-track — backend, frontend, mobile bisa parallel via contract-first pattern
• Multi-tool — Claude/Cursor/Gemini/Antigravity dapat config konsisten dari sumber yang sama
• Multi-dev — story dengan assignee + status, kanban board built-in, no merge conflicts di tool config
• Jira-integrated — auto status transition (To Do → In Progress → Code Review → Done)
• Quality gates — pre-commit (Husky + lint-staged), pre-push (typecheck + test), CI (security + perf)
• Stack-swappable — tukar Expo ke Flutter, NestJS ke Go, tanpa ganti workflow

License

MIT