genie

Genie Team

Specialized AI genies for product discovery and delivery, from opportunity mapping to spec-driven implementation.

Software teams face relentless pressure to deliver business outcomes while also building scalable systems. High costs, tight timelines, communication gaps, coordination overhead, and inconsistent practices across the team frame the challenges messy in the middle. AI coding agents promise help but often add noise; generating code without context, expanding scope without constraint, forgetting and drifting from decisions and guardrails already made.

What if your AI assistant was a team of specialists instead of one generalist? Genie Team brings industry practices, insight, and workflows to Claude Code. Curated wishes, focused expertise, and a document trail that builds shared understanding as things evolve over time. It's an experiment in whether structured AI collaboration can reduce friction, align practices, and help teams move faster without sacrificing craft and pride of ownership.

Table of Contents

• Philosophy & Vision
• Install
• Bootstrap a New Project
• Bootstrap an Existing Project
• Working with Genie Team
• Local Dev, CI/CD & Deployment
• The Genies
• Commands & Skills
• Structure
• Inspiration & Credits

---

Philosophy & Vision

The Aspiration

We're at an inflection point in how software gets made. AI assistants are powerful but unpredictable. They'll grant your wishes, just not always the way you intended. This project is an exploration: What if we could shape that power into something more deliberate?

Genie Team is a playground for discovering new ways of working. It's not a finished product but an ongoing harvesting of experiments in human-AI collaboration. This is an attempt to find patterns that make augmented development more effective, more sustainable, more intentional, more craft-oriented, and even a little fun.

Guiding Principles

Genies, not agents. AI coding assistants work best when you think of them as genies, powerful entities that grant wishes but interpret those wishes on their own terms. Without structure, they drift: expanding scope, losing context mid-session, and confidently building the wrong thing. Genie Team adds the constraints that make wishes reliable: specialized roles, scoped tools, structured prompts, and persistent context that survives the conversation window.

Team of specialists. Instead of one general purpose assistant, Genie Team provides a cast of specialized genies, each optimized for a specific phase of product development. Specialization beats generalization.

Context accumulates. Structured outputs (Opportunity Snapshots, Design Documents, Implementation Reports) create a document trail that builds project knowledge over time. Genie memory complements this with meta-learning: patterns noticed across sessions, calibrations, and shortcuts that help each genie work more effectively on your project.

Efficiency matters. AI tokens cost money and time. Structured prompts with clear scope reduce wasted iterations, hallucinated features, and context drift.

Tinkering as practice. This is exploratory work. Forking, adapting, and sharing configurations is part of our craft. The goal isn't to prescribe a workflow but to provide a starting point for your own experiments in augmented development.

---

1. Install

Prerequisites

• Claude Code CLI (v1.0.33+) — The foundation that genie-team extends
• gh CLI (optional) — For PR creation in PR-mode workflows
• jq (optional) — For the headless runner's JSON parsing

Script Install

git clone git@github.com:elmmly/genie-team.git ~/genie-team
cd ~/genie-team

# Install globally (available to all projects)
./install.sh global

# Or install to a specific project
./install.sh project /path/to/your/project

# Verify installation
./install.sh status

Global install puts commands, genies, skills, and rules in ~/.claude/ so they're available across all projects. Best for individual developers or teams with consistent practices.

Project install puts everything in /path/to/project/.claude/ for isolation. Best for trying out the workflow or when different projects need different configurations.

Plugin Install (Experimental)

Note: Plugin install is experimental. The Claude Code plugin system is still evolving, and plugin installs may not include all components. The script install above is the recommended approach.