aigent-team 0.2.0 → 0.3.0

package/README.md

@@ -81,13 +81,102 @@ Interactive wizard that:
 2. Lets you pick which team agents to enable
 3. Creates `aigent-team.config.json`
 
+> **Note:** `init` only creates the config file. Run `aigent-team generate` to generate platform configs.
+
 ### Generate
 
 ```bash
 npx aigent-team generate
 ```
 
-Generates agent configs for all configured platforms. Run this after changing your config or updating aigent-team.
+When run without flags, an interactive wizard lets you choose:
+- **Generate mode**: Platform configs or Plugin bundle
+- **Scopes**: Agents, Skills, References
+- **Team agents**: which roles to generate
+- **Target platforms**: which platforms to generate for
+
+You can also pass flags to skip the wizard:
+
+#### Scope filtering
+
+Generate only specific output types:
+
+```bash
+# Only agent skill index files (no references or skills)
+npx aigent-team generate --scope agents
+
+# Only executable skill files
+npx aigent-team generate --scope skills
+
+# Only reference docs
+npx aigent-team generate --scope references
+
+# Combine scopes
+npx aigent-team generate --scope agents,skills
+```
+
+#### Team filtering
+
+Override the config's `teams` array from the CLI:
+
+```bash
+# Generate only for FE and BE agents
+npx aigent-team generate --team fe,be
+
+# Combine with scope: only skills for QA
+npx aigent-team generate --scope skills --team qa
+```
+
+### Plugin system
+
+Create a self-contained plugin bundle:
+
+```bash
+# Generate plugin bundle
+npx aigent-team generate --scope plugin
+
+# Or select "Plugin bundle" in the interactive wizard
+npx aigent-team generate
+```
+
+This creates a `.aigent-team-plugin/` directory (configurable via `output.pluginDir`) with self-contained per-platform bundles:
+
+```
+.aigent-team-plugin/
+├── manifest.json              # Metadata: version, roles, platforms, agent info
+├── claude-code-plugin/        # Self-contained Claude Code bundle
+│   ├── rules/                 # Hub file (CLAUDE.md)
+│   ├── agents/                # Agent skill indexes
+│   ├── skills/{agent}/        # Executable skill files
+│   └── kb/                    # References + shared knowledge
+│       ├── {agent}/           # Per-agent reference docs
+│       └── shared/            # Shared knowledge files
+├── cursor-ide-plugin/         # Self-contained Cursor bundle
+│   ├── .cursor-plugin/        # Plugin manifest
+│   ├── rules/                 # Shared conventions
+│   ├── agents/                # Agent .mdc files
+│   ├── skills/                # Skill files
+│   └── kb/                    # References
+└── ...                        # Other platform bundles
+```
+
+Each platform bundle is fully self-contained — all agents, skills, references, and shared knowledge are inside. Users can distribute or install any bundle independently.
+
+Install a plugin into a project:
+
+```bash
+# Install plugin — converts to platform-native formats
+npx aigent-team install ./path/to/plugin
+
+# Install for specific platform only
+npx aigent-team install ./plugin --platform cursor
+
+# Overwrite existing files
+npx aigent-team install ./plugin --force
+
+# Uninstall — removes all files installed by the plugin
+npx aigent-team uninstall my-plugin-name
+```
 
 ### Validate
 
@@ -132,6 +221,7 @@ Create `aigent-team.config.json` (or `.ts` / `.js`) in your project root:
 | `teams` | `string[]` | Yes | Agent teams to enable: `lead`, `ba`, `fe`, `be`, `qa`, `devops` |
 | `overrides` | `object` | No | Per-team overrides for `techStack`, `tools`, `globs` |
 | `overrides.<team>.techStack` | `object` | No | Override `languages`, `frameworks`, `libraries`, `buildTools` |
+| `output.pluginDir` | `string` | No | Plugin output directory (default: `.aigent-team-plugin/`) |
 
 ### Programmatic config
 
@@ -153,11 +243,15 @@ export default defineConfig({
 });
 ```
 
-### Platform-specific flags
+### CLI flags
 
 ```bash
-# Generate only for a specific platform
-npx aigent-team generate --platform claude-code
+npx aigent-team generate --platform claude-code    # Single platform
+npx aigent-team generate --scope skills            # Only skill files
+npx aigent-team generate --team fe,be              # Only FE + BE agents
+npx aigent-team generate --scope plugin            # Plugin bundle
+npx aigent-team install ./plugin --force           # Install plugin
+npx aigent-team uninstall my-app                   # Remove plugin
 ```
 
 ## Generated output
@@ -316,9 +410,11 @@ This mirrors how a real tech lead operates — delegating to specialists and ens
 
 | Document | Description |
 |---|---|
-| [Architecture](docs/architecture.md) | System design, data flow, module map, compiler pattern |
-| [Agent Reference](docs/agents.md) | All 6 agents — roles, capabilities, reference file catalog |
-| [Vision & Roadmap](docs/vision.md) | Future plans, design principles, platform expansion |
+| [Docs Index](docs/INDEX.md) | Entry point for all documentation, version history, RFC tracker |
+| [Architecture](docs/base/architecture.md) | System design, data flow, module map, compiler pattern |
+| [Agent Reference](docs/base/agents.md) | All 6 agents — roles, capabilities, reference file catalog |
+| [Vision & Roadmap](docs/base/vision.md) | Future plans, design principles, platform expansion |
+| [RFC-001: Scope & Plugin](docs/rfcs/rfc-001-generate-scope.md) | `--scope`, `--team`, plugin system design |
 | [Contributing](CONTRIBUTING.md) | Development setup, how to add agents/compilers |
 | [Changelog](CHANGELOG.md) | Release history |
 

package/dist/{chunk-U3NGK2UZ.js → chunk-RH4B2QFX.js}

@@ -4,6 +4,13 @@ import { createRequire } from 'module'; const require = createRequire(import.met
 import { z } from "zod";
 var PLATFORMS = ["claude-code", "cursor", "codex", "antigravity"];
 var TEAM_ROLES = ["lead", "ba", "fe", "be", "qa", "devops"];
+var GENERATE_SCOPES = ["all", "agents", "skills", "references", "plugin"];
+var PLUGIN_BUNDLE_DIRS = {
+  "claude-code": "claude-code-plugin",
+  cursor: "cursor-ide-plugin",
+  codex: "codex-plugin",
+  antigravity: "antigravity-plugin"
+};
 var TechStackSchema = z.object({
   languages: z.array(z.string()).optional(),
   frameworks: z.array(z.string()).optional(),
@@ -35,7 +42,8 @@ var ConfigSchema = z.object({
     architecture: z.string().optional()
   }).optional(),
   output: z.object({
-    directory: z.string().optional()
+    directory: z.string().optional(),
+    pluginDir: z.string().optional()
   }).optional()
 });
 
@@ -314,6 +322,8 @@ function assembleSkill(skill) {
 export {
   PLATFORMS,
   TEAM_ROLES,
+  GENERATE_SCOPES,
+  PLUGIN_BUNDLE_DIRS,
   loadConfig,
   configExists,
   loadAgents,