maestro-bundle

One command. Full context for your AI agent. Any editor.

npx maestro-bundle ai-agents claude

The problem

AI agents (Claude Code, Cursor, Codex) are powerful, but without context they don't know your stack, your standards, or what the application does. The result is vibing code — code with no direction and no consistency.

The solution: layered context

maestro-bundle installs context layers that make the agent work like a senior dev who knows the project:

  PRD.md        → WHAT to build (requirements, user stories, API spec)
  AGENTS.md     → HOW to build (stack, architecture, conventions)
  Skills        → WITH WHAT to build (RAG, clean arch, testing, deploy...)
  Spec Kit      → IN WHAT ORDER to build (spec → plan → tasks → implement)

Two modes

Full mode (with SDD)

Includes everything above — the agent follows Specification-Driven Development via GitHub Spec Kit. New features go through /speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement before any code is written.

npx maestro-bundle ai-agents claude

Lightweight mode (--no-sdd)

Skips Spec Kit entirely. Installs only AGENTS.md, skills, and PRD.md. The agent still knows your stack and patterns, but won't enforce the SDD process. Faster for smaller projects or when you just want good defaults without the ceremony.

npx maestro-bundle ai-agents claude --no-sdd

	Full mode	--no-sdd
AGENTS.md	✅	✅
Skills	✅	✅
PRD.md template	✅	✅
LangChain Skills (AI bundles)	✅	✅
GitHub Spec Kit	✅	❌
/speckit.* commands	✅	❌
Anti-vibing code enforcement	✅	❌

Available bundles

Bundle	Project type	Stack
ai-agents	Multi-agent AI systems	Python, LangChain, LangGraph, FastAPI, pgvector
ai-agents-deep	Deep Agent (Claude Code-like)	Python, Deep Agents SDK, LangGraph, Subagents
jhipster-monorepo	JHipster monolithic app	Java 21, Spring Boot, Angular, PostgreSQL
jhipster-microservices	JHipster microservices	Java 21, Spring Boot, Kafka, Consul, K8s
data-pipeline	Data & ML pipeline	Python, Pandas, Scikit-learn, MLflow
frontend-spa	Frontend SPA	React, TypeScript, Tailwind, Vite

npx maestro-bundle ai-agents claude
npx maestro-bundle ai-agents claude --no-sdd
npx maestro-bundle ai-agents-deep cursor
npx maestro-bundle jhipster-monorepo claude
npx maestro-bundle jhipster-microservices codex
npx maestro-bundle data-pipeline copilot
npx maestro-bundle frontend-spa windsurf

Supported editors

Editor	Command	Where it installs
Claude Code	npx maestro-bundle <bundle> claude	CLAUDE.md + .claude/skills/
Cursor	npx maestro-bundle <bundle> cursor	AGENTS.md + .cursor/skills/
OpenAI Codex	npx maestro-bundle <bundle> codex	AGENTS.md + .agents/skills/
GitHub Copilot	npx maestro-bundle <bundle> copilot	.github/copilot-instructions.md
Windsurf	npx maestro-bundle <bundle> windsurf	.windsurfrules
All	npx maestro-bundle <bundle> all	All of the above in the same repo

What happens

Full mode

$ npx maestro-bundle ai-agents claude

  ✔ Claude Code: AGENTS.md, CLAUDE.md, 14 skills in .claude/skills/
  ✔ PRD.md template installed
  ✔ 11 LangChain Skills installed
  ✔ specify-cli v0.4.3 installed
  ✔ Spec Kit initialized (/speckit.* commands available)
  ✔ Bundle constitution integrated

  Next steps:
    1. Fill in PRD.md with your product requirements
    2. Open the project in your AI editor
    3. Use /speckit.specify to start your first feature

Lightweight mode

$ npx maestro-bundle ai-agents claude --no-sdd

  ✔ Claude Code: AGENTS.md, CLAUDE.md, 14 skills in .claude/skills/
  ✔ PRD.md template installed
  ✔ 11 LangChain Skills installed
  ℹ Spec Kit skipped. Using AGENTS.md + skills only.

  Next steps:
    1. Fill in PRD.md with your product requirements
    2. Open the project in your AI editor and start coding

Project structure

Full mode

your-project/
├── CLAUDE.md                    # Points to AGENTS.md
├── AGENTS.md                    # Stack, standards, conventions
├── PRD.md                       # Product requirements (fill this in!)
├── .claude/
│   ├── skills/                  # Agent capabilities
│   │   ├── rag-pipeline/
│   │   ├── clean-architecture/
│   │   └── ...
│   └── commands/                # /speckit.* commands
│       ├── speckit.specify.md
│       ├── speckit.plan.md
│       └── speckit.implement.md
├── .specify/                    # Spec Kit (specs, plans, tasks)
└── references/

Lightweight mode (--no-sdd)

your-project/
├── CLAUDE.md                    # Points to AGENTS.md
├── AGENTS.md                    # Stack, standards, conventions
├── PRD.md                       # Product requirements (fill this in!)
├── .claude/
│   └── skills/                  # Agent capabilities
│       ├── rag-pipeline/
│       ├── clean-architecture/
│       └── ...
└── references/

AGENTS.md vs PRD.md vs Skills

File	Who writes it	What it contains
AGENTS.md	Bundle (automatic)	HOW to build — stack, patterns, conventions, git flow
PRD.md	Analyst / Dev	WHAT to build — requirements, user stories, API spec
Skills	Bundle (automatic)	WITH WHAT — specific capabilities the agent loads on-demand

LangChain Skills (AI bundles)

The ai-agents and ai-agents-deep bundles automatically install the 11 official LangChain skills covering LangChain, LangGraph, and Deep Agents.

Prerequisites

• Node.js 18+
• Git
• uv or pip (for Spec Kit — only needed in full mode, installed automatically)

Links

• AGENTS.md — Universal standard for AI agent instructions
• GitHub Spec Kit — Specification-Driven Development
• LangChain Skills — Official LangChain skills
• Agent Skills — Open standard for agent skills