automagik-dev/genie
Wishes in, PRs out. CLI agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.
What it solves
Genie provides a planning-and-execution layer for AI coding agents, transforming a single-sentence request into a structured development process. It solves the problem of fragmented AI coding by introducing a rigorous workflow of brainstorming, design, planning, and independent review, ensuring that the final output meets specific acceptance criteria before being merged.
How it works
Genie uses a combination of plain-markdown documents stored in git (for wishes, designs, and brainstorms) and a single per-repository SQLite database (for tasks, boards, and execution state). It operates as a lightweight CLI that requires no background daemons or heavy databases.
When a user invokes a skill, Genie coordinates the process: it interviews the user to create a design, turns that design into a scoped "wish" with execution groups, and then dispatches the active AI agent's native subagents to build the feature in parallel. To ensure quality, it employs an independent review process where a reviewer subagent—distinct from the engineer subagent—must provide a verdict (SHIP, FIX-FIRST, or BLOCKED) based on the wish criteria.
Who it’s for
It is designed for developers using AI coding agents (such as Claude Code, Codex, Goose, or Windsurf) who want a more structured, professional software engineering lifecycle than simple prompting.
Highlights
- Structured Workflow: Implements a strict sequence:
brainstorm→design review→wish→plan review→work→implementation review. - Agent Agnostic: Delivers skills to multiple agent homes (Claude Code, Codex, Goose, Windsurf) using a runtime-neutral delegation contract.
- Lightweight State: Uses a single SQLite file and git-based markdown files; no resident processes or external database servers are required.
- Independent Review: Enforces a separation between the agent that writes the code and the agent that reviews it.
- WhatsApp Integration: Includes an "Omni" bridge allowing users to handle approvals and one-shot tasks via WhatsApp.
Related
- Project
- Project
- Project
- Project
- Project