Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@denagus007/denai) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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