Public Roadmap for the Automagik Ecosystem

🗺️ Transparency, Ownership, Results-Driven
Strategic initiatives across Omni, Hive, Spark, Forge, Genie, and Tools
Track what we're building, why we're building it, and who's building it

Projects • How to Propose • Labels & Stages • Contributing • Documentation

---

🗺️ What is the Automagik Roadmap?

This repository is the single source of truth for strategic initiatives across the entire Automagik ecosystem. Think of it as:

• 📊 The Command Center: Where all projects align on priorities and timelines
• 🎯 The Context Repository: Strategic analysis (5w2h) and detailed wishes for each project
• 🤝 The Community Hub: Where stakeholders provide feedback and track progress
• 📈 The Progress Tracker: From Wishlist → Exploring → RFC (Proposal) → Prioritization → Executing → Preview → Shipped

💡 Why a Public Roadmap?

Transparency builds trust. Ownership drives results. Structure enables scale.

Before:

• ❌ Roadmap scattered across Slack, Notion, and individual heads
• ❌ Community asks "when will X be ready?" without visibility
• ❌ Cross-project dependencies create surprise blockers
• ❌ No clear ownership = things fall through the cracks

After (with this repo):

• ✅ Single place to see what's being built across all projects
• ✅ Clear RASCI ownership (Responsible, Accountable, Support, Consulted, Informed)
• ✅ Expected results tracked for every initiative
• ✅ Community can comment, vote, and contribute ideas
• ✅ Quarterly planning and review cadence

---

🚀 Projects

Project	Description	Repository	Context
Omni	Omnichannel messaging with MCP	automagik-omni	5w2h
Hive	Multi-agent orchestration	automagik-hive	5w2h
Spark	Cron system that sparks repos	automagik-spark	5w2h
Forge	AI-powered development orchestrator	automagik-forge	5w2h
Genie	Autonomous agent framework	automagik-genie	5w2h
Tools	MCP tools builder & marketplace	automagik-tools	5w2h

Each project folder contains:

• 5w2h.md - Strategic analysis (What, Why, Who, When, Where, How, How Much)
• wishes/ - Detailed initiative plans following the automagik-genie pattern
• README.md - Project overview with repository links

---

📊 View the Roadmap

🔗 View Project Board - Live project board with all initiatives

Quick Filters:

• 📅 All Initiatives
• 🚧 Executing
• 📋 Prioritization
• ✅ Shipped
• ⚡ This Quarter (Q4 2025)
• 🔥 High Priority

---

📋 How to Propose

Want to suggest something? We have different paths based on what you need:

🧞 Option 1: Make a Wish (Recommended for Feature Ideas)

Got an idea but not sure how to structure it? Use our simple wish form:

1. Make a Wish using the 🧞 Make a Wish template
2. Tell us:
   • What's your wish?
   • Why would it be useful? (optional)
   • Any additional context? (optional)
3. Submit → Gets wish:triage label, team will review and guide it forward ✨

Perfect for:

• 💡 Feature ideas
• 🎯 Improvement suggestions
• 🤔 "Wouldn't it be cool if..." thoughts
• 🚀 Quick submissions without formal structure

---

📋 Option 2: GitHub Issue Form (For Structured Initiatives)

Have a well-defined initiative ready? Use the formal template:

1. Create a new issue using the Initiative template
2. Fill in the form fields (project, description, RASCI, expected results)
3. Submit → Automatically added to project board ✨

🛠️ Option 3: CLI Script (For Maximum Detail)

Use our JSON script for fast, automated creation:

# Quick creation with JSON
cat << EOF | ./scripts/create-initiative-from-json.sh
{
  "title": "Your Initiative Title",
  "project": "omni",
  "stage": "Exploring",
  "priority": "high",
  "quarter": "2026-q1",
  "start_date": "2026-01-01",
  "target_date": "2026-03-31",
  "type": "feature",
  "areas": ["api", "performance"],
  "description": "One-line summary",
  "goals": ["Goal 1", "Goal 2", "Goal 3"]
}
EOF

# Auto-selects owner (genie/forge → namastex888, others → vasconceloscezar)
# All fields set automatically (~40s creation time)
# See: ./scripts/create-initiative-from-json.sh --help

Templates for detailed specs (optional):

• 📄 LEAN - Streamlined format (recommended)
• 📖 Template Guide - Decision tree, comparison, tips

Features:

• ✅ PRD-style structure (5W2H, BDD stories, personas)
• ✅ Automatic label application
• ✅ Direct project board field setting
• ✅ Retry logic for reliability

💬 Community feedback is welcome! Share your thoughts on any initiative.

---

🏷️ Labels & Stages

Development Stages

Our initiatives follow a structured lifecycle inspired by GitHub's public roadmap:

• 💡 Wishlist - Initial ideation and brainstorming
• 🔍 Exploring - Early investigation, validating the idea
• 💬 RFC - Request for Change, formal proposal and Go/No-Go decision
• 📋 Prioritization - Prioritization and planning phase
• 🔨 Executing - Active execution and implementation
• 🧪 Preview - Beta/preview release for testing
• ✅ Shipped - Generally available, live in production
• 📦 Archived - No longer active or deprioritized

Multi-Dimensional Labels

We use a 6-dimensional label system to organize initiatives:

Dimension	Examples	Purpose
Project	project:omni, project:hive	Which project(s) are involved
Stage	Exploring, Executing	Current development phase
Type	type:feature, type:research	Kind of initiative
Priority	priority:critical, priority:high	Urgency level
Quarter	quarter:2025-q4, quarter:2026-q1	Target timeframe
Area	area:api, area:mcp, area:agents	Technical domain

Total: ~40 labels across 6 dimensions for precise organization.

Wish Workflow Labels

For community-submitted feature ideas:

Label	Meaning	Usage
wish:triage	User wish pending team review	Auto-applied by Make a Wish template
wish:active	Wish approved and being worked on	Set by team during triage
wish:archived	Wish completed and archived	Auto-applied when PR merges

View complete label guide →

---

📚 Documentation

• Stage Definitions - Detailed criteria for each stage
• Label Guide - Complete label taxonomy and usage
• RASCI Guide - Ownership model for open source projects
• Wish Template - How to structure detailed initiatives
• Cross-Repo References - Linking initiatives across repos

---

📊 CSV Export

Weekly CSV exports are available in exports/ for stakeholder reporting and analysis.

Export format includes:

• Project, Initiative, Description
• Stage, Quarter, Priority
• Expected Results
• Owner, Created/Updated dates
• Links to issues and wish folders

Exports run automatically every Monday via GitHub Actions.

---

🤝 Contributing

We welcome community input on our roadmap!

How to contribute:

• 🧞 Make a wish for feature ideas (no technical knowledge needed!)
• 💬 Comment on issues to share feedback and ideas
• 🎯 Propose initiatives via structured templates
• 🔧 Submit PRs to project repos (link to issues for auto-labeling)
• 💡 Join discussions on our Discord

For Developers:

• All project repos have PR templates with issue linking
• Link PRs to issues using - Closes #X for automatic metadata inheritance
• Wish documents in .genie/wishes/ are auto-archived when PRs merge

See CONTRIBUTING.md for detailed guidelines.

---

⚖️ Disclaimer

This roadmap represents our current plans and priorities. Items may change based on:

• Community feedback and feature requests
• Technical constraints and dependencies
• Strategic shifts and market changes
• Resource availability and capacity

No dates or commitments are guaranteed. This is a living document that evolves with the ecosystem.

---

🔗 Links

• Discord: Join the community
• GitHub Org: @namastexlabs
• Documentation: docs.automagik.ai

---

📜 License

MIT License - See LICENSE

---

Built with transparency by Namastex Labs
Questions? Check our FAQ or reach out on Discord