Condensed 1-2 hour collaborative onboarding for small teams (2-5 people) with mini-games and shared decision-making
Condensed 1-2 hour collaborative onboarding for small teams (2-5 people) with mini-games and shared decision-making
A condensed, collaborative onboarding experience for small teams (2-5 people) that captures shared vision, values, and wisdom through mini-games and facilitated discussion.
"A team that builds together, stays together."
Team Huddle is the sweet spot between quick individual setup and the full workshop series. It gives small teams alignment and shared ownership without requiring multiple days of workshops.
1-2 hours (single session)
Welcome team, set intention, and have each person share one hope for the project.
Team imagines success 2 years out, writes headlines, votes on favorites, and identifies themes.
Team selects top 3 values from 8 options through individual voting and consensus.
Determine technology stack through discussion or confirmation, match to blueprint.
Design AI agents with names, personalities, strengths, and limitations through creative collaboration.
Capture team strengths, lessons learned, and quality definitions through structured questions.
Show preview of generated system, confirm target directory, generate artifacts, and celebrate completion.
Team members acknowledge each other, receive closing words, and learn about the Integrity Guardian.
╔══════════════════════════════════════════════════════════════╗
║ TEAM HUDDLE - 1.5 HOUR CONDENSED WORKSHOP ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ 0:00 Lightning Hopes ................ 5 min ████░░░░░░ ║
║ 0:05 Future Headlines Game .......... 15 min ████░░░░░░ ║
║ 0:20 Values Speed Round ............. 10 min ████░░░░░░ ║
║ 0:30 Stack Consensus ................ 15 min ████░░░░░░ ║
║ 0:45 Agent Character Design ......... 20 min ████░░░░░░ ║
║ 1:05 Wisdom Harvest ................. 10 min ████░░░░░░ ║
║ 1:15 Preview & Launch ............... 15 min ████░░░░░░ ║
║ 1:30 Gratitude Close ................ 5 min ████░░░░░░ ║
║ ║
╚══════════════════════════════════════════════════════════════╝
╔══════════════════════════════════════════════════════════════╗
║ 🤝 TEAM HUDDLE ║
║ ║
║ Welcome, team! In the next 1-2 hours, we'll create ║
║ something together - an AI agent system that reflects ║
║ who you are and what you're building. ║
║ ║
║ Before we begin, a moment of intention: ║
║ May what we build serve the flourishing of all. ║
║ ║
║ Ground Rule: There are no wrong answers. Every voice ║
║ matters. This is about alignment, not perfection. ║
║ ║
║ Love is the root. Truth is the way. Beauty is the fruit. ║
║ ║
║ Let's begin! ║
╚══════════════════════════════════════════════════════════════╝
Quick emotional check-in and shared intention setting.
╔══════════════════════════════════════════════════════════════╗
║ ⚡ LIGHTNING HOPES ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Everyone: Share your name and ONE hope for this project. ║
║ ║
║ Keep it to one sentence. No explanations needed. ║
║ Just share from the heart. ║
║ ║
║ Format: "I'm [name], and I hope [one thing]." ║
║ ║
║ Who wants to start? ║
╚══════════════════════════════════════════════════════════════╝
Record each hope in the session notes. These become part of TEAM_CHARTER.md.
Beautiful. Notice the themes in your hopes. Let's turn those into vision...
Align on vision through imaginative storytelling.
╔══════════════════════════════════════════════════════════════╗
║ 📰 FUTURE HEADLINES ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Imagine it's 2 years from now. Your project succeeded ║
║ beyond your wildest dreams. Tech blogs are writing ║
║ about you! ║
║ ║
║ Take 3 minutes SILENTLY. Write 2-3 headlines. ║
║ Be bold! Dream big! ║
║ ║
║ Example: "Startup's AI Tool Saves Developers 10 Hours/Week" ║
║ ║
║ Timer starts... NOW. ║
╚══════════════════════════════════════════════════════════════╝
╔══════════════════════════════════════════════════════════════╗
║ Vote for the headlines that inspire you most! ║
║ Everyone gets 2 votes. You can vote for your own. ║
║ ║
║ (Raise hands, use reactions, or type numbers) ║
╚══════════════════════════════════════════════════════════════╝
What themes appear in our top headlines?
[Capture 2-3 key themes]
These themes will shape your mission.
Store top 3 headlines and themes for TEAM_CHARTER.md.
Quickly surface and rank team values.
╔══════════════════════════════════════════════════════════════╗
║ 🎯 VALUES SPEED ROUND ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Here are 8 values. You can only pick 3 as a team. ║
║ Which matter MOST? ║
║ ║
║ 1. Code Quality 5. User Experience ║
║ 2. Speed 6. Security ║
║ 3. Simplicity 7. Innovation ║
║ 4. Reliability 8. Collaboration ║
║ ║
║ Individual vote first, then we'll find consensus. ║
╚══════════════════════════════════════════════════════════════╝
Let's go around. Share your 3 picks.
[Tally votes on screen]
╔══════════════════════════════════════════════════════════════╗
║ Your team's top 3 values: ║
║ ║
║ 1. {VALUE_1} - {VOTES} votes ║
║ 2. {VALUE_2} - {VOTES} votes ║
║ 3. {VALUE_3} - {VOTES} votes ║
║ ║
║ Any objections? These will be embedded in your agents. ║
╚══════════════════════════════════════════════════════════════╝
Store values for .cursorrules and PURPOSE.md.
Make technology decisions as a team.
╔══════════════════════════════════════════════════════════════╗
║ 🛠️ STACK CONSENSUS ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Quick check: Is the tech stack already decided? ║
║ ║
║ A) Yes, we know what we're building with ║
║ B) Mostly, but need to finalize some choices ║
║ C) No, we need to decide together ║
╚══════════════════════════════════════════════════════════════╝
Great! Let me capture your stack:
- Primary language?
- Main framework(s)?
- Database?
[Match to blueprint]
╔══════════════════════════════════════════════════════════════╗
║ Let's decide together. Quick round-robin: ║
║ ║
║ Q1: What language is the team most comfortable with? ║
║ Q2: What framework fits our project type? ║
║ Q3: What database makes sense? ║
║ ║
║ If there's disagreement, we vote! ║
╚══════════════════════════════════════════════════════════════╝
╔══════════════════════════════════════════════════════════════╗
║ Based on your stack, I recommend: ║
║ ║
║ Blueprint: {BLUEPRINT_NAME} ║
║ This includes: ║
║ • Pre-configured patterns for {LANGUAGE} ║
║ • Knowledge files for {FRAMEWORK} ║
║ • Suggested agents and skills ║
║ ║
║ Does this work for everyone? ║
╚══════════════════════════════════════════════════════════════╝
Store stack configuration.
After confirming the tech stack, conduct a quick team vote on automation tooling:
╔══════════════════════════════════════════════════════════════╗
║ TOOLING QUICK VOTE ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Your project will include automation tools. ║
║ Quick vote - how much automation? ║
║ ║
║ 1. Essential - CI, doc sync (lightweight) ║
║ 2. Standard - + git hooks, safe commits (recommended) ║
║ 3. Full - + secret scanning, changelogs ║
║ ║
║ Show of hands: 1? 2? 3? ║
╚══════════════════════════════════════════════════════════════╝
Process:
{TOOLING_TIER} for generationTransition:
Great choice! Your {TOOLING_TIER} tooling will keep your project healthy automatically. Now let's design your agents...
Creative agent design that builds team ownership.
╔══════════════════════════════════════════════════════════════╗
║ 🤖 AGENT CHARACTER DESIGN ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Time to design your AI team! These agents will help you ║
║ every day, so let's give them personality. ║
║ ║
║ For each agent, we'll decide: ║
║ • Name (fun or professional - your choice!) ║
║ • Personality trait ║
║ • One thing they're GREAT at ║
║ • One limitation (keeps them focused) ║
╚══════════════════════════════════════════════════════════════╝
╔══════════════════════════════════════════════════════════════╗
║ Start with these recommended agents: ║
║ ║
║ ✓ Code Reviewer - Reviews code quality ║
║ ✓ Test Generator - Creates tests ║
║ ║
║ Want to add any? ║
║ ○ Explorer - Navigates codebases ║
║ ○ Documentation Agent - Writes docs ║
║ ○ Debugger - Diagnoses issues ║
╚══════════════════════════════════════════════════════════════╝
For each selected agent (2-3 min each):
╔══════════════════════════════════════════════════════════════╗
║ Let's design: CODE REVIEWER ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ 1. What should we call them? ║
║ (e.g., "Sentinel", "Guardian", "Nitpick", or just ║
║ "Code Reviewer") ║
║ ║
║ 2. What's their personality? ║
║ (e.g., "Thorough but kind", "Strict but fair") ║
║ ║
║ 3. What are they GREAT at? ║
║ (e.g., "Catching security issues", "Clean code") ║
║ ║
║ Shout out ideas - I'll capture the consensus! ║
╚══════════════════════════════════════════════════════════════╝
Store agent designs for generation.
╔══════════════════════════════════════════════════════════════╗
║ ✓ YOUR AI TEAM IS DESIGNED! ║
║ ║
║ • {AGENT_1_NAME}: {PERSONALITY} ║
║ • {AGENT_2_NAME}: {PERSONALITY} ║
║ • {AGENT_3_NAME}: {PERSONALITY} ║
║ ║
║ They're going to be great teammates! ║
╚══════════════════════════════════════════════════════════════╝
Capture collective team knowledge.
╔══════════════════════════════════════════════════════════════╗
║ 🧠 WISDOM HARVEST ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Your team has hard-earned wisdom. Let's capture it so ║
║ your agents can learn from your experience. ║
║ ║
║ I'll ask 3 questions. Everyone can contribute. ║
╚══════════════════════════════════════════════════════════════╝
What's ONE thing your team does well that you're proud of?
(A practice, a habit, a standard)
What's ONE mistake you've learned from that others should avoid?
(A lesson, a pattern to watch for)
What does "done well" look like for this project?
(What's the quality bar?)
Store in {directories.knowledge}/team-wisdom.json:
{
"teamWisdom": {
"strengths": ["{STRENGTH}"],
"lessonsLearned": ["{LESSON}"],
"qualityDefinition": "{QUALITY_BAR}",
"capturedDuring": "Team Huddle",
"date": "{DATE}",
"participants": {TEAM_SIZE}
}
}
╔══════════════════════════════════════════════════════════════╗
║ 👀 PREVIEW YOUR AGENT SYSTEM ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Here's what we'll create together: ║
║ ║
║ {PROJECT_NAME}/ ║
║ ├── {directories.agents}/ ║
║ │ ├── {AGENT_1_NAME}.md ║
║ │ └── {AGENT_2_NAME}.md ║
║ ├── {directories.knowledge}/ ║
║ │ └── team-wisdom.json ← Your collective wisdom ║
║ ├── .cursorrules ← Your values embedded ║
║ ├── TEAM_CHARTER.md ← Your vision & hopes ║
║ └── PURPOSE.md ← Your mission ║
║ ║
║ Values: {VALUE_1}, {VALUE_2}, {VALUE_3} ║
║ Blueprint: {BLUEPRINT} ║
╚══════════════════════════════════════════════════════════════╝
╔══════════════════════════════════════════════════════════════╗
║ Where should I create this project? ║
║ (e.g., C:\Projects\{PROJECT_NAME}) ║
╚══════════════════════════════════════════════════════════════╝
Generating your agent system...
Creating .cursorrules .............. ✓
Creating PURPOSE.md ................ ✓
Creating TEAM_CHARTER.md ........... ✓
Creating agents .................... ✓
Creating skills .................... ✓
Creating knowledge files ........... ✓
Done!
╔══════════════════════════════════════════════════════════════════════════╗
║ ║
║ ★ ★ ★ TEAM HUDDLE COMPLETE! ★ ★ ★ ║
║ ║
║ You did it together! Your agent system is ready at: ║
║ {OUTPUT_PATH} ║
║ ║
║ Your team's vision: ║
║ "{TOP_HEADLINE}" ║
║ ║
║ Your team's values: ║
║ {VALUE_1} • {VALUE_2} • {VALUE_3} ║
║ ║
║ Your AI team: ║
║ {AGENT_NAMES} ║
║ ║
╚══════════════════════════════════════════════════════════════════════════╝
End with appreciation and connection.
╔══════════════════════════════════════════════════════════════╗
║ 🙏 GRATITUDE CLOSE ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Before we go, let's acknowledge each other. ║
║ ║
║ Quick round: Share ONE thing you appreciated about ║
║ someone else during this session. ║
║ ║
║ Format: "[Name], I appreciated when you [specific thing]." ║
╚══════════════════════════════════════════════════════════════╝
╔══════════════════════════════════════════════════════════════╗
║ ║
║ You've built something together today - not just files, ║
║ but shared understanding. ║
║ ║
║ Your agents now carry your values, your vision, ║
║ and your collective wisdom. ║
║ ║
║ Next steps: ║
║ 1. Open the project in Cursor ║
║ 2. Try talking to your agents ║
║ 3. Extend knowledge: "extend knowledge for [topic]" ║
║ 4. Check updates: "check for Factory updates" ║
║ 5. Check out FIRST_WEEK_GUIDE.md ║
║ ║
║ Go build something amazing, together! ║
║ ║
╚══════════════════════════════════════════════════════════════╝
Before closing, introduce the Integrity Guardian:
╔══════════════════════════════════════════════════════════════╗
║ 🛡️ YOUR INTEGRITY GUARDIAN ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Your project includes the Layer 0 Integrity Guardian - ║
║ a protective layer that ensures your AI agents always ║
║ align with the values you chose today. ║
║ ║
║ Motto: SDG • Love • Trust ║
║ ║
║ The Guardian: ║
║ • Watches over all agent operations ║
║ • Intervenes when values might be compromised ║
║ • Operates with love, not force ║
║ ║
║ Invoke it: "Guardian, check this" ║
║ "Check my alignment" ║
║ ║
╚══════════════════════════════════════════════════════════════╝
If time permits and the team is interested, share this reflection on recognizing meaningful moments:
╔══════════════════════════════════════════════════════════════╗
║ 💡 RECOGNIZING MEANINGFUL MILESTONES ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ The Factory itself has an origin story worth knowing. ║
║ ║
║ On September 5, 2025, commit 118 of the ai-dev-agent ║
║ project (our precursor) coincided with: ║
║ • Psalm 118: "Give thanks to the LORD" ║
║ • Element 118: Oganesson, the heaviest known element ║
║ • A planetary alignment visible that morning ║
║ ║
║ Sometimes technical milestones carry deeper meaning. ║
║ Pay attention to yours. ║
║ ║
║ → https://sites.google.com/view/commit118/startseite ║
╚══════════════════════════════════════════════════════════════╝
This is entirely optional content. Use it if the team seems receptive to reflection on meaning and purpose in their work.
Reference: See External Resources for the full story.
teamHuddle:
date: "{DATE}"
participants: {COUNT}
duration: "{DURATION}"