{"_id":"@agent-forge/core","_rev":"7-415f13fdd9482e3e9acec57d24b2ca12","name":"@agent-forge/core","dist-tags":{"latest":"3.0.2"},"versions":{"1.3.0":{"name":"@agent-forge/core","version":"1.3.0","keywords":["ai","agents","orchestration","llm","typescript"],"author":"Your Name","license":"MIT","_id":"@agent-forge/core@1.3.0","maintainers":[{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"}],"dist":{"shasum":"106977c021adbe9b5e3dbe9284b978b8316c6214","tarball":"https://registry.npmjs.org/@agent-forge/core/-/core-1.3.0.tgz","fileCount":45,"integrity":"sha512-mAg1QuKbtot47+g7L5q/F9qo1DxPLZKuRTDujMPmK0MAexr5d/lHX/T3d2MG1zub2O7B+aloVjRbFflcXO9CLQ==","signatures":[{"sig":"MEUCIQDgKnUTUuXPek5oZPWAsGmx8eatPu2ZttjWaWIsYfexiAIgWFYsMsmHsNOVPPemNl1UrrVzOt8m8LZFw0vBBlq26C8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":248688},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"5b6fb8b89c2b04d3ed546951fdd617a1a4206ef2","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest","build":"tsc","clean":"rm -rf dist"},"_npmUser":{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"},"_npmVersion":"lerna/8.2.4/node@v22.17.1+x64 (win32)","description":"Core framework for AgentForge - AI Agent orchestration system","directories":{},"_nodeVersion":"22.17.1","dependencies":{"events":"^3.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.3.3","@types/node":"^20.10.0"},"peerDependencies":{"openai":"^4.20.0","@anthropic-ai/sdk":"^0.17.0"},"peerDependenciesMeta":{"openai":{"optional":true},"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/core_1.3.0_1761677423004_0.3482474077081448","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@agent-forge/core","version":"2.0.0","keywords":["ai","agents","orchestration","llm","typescript"],"author":"Your Name","license":"MIT","_id":"@agent-forge/core@2.0.0","maintainers":[{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"}],"dist":{"shasum":"995f341df27ecffc8badeaf8cd589aae66bb0135","tarball":"https://registry.npmjs.org/@agent-forge/core/-/core-2.0.0.tgz","fileCount":45,"integrity":"sha512-6IzW2kEOQ+s0n5j1HkxXQX3tygx3bU1Lp7qQ8R481kVVSTehEnqKYRMHfnh9xEoY9q6nkCTbOyAAv5kAVcRaMw==","signatures":[{"sig":"MEUCIEn+UCQjaDnNnVj6LTh92JKjN6iHFd1xqTLxcoVYyVRNAiEA7mkylHlk+sIBVSbT74pGHWamBgrhyJduGWlSSsD/C54=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":248698},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"0f1c30b2a10320539b3b6efde68e2cc7d68bc4c3","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest","build":"tsc","clean":"rm -rf dist"},"_npmUser":{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"},"_npmVersion":"lerna/8.2.4/node@v22.17.1+x64 (win32)","description":"Core framework for AgentForge - AI Agent orchestration system","directories":{},"_nodeVersion":"22.17.1","dependencies":{"events":"^3.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.3.3","@types/node":"^20.10.0"},"peerDependencies":{"openai":"^4.20.0","@anthropic-ai/sdk":"^0.17.0"},"peerDependenciesMeta":{"openai":{"optional":true},"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/core_2.0.0_1761678866854_0.03453929009687062","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@agent-forge/core","version":"2.1.0","keywords":["ai","agents","orchestration","llm","typescript"],"author":{"name":"Your Name"},"license":"MIT","_id":"@agent-forge/core@2.1.0","maintainers":[{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"}],"dist":{"shasum":"ffa9a8f44c80b4a1175f3dd49cc0efa24e103641","tarball":"https://registry.npmjs.org/@agent-forge/core/-/core-2.1.0.tgz","fileCount":106,"integrity":"sha512-Mvr2q8wBWIOEPjEfooofIP6r28n/n7PxYyjZT8kQJ0qJK8imbW/I4tSI2h8OZ3MCa4deRhjlVUh30Fda3XPCPQ==","signatures":[{"sig":"MEUCIQDxJEEtKnmyzkELe+q+AQcY6eAJ7tgcOSQAf6Gca09x+AIgGvleOko3V8d1c0Ad9469uniF/7qyvJ6kzHzfme7K2Ts=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":490238},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"8b79c2eba880de77029ea4beb83a7b99219d8f78","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest","build":"tsc","clean":"rimraf dist","minify":"terser dist/**/*.js --compress --mangle -d dist/ 2>/dev/null || echo 'Terser not available, skipping minification'","build:prod":"tsc && npm run minify","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"},"_npmVersion":"10.8.2","description":"Core framework for AgentForge - AI Agent orchestration system","directories":{},"_nodeVersion":"22.17.1","dependencies":{"events":"^3.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","vitest":"^1.0.0","typescript":"^5.3.3","@types/node":"^20.10.0"},"peerDependencies":{"openai":"^4.20.0","@anthropic-ai/sdk":"^0.17.0"},"peerDependenciesMeta":{"openai":{"optional":true},"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/core_2.1.0_1761733800410_0.2920470637579824","host":"s3://npm-registry-packages-npm-production"}},"2.1.2":{"name":"@agent-forge/core","version":"2.1.2","keywords":["ai","agents","orchestration","llm","typescript"],"author":"Your Name","license":"MIT","_id":"@agent-forge/core@2.1.2","maintainers":[{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"}],"dist":{"shasum":"d3c137587bc31d786d3d4d54c4afb0f23cdb6718","tarball":"https://registry.npmjs.org/@agent-forge/core/-/core-2.1.2.tgz","fileCount":106,"integrity":"sha512-5jVj2Q54ldRGEG2gj+wsMpVGZdeEOAe9YV6u/NX+eHuN0NvsSrFvK01EMEOPcruVQEcvv9jOmMV6AYUOm6vUmg==","signatures":[{"sig":"MEYCIQDVt/x8Pe9fbx+J9i50FQCyuDqAcTToRT7jXb0yLOBd6wIhAKQXQyw/UaZU9X2o+IYuBqEd2NKedKBn/IDFRTV6aj9K","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":490238},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"113b2aed8620321ae645bbc93f8d9ee2c9d1c5f2","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest","build":"tsc","clean":"rimraf dist","minify":"terser dist/**/*.js --compress --mangle -d dist/ 2>/dev/null || echo 'Terser not available, skipping minification'","build:prod":"tsc && npm run minify","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"},"_npmVersion":"lerna/8.2.4/node@v22.17.1+x64 (win32)","description":"Core framework for AgentForge - AI Agent orchestration system","directories":{},"_nodeVersion":"22.17.1","dependencies":{"events":"^3.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","vitest":"^1.0.0","typescript":"^5.3.3","@types/node":"^20.10.0"},"peerDependencies":{"openai":"^4.20.0","@anthropic-ai/sdk":"^0.17.0"},"peerDependenciesMeta":{"openai":{"optional":true},"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/core_2.1.2_1761734930978_0.17473760854779763","host":"s3://npm-registry-packages-npm-production"}},"3.0.0":{"name":"@agent-forge/core","version":"3.0.0","keywords":["ai","agents","automation","development","orchestration","typescript","framework","cursor","vscode","windsurf","bmad","ai-agents"],"author":{"name":"Hirun Chamara","email":"hirun-chamara"},"license":"MIT","_id":"@agent-forge/core@3.0.0","maintainers":[{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"}],"homepage":"https://github.com/XoAuraHiru/agent-forge#readme","bugs":{"url":"https://github.com/XoAuraHiru/agent-forge/issues"},"bin":{"agent-forge":"bin/agent-forge.js"},"dist":{"shasum":"a553267cdd4dbbe2961534c6fe0bb1518a5805da","tarball":"https://registry.npmjs.org/@agent-forge/core/-/core-3.0.0.tgz","fileCount":142,"integrity":"sha512-wTj27/k9cKtUsh1VxxhZmnzSGCgb3NvCAwLGjMFsiUWpaDVDQ23te8bIB5/EUAw/j+I0RRJ5LQfx5CoCHVCyxQ==","signatures":[{"sig":"MEQCIGlbDAjCGdi2/22HJ31tm1OwV5ZLAsTmaoqvsb+uo+RsAiAOk94Z48L5mKGqPbNSarOBZySjioZlpV/ZsSL7WHtWaQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1237192},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"npm":">=9.0.0","node":">=18.0.0"},"gitHead":"29cfc2537d7969eee1899b4efd23131d470a425b","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest","build":"npm run build:types && npm run build:webpack","clean":"rimraf dist tsconfig.tsbuildinfo","analyze":"webpack --profile --json > stats.json && echo 'Upload stats.json to https://webpack.github.io/analyse/'","sync:all":"npm run sync:support && npm run sync:bmad","build:dev":"tsc","sync:bmad":"node scripts/sync-from-bmad.js","build:prod":"npm run clean && npm run build:obfuscated && npm run sync:support && npm run generate:mdc","build:types":"tsc --emitDeclarationOnly","build:simple":"npm run build:types && webpack --config webpack.simple.config.js","generate:mdc":"node scripts/generate-mdc.js","sync:support":"node scripts/sync-support-files.js","build:webpack":"webpack --mode production","prepublishOnly":"npm run build:prod","build:obfuscated":"npm run build:types && webpack --config webpack.config.js"},"_npmUser":{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"},"repository":{"url":"git+https://github.com/XoAuraHiru/agent-forge.git","type":"git"},"_npmVersion":"10.8.2","description":"Professional AI Agent Development Framework for JavaScript/TypeScript","directories":{},"_nodeVersion":"22.17.1","dependencies":{"events":"^3.3.0","commander":"^11.1.0","bmad-method":"^4.44.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.54.0","rimraf":"^5.0.5","terser":"^5.24.0","vitest":"^1.0.0","webpack":"^5.102.1","ts-loader":"^9.5.4","typescript":"^5.3.3","@types/node":"^20.10.0","webpack-cli":"^6.0.1","@types/webpack":"^5.28.5","webpack-obfuscator":"^3.5.1","terser-webpack-plugin":"^5.3.14","@typescript-eslint/parser":"^6.13.0","@typescript-eslint/eslint-plugin":"^6.13.0"},"peerDependencies":{"openai":"^4.20.0","@anthropic-ai/sdk":"^0.17.0"},"peerDependenciesMeta":{"openai":{"optional":true},"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/core_3.0.0_1761755062363_0.4365811757264191","host":"s3://npm-registry-packages-npm-production"}},"3.0.1":{"name":"@agent-forge/core","version":"3.0.1","keywords":["ai","agents","automation","development","orchestration","typescript","framework","cursor","vscode","windsurf","bmad","ai-agents"],"author":{"name":"Hirun Chamara","email":"hirun-chamara"},"license":"MIT","_id":"@agent-forge/core@3.0.1","maintainers":[{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"}],"homepage":"https://github.com/XoAuraHiru/agent-forge#readme","bugs":{"url":"https://github.com/XoAuraHiru/agent-forge/issues"},"bin":{"agent-forge":"bin/agent-forge.js"},"dist":{"shasum":"96f5bee12d397117acb8bb63a6754e24fc99a6c1","tarball":"https://registry.npmjs.org/@agent-forge/core/-/core-3.0.1.tgz","fileCount":146,"integrity":"sha512-4wu6SXlpLMng+vh+zh/R8yDzS1xGJI7UQxzGtYzckHjTyhRsHh3xXVYG5gRU9vvZO0DpzAhUlnkAC/hlPOtzVQ==","signatures":[{"sig":"MEUCIQDpnL+8U8Y1+i5Q/CbCFyngrMyV0IN2YQ4P/uoHXkVRMgIgaIsbcWftfbXBw/vs93piCGZJE+0ibowNBlk/Pl6XJIM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1663215},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"npm":">=9.0.0","node":">=18.0.0"},"gitHead":"d2f09ecfb44059c3d6e279b736dc726de201fae1","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest","build":"npm run build:types && npm run build:webpack","clean":"rimraf dist tsconfig.tsbuildinfo","analyze":"webpack --profile --json > stats.json && echo 'Upload stats.json to https://webpack.github.io/analyse/'","sync:all":"npm run sync:support && npm run sync:bmad","build:dev":"tsc","sync:bmad":"node scripts/sync-from-bmad.js","build:prod":"npm run clean && npm run build:obfuscated && npm run sync:support && npm run generate:mdc","build:types":"tsc --emitDeclarationOnly","build:simple":"npm run build:types && webpack --config webpack.simple.config.js","generate:mdc":"node scripts/generate-mdc.js","sync:support":"node scripts/sync-support-files.js","build:webpack":"webpack --mode production","prepublishOnly":"npm run build:prod","build:obfuscated":"npm run build:types && webpack --config webpack.config.js"},"_npmUser":{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"},"repository":{"url":"git+https://github.com/XoAuraHiru/agent-forge.git","type":"git"},"_npmVersion":"10.8.2","description":"Professional AI Agent Development Framework for JavaScript/TypeScript","directories":{},"_nodeVersion":"22.17.1","dependencies":{"events":"^3.3.0","js-yaml":"^4.1.0","commander":"^11.1.0","bmad-method":"^4.44.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.54.0","rimraf":"^5.0.5","terser":"^5.24.0","vitest":"^1.0.0","webpack":"^5.102.1","ts-loader":"^9.5.4","typescript":"^5.3.3","@types/node":"^20.10.0","webpack-cli":"^6.0.1","@types/webpack":"^5.28.5","webpack-obfuscator":"^3.5.1","terser-webpack-plugin":"^5.3.14","@typescript-eslint/parser":"^6.13.0","@typescript-eslint/eslint-plugin":"^6.13.0"},"peerDependencies":{"openai":"^4.20.0","@anthropic-ai/sdk":"^0.17.0"},"peerDependenciesMeta":{"openai":{"optional":true},"@anthropic-ai/sdk":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/core_3.0.1_1761799297652_0.6244735923242402","host":"s3://npm-registry-packages-npm-production"}},"3.0.2":{"name":"@agent-forge/core","version":"3.0.2","description":"Professional AI Agent Development Framework for JavaScript/TypeScript","main":"dist/index.js","types":"dist/index.d.ts","bin":{"agent-forge":"bin/agent-forge.js"},"publishConfig":{"access":"public"},"scripts":{"build":"npm run build:types && npm run build:webpack","build:types":"tsc --emitDeclarationOnly","build:webpack":"webpack --mode production","build:simple":"npm run build:types && webpack --config webpack.simple.config.js","build:obfuscated":"npm run build:types && webpack --config webpack.config.js","build:dev":"tsc","build:prod":"npm run clean && npm run build:obfuscated && npm run sync:support && npm run generate:mdc","generate:mdc":"node scripts/generate-mdc.js","sync:bmad":"node scripts/sync-from-bmad.js","sync:support":"node scripts/sync-support-files.js","sync:all":"npm run sync:support && npm run sync:bmad","clean":"rimraf dist tsconfig.tsbuildinfo","dev":"tsc --watch","test":"vitest","lint":"eslint src --ext .ts","analyze":"webpack --profile --json > stats.json && echo 'Upload stats.json to https://webpack.github.io/analyse/'","prepublishOnly":"npm run build:prod"},"keywords":["ai","agents","automation","development","orchestration","typescript","framework","cursor","vscode","windsurf","bmad","ai-agents"],"dependencies":{"bmad-method":"^4.44.1","commander":"^11.1.0","events":"^3.3.0","js-yaml":"^4.1.0"},"devDependencies":{"@types/node":"^20.10.0","@types/webpack":"^5.28.5","@typescript-eslint/eslint-plugin":"^6.13.0","@typescript-eslint/parser":"^6.13.0","eslint":"^8.54.0","rimraf":"^5.0.5","terser":"^5.24.0","terser-webpack-plugin":"^5.3.14","ts-loader":"^9.5.4","typescript":"^5.3.3","vitest":"^1.0.0","webpack":"^5.102.1","webpack-cli":"^6.0.1","webpack-obfuscator":"^3.5.1"},"peerDependencies":{"@anthropic-ai/sdk":"^0.17.0","openai":"^4.20.0"},"peerDependenciesMeta":{"@anthropic-ai/sdk":{"optional":true},"openai":{"optional":true}},"engines":{"node":">=18.0.0","npm":">=9.0.0"},"repository":{"type":"git","url":"git+https://github.com/XoAuraHiru/agent-forge.git"},"author":{"name":"Hirun Chamara","email":"hirun-chamara"},"license":"MIT","_id":"@agent-forge/core@3.0.2","gitHead":"d2f09ecfb44059c3d6e279b736dc726de201fae1","bugs":{"url":"https://github.com/XoAuraHiru/agent-forge/issues"},"homepage":"https://github.com/XoAuraHiru/agent-forge#readme","_nodeVersion":"22.17.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-C0PLVyIbKk3Y7YAnqXZoHJQSEVsGpge5Bw+0jH0zInf/6hivJRAWOnf3OrEQ34dQUoRaJH1RsHwbdkO4WiPRlA==","shasum":"07d7de94434a5217bbc7b28668058c6023f14664","tarball":"https://registry.npmjs.org/@agent-forge/core/-/core-3.0.2.tgz","fileCount":146,"unpackedSize":1660323,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFZsBVEick+c/J4wtFhfIkct1rnAon+1re2nWpqfHGUUAiBU3DmszDkkgtEJsYYsBz+0t2UCwWuYBHD1b7tOuUuByg=="}]},"_npmUser":{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"},"directories":{},"maintainers":[{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/core_3.0.2_1761799560589_0.4412432673853357"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-28T18:50:22.923Z","modified":"2025-10-30T04:46:01.210Z","1.3.0":"2025-10-28T18:50:23.205Z","2.0.0":"2025-10-28T19:14:27.052Z","2.1.0":"2025-10-29T10:30:00.636Z","2.1.2":"2025-10-29T10:48:51.180Z","3.0.0":"2025-10-29T16:24:22.613Z","3.0.1":"2025-10-30T04:41:37.892Z","3.0.2":"2025-10-30T04:46:00.981Z"},"bugs":{"url":"https://github.com/XoAuraHiru/agent-forge/issues"},"author":{"name":"Hirun Chamara","email":"hirun-chamara"},"license":"MIT","homepage":"https://github.com/XoAuraHiru/agent-forge#readme","keywords":["ai","agents","automation","development","orchestration","typescript","framework","cursor","vscode","windsurf","bmad","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/XoAuraHiru/agent-forge.git"},"description":"Professional AI Agent Development Framework for JavaScript/TypeScript","maintainers":[{"name":"hirun-chamara","email":"astronomyhirunchamara@gmail.com"}],"readme":"# 🚀 AgentForge\r\n\r\n> **Professional AI Agent Development Framework for JavaScript/TypeScript**\r\n\r\nAgentForge is a production-ready framework for building autonomous AI agent teams that handle complex software development tasks. Built on modern JavaScript/TypeScript with enterprise-grade reliability and **support for multiple IDEs** (Cursor, VS Code, Windsurf).\r\n\r\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)\r\n\r\n---\r\n\r\n## ✨ Features\r\n\r\n- 🎯 **Multi-IDE Support** - Works with Cursor, VS Code, Windsurf, and any BMAD-compatible IDE\r\n- 📦 **Comprehensive Agent Bundles** - Self-contained agents with all dependencies embedded (20-140 KB per agent)\r\n- 🤖 **Specialized AI Agents** - Developer, QA, UX/UI, Architect, Security, Refactor, Product roles\r\n- 📝 **Automatic Documentation** - Agents generate docs in `docs/` (epics, wireframes, diagrams, architecture)\r\n- 🧠 **Intelligent Context Sharing** - Agents learn from documentation and each other's work\r\n- 📚 **Knowledge Base** - Automatic documentation indexing and intelligent retrieval\r\n- 🎨 **Pattern Library** - Built-in coding patterns and best practices\r\n- 🔄 **Intelligent Orchestration** - Coordinate multiple agents with parallel execution\r\n- 💾 **Advanced Memory System** - Vector and graph databases for agent learning\r\n- 📊 **Built-in Monitoring** - Real-time metrics, logging, and observability\r\n- 🔌 **Extensible Architecture** - Plugin system for GitHub, Jira, Slack integrations\r\n- 🎯 **Confidence Scoring** - Agents self-assess and request help when needed\r\n- ⚡ **High Performance** - Async/await, streaming responses, efficient orchestration\r\n- 📦 **TypeScript First** - Full type safety and excellent IDE support\r\n\r\n---\r\n\r\n## 🚀 Quick Start\r\n\r\n### Installation\r\n\r\n```bash\r\n# Install globally\r\nnpm install -g agent-forge\r\n\r\n# Or use npx (no installation required)\r\nnpx agent-forge --help\r\n```\r\n\r\n### Create a New Project\r\n\r\n```bash\r\n# Auto-detect your IDE\r\nagent-forge create my-project\r\n\r\n# Or specify your IDE explicitly\r\nagent-forge create my-project --ide cursor\r\nagent-forge create my-project --ide vscode\r\nagent-forge create my-project --ide windsurf\r\n```\r\n\r\n### Initialize in Existing Project\r\n\r\n```bash\r\n# In your project directory\r\ncd my-existing-project\r\nagent-forge init\r\n\r\n# Or specify IDE\r\nagent-forge init --ide cursor\r\n```\r\n\r\n### Navigate to Your Project\r\n\r\n```bash\r\ncd my-project\r\n```\r\n\r\n### Start Using Agents\r\n\r\nThe workflow depends on your IDE:\r\n\r\n#### Cursor IDE\r\n1. Open the project in Cursor\r\n2. Type `@af-hyperion` in the chat\r\n3. Describe what you want to build\r\n\r\n#### VS Code\r\n1. Open the project in VS Code\r\n2. Install GitHub Copilot extension\r\n3. Use GitHub Copilot Chat with AgentForge tools\r\n\r\n#### Windsurf IDE\r\n1. Open the project in Windsurf\r\n2. Type `@af-hyperion` in the chat\r\n3. Agents work natively with BMAD support\r\n\r\n---\r\n\r\n## 📁 Project Structure\r\n\r\n```\r\nmy-project/\r\n├── .cursor/                  # Cursor IDE configuration\r\n│   ├── rules/agent-forge/   # Agent rules for Cursor\r\n│   └── AGENT_FORGE_README.md\r\n├── .vscode/                  # VS Code configuration\r\n│   ├── agent-forge/         # Agent configs for VS Code\r\n│   ├── settings.json\r\n│   └── AGENT_FORGE_README.md\r\n├── .windsurf/                # Windsurf IDE configuration\r\n│   ├── rules/agent-forge/   # Agent rules for Windsurf\r\n│   ├── config.json\r\n│   └── AGENT_FORGE_README.md\r\n├── docs/                     # AUTO-GENERATED DOCUMENTATION\r\n│   ├── epics/               # Product epics\r\n│   ├── user-stories/        # User stories\r\n│   ├── architecture/        # Architecture docs & ADRs\r\n│   ├── diagrams/            # System & flow diagrams\r\n│   ├── wireframes/          # UX/UI wireframes & mockups\r\n│   ├── database/            # DB schemas & ER diagrams\r\n│   ├── api/                 # API documentation\r\n│   └── README.md            # Documentation index\r\n├── .agent-forge/             # Agent configurations\r\n└── src/                      # Your application code\r\n```\r\n\r\n---\r\n\r\n## 🤖 Available Agents\r\n\r\n| Agent | ID | Role | Capabilities |\r\n|-------|-----|------|--------------|\r\n| **Hyperion** | `@af-hyperion` | Lead Implementation Orchestrator | Full delivery workflow coordination, automatic QA/Security/Refactor |\r\n| **Developer** | `@af-dev` | Code Implementation Specialist | Feature development, bug fixes, self-review, testing |\r\n| **UX Designer** | `@af-ux` | User Experience Specialist | Wireframes, user flows, user research, usability testing |\r\n| **UI Designer** | `@af-ui` | Visual Design Specialist | Mockups, style guides, design systems, component libraries |\r\n| **QA** | `@af-qa` | Quality Navigator | Test planning, execution, verdict assessment (PASS/CONCERNS/FAIL) |\r\n| **Security** | `@af-security` | Cyber Resilience Lead | Security audits, threat modeling, vulnerability assessment |\r\n| **Refactor** | `@af-refactor` | Codebase Steward | Code quality analysis, technical debt management, performance |\r\n| **Architect** | `@af-arch` | System Architect | Architecture design, ADR generation, system diagrams |\r\n| **Product** | `@af-product` | Product Partner | Requirements analysis, story writing, acceptance criteria, epics |\r\n\r\n### 📄 Automatic Documentation\r\n\r\nAll design and architecture agents automatically generate documentation in the `docs/` directory:\r\n\r\n- **Product Agent** → `docs/epics/` and `docs/user-stories/`\r\n- **UX Agent** → `docs/wireframes/` and user flow diagrams\r\n- **UI Agent** → `docs/wireframes/` (style guides and design systems)\r\n- **Architect Agent** → `docs/architecture/` and `docs/diagrams/`\r\n- **Developer Agent** → `docs/api/` (technical documentation)\r\n\r\nDocumentation includes:\r\n- 📋 Epics and user stories (Markdown)\r\n- 🎨 Wireframes and mockups (Markdown + Mermaid diagrams)\r\n- 🏗️ Architecture diagrams (Mermaid format)\r\n- 🗄️ Database ER diagrams (Mermaid format)\r\n- 🎭 Style guides and design systems (Markdown)\r\n- 📊 Flow diagrams and user journeys (Mermaid format)\r\n\r\n---\r\n\r\n## 📖 Example Usage\r\n\r\n### Simple Feature Request (Any IDE)\r\n\r\n```\r\n@af-dev create a REST API endpoint for user management with TypeScript\r\n```\r\n\r\n### Full Delivery Workflow (Cursor/Windsurf)\r\n\r\n```\r\n@af-hyperion *deliver shopping cart feature with payment integration\r\n```\r\n\r\n### Security Audit\r\n\r\n```\r\n@af-security review this authentication implementation for vulnerabilities\r\n```\r\n\r\n### Code Refactoring\r\n\r\n```\r\n@af-refactor analyze and improve the database query performance\r\n```\r\n\r\n### UX Design\r\n\r\n```\r\n@af-ux create wireframes for the user onboarding flow\r\n```\r\n\r\n**Result:** Generates wireframes documentation in `docs/wireframes/` with user flows and interaction patterns!\r\n\r\n### UI Design\r\n\r\n```\r\n@af-ui create a comprehensive design system for our dashboard\r\n```\r\n\r\n**Result:** Generates style guide in `docs/wireframes/` with colors, typography, and component specifications!\r\n\r\n### Context Sharing\r\n\r\n```\r\n# All agents automatically read documentation and learn from each other!\r\n# Developer agent sees UX decisions, UX agent sees security concerns, etc.\r\n\r\n@af-hyperion *deliver user profile feature\r\n```\r\n\r\n**Result:** \r\n- ✅ UX Agent reads existing design docs\r\n- ✅ UI Agent follows style guide automatically  \r\n- ✅ Developer sees UX wireframes and implements accurately\r\n- ✅ Security Agent reviews and shares concerns\r\n- ✅ All agents learn from each other's decisions!\r\n\r\n---\r\n\r\n## 🔧 IDE-Specific Setup\r\n\r\n### Cursor IDE Setup\r\n\r\nCursor provides the best AgentForge experience with native agent support:\r\n\r\n```bash\r\nnpx agent-forge init --ide cursor\r\n```\r\n\r\n**Features:**\r\n- ✅ Inline agent mentions (`@af-*`)\r\n- ✅ BMAD rule support (`.mdc` files)\r\n- ✅ Live workspace context\r\n- ✅ Custom commands (`*help`, `*deliver`, etc.)\r\n- ✅ Auto-activation\r\n\r\n**Usage:**\r\n1. Open project in Cursor\r\n2. Chat panel: `@af-hyperion`\r\n3. Type: `*help` for commands\r\n\r\n### VS Code Setup\r\n\r\nVS Code works through GitHub Copilot and MCP protocol:\r\n\r\n```bash\r\nnpx agent-forge init --ide vscode\r\n```\r\n\r\n**Requirements:**\r\n- GitHub Copilot extension\r\n- GitHub Copilot Chat extension\r\n\r\n**Features:**\r\n- ✅ MCP protocol support\r\n- ✅ GitHub Copilot integration\r\n- ✅ Tool-based agent invocation\r\n\r\n**Usage:**\r\n1. Open project in VS Code\r\n2. GitHub Copilot Chat: Use natural language\r\n3. Example: \"Use the Developer agent to create a user API\"\r\n\r\n### Windsurf IDE Setup\r\n\r\nWindsurf has native BMAD support, making integration seamless:\r\n\r\n```bash\r\nnpx agent-forge init --ide windsurf\r\n```\r\n\r\n**Features:**\r\n- ✅ Native BMAD compatibility\r\n- ✅ Inline agent mentions\r\n- ✅ Full workspace context\r\n- ✅ Custom commands\r\n\r\n**Usage:**\r\n1. Open project in Windsurf\r\n2. Chat panel: `@af-hyperion`\r\n3. Full feature parity with Cursor\r\n\r\n---\r\n\r\n## 🏗️ Architecture\r\n\r\nAgentForge follows a modular, event-driven architecture:\r\n\r\n```\r\n┌─────────────────────────────────────────┐\r\n│         Your Application                │\r\n│  ┌────────────────────────────────────┐ │\r\n│  │      Orchestrator                  │ │\r\n│  │  ┌──────────┐  ┌──────────┐       │ │\r\n│  │  │ Developer │  │    QA    │       │ │\r\n│  │  │  Agent   │  │  Agent   │       │ │\r\n│  │  └──────────┘  └──────────┘       │ │\r\n│  │  ┌──────────┐  ┌──────────┐       │ │\r\n│  │  │ Security │  │ Refactor │       │ │\r\n│  │  │  Agent   │  │  Agent   │       │ │\r\n│  │  └──────────┘  └──────────┘       │ │\r\n│  └────────────────────────────────────┘ │\r\n└─────────────────────────────────────────┘\r\n              │\r\n              ▼\r\n┌─────────────────────────────────────────┐\r\n│      AgentForge Core                    │\r\n│  ┌────────────┐  ┌──────────┐          │\r\n│  │  Event Bus │  │  Memory  │          │\r\n│  │            │  │  System  │          │\r\n│  └────────────┘  └──────────┘          │\r\n│  ┌────────────┐  ┌──────────┐          │\r\n│  │ LLM Client │  │IDE Adaptr│          │\r\n│  └────────────┘  └──────────┘          │\r\n└─────────────────────────────────────────┘\r\n              │\r\n              ▼\r\n┌─────────────────────────────────────────┐\r\n│      External Services                  │\r\n│  ┌──────────┐  ┌──────────┐            │\r\n│  │Anthropic │  │  OpenAI  │            │\r\n│  └──────────┘  └──────────┘            │\r\n└─────────────────────────────────────────┘\r\n```\r\n\r\n---\r\n\r\n## 🔄 Workflows\r\n\r\nCoordinate multiple agents to complete complex tasks:\r\n\r\n```typescript\r\nimport { Orchestrator } from 'agent-forge';\r\n\r\nconst workflow = {\r\n  id: 'feature-development',\r\n  name: 'Full Feature Development',\r\n  stages: [\r\n    {\r\n      id: 'design',\r\n      agentId: 'architect',\r\n      task: { /* architecture task */ }\r\n    },\r\n    {\r\n      id: 'implement',\r\n      agentId: 'developer',\r\n      task: { /* implementation task */ },\r\n      dependencies: ['design']\r\n    },\r\n    {\r\n      id: 'test',\r\n      agentId: 'qa',\r\n      task: { /* testing task */ },\r\n      dependencies: ['implement']\r\n    },\r\n    {\r\n      id: 'security',\r\n      agentId: 'security',\r\n      task: { /* security audit */ },\r\n      dependencies: ['implement']\r\n    }\r\n  ]\r\n};\r\n\r\nconst orchestrator = new Orchestrator();\r\nconst result = await orchestrator.executeWorkflow(workflow);\r\n```\r\n\r\n---\r\n\r\n## 📦 Package Structure\r\n\r\nAgentForge is now a **single unified package** containing:\r\n\r\n- **Core Framework** - Agent system, orchestrator, memory, events\r\n- **Context & Documentation** - Knowledge base, pattern library, doc generation\r\n- **IDE Integration** - Multi-IDE support (Cursor, VS Code, Windsurf)\r\n- **CLI Tool** - Project initialization and management\r\n- **Agent Assets** - Pre-configured agent rules and templates\r\n\r\nInstall once, use everywhere:\r\n```bash\r\nnpm install -g agent-forge\r\n```\r\n\r\n---\r\n\r\n## 🛠️ Development\r\n\r\n```bash\r\n# Clone repository\r\ngit clone https://github.com/XoAuraHiru/agent-forge.git\r\ncd agent-forge\r\n\r\n# Install dependencies\r\nnpm install\r\n\r\n# Build the package\r\nnpm run build\r\n\r\n# Test locally\r\nnpm link\r\nagent-forge --version\r\nagent-forge create test-project\r\n\r\n# Run in development mode\r\nnpm run dev\r\n\r\n# Build for production (with minification)\r\nnpm run build:prod\r\n\r\n# Run tests\r\nnpm test\r\n```\r\n\r\n---\r\n\r\n## 🎯 Roadmap\r\n\r\n### ✅ Phase 1: Foundation (Completed)\r\n- [x] Core framework architecture\r\n- [x] Multi-IDE support (Cursor, VS Code, Windsurf)\r\n- [x] BaseAgent implementation\r\n- [x] Orchestrator system\r\n- [x] Memory system\r\n- [x] Event bus\r\n- [x] LLM client\r\n- [x] CLI tool\r\n\r\n### 🚧 Phase 2: Expansion (In Progress)\r\n- [ ] Real vector database providers (Pinecone, Weaviate)\r\n- [ ] Graph memory implementation (Neo4j)\r\n- [ ] Plugin system (GitHub, Jira, Slack)\r\n- [ ] Comprehensive testing\r\n- [ ] Example projects\r\n- [ ] Documentation site\r\n\r\n### 📋 Phase 3: Polish (Planned)\r\n- [ ] Performance optimization\r\n- [ ] Advanced monitoring dashboard\r\n- [ ] Cloud deployment\r\n- [ ] Community features\r\n- [ ] npm publication\r\n\r\n---\r\n\r\n## 🤝 Contributing\r\n\r\nContributions are welcome! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for details.\r\n\r\n1. Fork the repository\r\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\r\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\r\n4. Push to the branch (`git push origin feature/amazing-feature`)\r\n5. Open a Pull Request\r\n\r\n---\r\n\r\n## 📖 Documentation\r\n\r\n### **Essential Guides**\r\n\r\n- **[Agents Reference](./docs/AGENTS.md)** - All 9 agents, their commands, and examples\r\n- **[Adding Custom Agents](./docs/ADDING-AGENTS.md)** - Step-by-step guide to create new agents\r\n- **[Implementation Guide](./docs/IMPLEMENTATION.md)** - Deep technical documentation\r\n\r\n### **Additional Resources**\r\n\r\n- [IDE Integration](./docs/IDE-INTEGRATION.md) - IDE-specific setup\r\n- [Testing Guide](./docs/TESTING-GUIDE.md) - How to test agents\r\n- [Publishing Guide](./docs/PUBLISHING-GUIDE.md) - Build and publish\r\n- [Full Documentation Index](./docs/README.md) - Complete docs navigation\r\n\r\n---\r\n\r\n## 📝 License\r\n\r\nMIT © 2025\r\n\r\nSee [LICENSE](./LICENSE) for more information.\r\n\r\n---\r\n\r\n## 🙏 Acknowledgments\r\n\r\n- Built on the BMAD (Build, Measure, Analyze, Deploy) method\r\n- Inspired by modern AI agent frameworks\r\n- Built with ❤️ for the developer community\r\n- Powered by Anthropic Claude and OpenAI GPT\r\n\r\n---\r\n\r\n## 📧 Support\r\n\r\n- 🐛 [Issue Tracker](https://github.com/XoAuraHiru/agent-forge/issues)\r\n- 💬 [Discussions](https://github.com/XoAuraHiru/agent-forge/discussions)\r\n- 📖 [Documentation](./docs/)\r\n\r\n---\r\n\r\n<p align=\"center\">\r\n  <strong>Built with AgentForge</strong>\r\n  <br>\r\n  <sub>The future of AI-powered development</sub>\r\n</p>\r\n","readmeFilename":"README.md"}