Skip to content

README.md

Latest commit

 

History

History
161 lines (118 loc) · 4.99 KB

README.md

File metadata and controls

161 lines (118 loc) · 4.99 KB

@affanmomin/agent-workspace

🤖 Intelligent AI Agent Framework Distribution

Distribute customizable AI agent configurations to your projects. Get the right agents, skills, and workflows based on your project type—frontend, backend, mobile, or any of 9 supported types.

npm version License: MIT npm downloads

🚀 Quick Start

npx @affanmomin/agent-workspace init

That's it! Interactive prompts will guide you through setup.

✨ Features

  • 🎯 Interactive CLI - Vite-style user experience
  • 🔧 9 Project Types - Frontend, Backend, Mobile, Full-Stack, Desktop, CLI, Extension, Game, Monorepo
  • 🎨 Smart Filtering - Only relevant agents and skills for your project
  • ⚙️ Custom Rules - Enforce company standards via .agent-config.json
  • 🔄 Easy Updates - npx @affanmomin/agent-workspace update
  • 🧠 Conventional Commits - Supports npm run commit for standardized messages
  • 🏷️ Semantic Versioning - Automated releases with changelog generation

🤔 Why Use This?

Problem: Setting up AI agent configurations manually is time-consuming and error-prone. You end up with:

  • ❌ Irrelevant agents for your project type
  • ❌ Bloated configurations with unnecessary skills
  • ❌ No way to enforce company coding standards
  • ❌ Manual updates when the framework changes

Solution: @affanmomin/agent-workspace automatically:

  • ✅ Installs only the agents and skills you need
  • ✅ Filters content based on your project type
  • ✅ Enforces your custom rules via AI
  • ✅ Updates with a single command while preserving your settings

Result: Get AI-powered development assistance tailored to your exact needs in under 30 seconds.

🎯 Project Types

Type Agents Skills Best For
Frontend 13 24 React, Next.js, Vue
Backend 13 22 Node.js, Python APIs
Mobile 12 19 React Native, Flutter
Full-Stack 15 26 Complete web apps
Monorepo 20 36 Multi-project workspaces

Plus: Desktop, CLI, Extension, Game

⚙️ Configuration

Customize via .agent-config.json:

{
  "projectType": "backend",
  "customRules": {
    "additionalRules": "Use Express.js. PostgreSQL database. JWT auth."
  },
  "includedSkills": ["python-patterns"]
}

Custom rules are enforced by the AI - no manual configuration needed.

💡 Example

# Initialize frontend project
npx @affanmomin/agent-workspace init --type frontend

# Update existing project
npx @affanmomin/agent-workspace update

📦 What Gets Installed

.
├── .agent-config.json          # Your project configuration
└── .agent/
    ├── ARCHITECTURE.md         # System overview
    ├── agents/                 # Specialist agents (filtered)
    ├── skills/                 # Specialist skills (filtered)
    ├── workflows/              # Interactive workflows
    ├── rules/
    │   └── GEMINI.md          # Global AI rules
    └── scripts/               # Validation scripts

🔗 Links

Made with ❤️ by Affan Momin

Open source and free forever.

☕ Support This Project

If you find this helpful, consider supporting my work!

Buy Me A Coffee

Buy Me A Coffee QR Code
Buy Me A Coffee

Support via OnlyChai (UPI)

OnlyChai QR Code
OnlyChai ✨