Skip to content

d8n1z/agileshaman

Repository files navigation

🪬 Agile Shaman

🤖 100% AI-Generated Disclaimer: This entire repository was created through pure AI collaboration. No human developers were harmed (or employed) in the making of this game. The code, design, gameplay mechanics, and even this README were crafted by AI. What happens when you give an AI too much coffee and a passion for satirizing software development! ☕✨

Master the Ancient Arts of Software Delivery

A satirical card-based game where you play as the "Agile Shaman," balancing the mystical energies of software development while navigating the chaos of modern tech teams.

🎮 Game Overview

In Agile Shaman, you must guide your development team through 8 mystical sprints, making crucial decisions that affect four core energies:

  • ⚡ Flow of Code Spirits (Velocity) - Your team's delivery speed
  • 🧘 Harmony of Dev Tribe (Morale) - Developer happiness and energy
  • 🌟 Business Blessings (Customer Happiness) - Stakeholder satisfaction
  • 💀 Legacy Demons (Tech Debt) - Accumulated shortcuts and risks

Win Condition

Survive all 8 sprints and release the Legendary Unicorn Product 🦄

Lose Conditions

  • Velocity reaches 0 → Project fossilizes in eternal planning
  • Morale reaches 0 → Dev tribe scatters to the winds
  • Happiness reaches 0 → Business shamans banish you
  • Tech Debt reaches 100 → The monolith collapses into chaos

🃏 Gameplay

Each sprint, you'll face 3 mystical challenge cards with satirical scenarios like:

  • The Cursed Friday Deploy - Will you risk weekend peace for velocity?
  • The AI Prophecy - CEO demands everything becomes "AI-powered"
  • Awakening of the Legacy Beast - 47 bugs emerge from deprecated code

Make choices that affect your energy levels, with some having random ritual outcomes for extra excitement!

🎨 Theme & Design

"Ancient wisdom meets modern chaos"

  • Mystical aesthetic with deep purples, midnight blues, and golden accents
  • Tarot-inspired cards with floating animations and mystical glows
  • Satirical humor that any developer will recognize and appreciate
  • Responsive design works on desktop, tablet, and mobile

🚀 Tech Stack

  • React 18 with TypeScript for type safety
  • Vite for lightning-fast development
  • Tailwind CSS with custom mystical color palette
  • Modern hooks for state management
  • Zero dependencies - pure React goodness

🛠️ Development

Prerequisites

  • Node.js 18+
  • npm or yarn

Getting Started

# Clone the repository
git clone [your-repo-url]
cd agile-shaman

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

Project Structure

src/
├── components/
│   ├── game/           # Game-specific components
│   │   ├── GameBoard.tsx
│   │   ├── Card.tsx
│   │   ├── StatBar.tsx
│   │   └── SprintDiary.tsx
│   ├── ui/             # Reusable UI components
│   └── layout/         # Layout components
├── data/
│   ├── cards.ts        # Card definitions
│   └── gameConfig.ts   # Game configuration
├── hooks/
│   └── useGameState.ts # Main game logic
├── types/
│   └── game.ts         # TypeScript interfaces
└── utils/              # Utility functions

🎯 Features

Current Features

  • Card-based gameplay with 10+ unique scenarios
  • Rarity system - Common, Rare, and Legendary cards
  • RNG mechanics - Risk/reward ritual outcomes
  • Sprint diary - Chronicle of your decisions
  • Ancient rituals - Bonus actions for strategic play
  • Mystical animations - Floating cards and glowing effects
  • Responsive design - Works on all devices

Planned Features (v2)

  • Multiple difficulty modes - Apprentice to Arch-Shaman
  • New card packs - Remote Work Chaos, Enterprise Bureaucracy
  • Persistent progression - Unlock new cards and abilities
  • Multiplayer mode - Compete with other shamans
  • Achievement system - Unlock mystical badges
  • Sound effects - Enhance the mystical atmosphere

🌍 Internationalization

The game is structured for easy localization with the GameTexts interface. Future versions will support multiple languages while maintaining the satirical humor across cultures.

🎭 Satirical Scenarios

The game lovingly parodies common software development situations:

  • Friday afternoon deployments
  • Endless standup meetings
  • AI pivot mandates from leadership
  • Legacy code maintenance nightmares
  • Feature creep and scope changes
  • Production outages and blame games

🤝 Contributing

We welcome contributions! Whether it's:

  • New card scenarios
  • UI/UX improvements
  • Bug fixes
  • Localization
  • Documentation

Please open an issue or PR on GitHub.

📄 License

MIT License - Feel free to fork and create your own mystical variations!

🙏 Acknowledgments

Inspired by the daily chaos and occasional magic of software development teams everywhere. May your deployments be smooth and your standups be brief!


"The shaman who remembers the past controls the future" - Ancient DevOps Proverb

About

Agile Shaman is a satirical card-based sprint management survival game where players navigate the mystical arts of agile software development. Players guide their development team through 8 challenging sprints, balancing four critical aspects while dealing with chaos events and making strategic decisions.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors