agent-orchestrator-kit 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.3] - 2026-06-14
+
+### Added
+- **`mvp` profile** — demos/spikes: `require_spec_review: false`, up to 3 active changes
+- **`/opsx:quick` command** — propose + apply in one session for MVP workflows
+- **`openspec/config.yaml.example`** from vue3 and mvp profiles on init
+- **Review gate enforcement** — `/opsx:review` writes `review.md`; `/opsx:apply` checks `require_spec_review`
+- **Vue 3 review checklist** in `/opsx:review` (script setup, Pinia, Axios)
+- **Package manager detection** (npm/yarn/pnpm) → updates verifier commands in `orchestrator.yaml`
+- **CI workflow** auto-detects npm / yarn / pnpm
+- **OpenSpec + frontend-agent-skills** hints in init next steps
+- **Profile validation** with warning for unknown profiles
+
+### Fixed
+- Gitignore dedup uses exact line match (not substring) — `.cursor/memory.json` no longer blocks `.cursor`
+- `.claude` added to gitignore on init
+- `sync --target amp` — explicit Amp handling + `.amp/settings.json` bootstrap
+
+## [0.1.2] - 2026-06-14
+
+### Fixed
+- CLI executable bit on `bin/agent-orchestrator.js` (`agent-orchestrator: not found` via npx)
+- Added `agent-orchestrator-kit` bin alias (matches package name for npx)
+
+## [0.1.1] - 2026-06-14
+
+### Added
+- All OpenSpec skills (`openspec-*`, `spec-workflow-openspec`)
+- CI workflow template `.github/workflows/agent-verify.yml`
+- `.agents/amp.settings.json.example` for Amp Code MCP
+- `update` command refreshes all kit-managed skills and CI
+- Sync script auto-creates `.amp/settings.json` from example
+
+### Removed
+- Unused `prompts` dependency
+
+## [0.1.0] - 2026-06-14
+
+### Added
+- Initial release: 5-role orchestration pipeline, `/opsx:*` commands, IDE sync
+
+[0.1.3]: https://github.com/makshc2/agent-orchestrator-kit/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/makshc2/agent-orchestrator-kit/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/makshc2/agent-orchestrator-kit/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/makshc2/agent-orchestrator-kit/releases/tag/v0.1.0

package/README.md

@@ -38,6 +38,8 @@ npm i -D @fission-ai/openspec
 npx openspec init
 ```
 
+> **Important:** `agent-orchestrator-kit init` does **not** install OpenSpec automatically. Install OpenSpec first (or ensure it exists in the repo), then run kit init.
+
 ### Install the kit
 
 ```bash
@@ -50,6 +52,7 @@ With a stack profile:
 npx agent-orchestrator-kit init --profile vue3
 npx agent-orchestrator-kit init --profile node
 npx agent-orchestrator-kit init --profile generic
+npx agent-orchestrator-kit init --profile mvp    # demos / spikes — no review gate
 ```
 
 With options:
@@ -111,7 +114,7 @@ your-project/
 | What | How |
 |------|-----|
 | OpenSpec CLI | `npm i -D @fission-ai/openspec && npx openspec init` |
-| Stack skills (Vue, etc.) | `npx vue-cursor-skills install` for vue3 profile |
+| Stack skills (Vue, JS, Vite) | `npx frontend-agent-skills install` for vue3 profile |
 | Project conventions | Create `.agents/project-conventions/SKILL.md` manually |
 | Domain specs | Live in `openspec/specs/` per project |
 
@@ -345,17 +348,28 @@ npx agent-orchestrator-kit update
 | Profile | Stack | Extra (separate install) |
 |---------|-------|--------------------------|
 | `generic` | Any | Orchestration + OpenSpec skills only |
-| `vue3` | Vue 3 + Vite | + `npx vue-cursor-skills install` |
-| `node` | Node.js | + your JS skills as needed |
+| `vue3` | Vue 3 + Vite + JS | + `npx frontend-agent-skills install` |
+| `node` | Node.js | + `npx frontend-agent-skills install --category javascript` |
+| `mvp` | Vue 3 demo/spike | + frontend-agent-skills; use `/opsx:quick`, no review gate |
 
 For `vue3`, after kit init also run:
 
 ```bash
-npx vue-cursor-skills install
-rsync -a .cursor/skills/ .agents/skills/
+# Amp (primary — installs directly to .agents/skills/)
+npx frontend-agent-skills install --agent amp --yes
+
+# Cursor + Claude Code users — sync local IDE dirs
 ./scripts/sync-local-agent-skills.sh
 ```
 
+Or install for all IDEs at once:
+
+```bash
+npx frontend-agent-skills install --agent all --yes
+```
+
+> **Migrating from `vue-cursor-skills`?** Renamed to `frontend-agent-skills` v2 — same package, old CLI alias still works.
+
 ## Memory MCP — Shared State Between Sessions
 
 Each role starts a fresh session. Memory MCP persists orchestration state across sessions so you don't re-explain context every time.
@@ -412,7 +426,7 @@ Amp will run this skill as a subagent when invoked.
 
 ```bash
 npx agent-orchestrator-kit init [options]
-  --profile <name>   Stack profile: generic | vue3 | node | python
+  --profile <name>   Stack profile: generic | vue3 | node | mvp
   --lang <code>      Agent language: en | uk | ...
   --name <name>      Project name (default: directory name)
   --force            Overwrite existing files
@@ -456,6 +470,23 @@ openspec/                # Committed — spec-driven workflow
 
 ## Changelog
 
+### 0.1.3
+- Fix gitignore dedup (exact line match, not substring)
+- Add `.claude` to gitignore on init
+- `sync --target amp` — explicit Amp handling + settings.json bootstrap
+- OpenSpec + frontend-agent-skills hints in init next steps
+- Profile validation with warning for unknown profiles
+- CI workflow: auto-detect npm / yarn / pnpm
+- Package manager detection → updates verifier commands in orchestrator.yaml
+- `openspec/config.yaml.example` from vue3/mvp profiles
+- Review gate: `review.md` + apply checks `require_spec_review`
+- Vue 3 checklist in `/opsx:review`
+- New `/opsx:quick` command and **mvp** profile for demos/spikes
+
+### 0.1.2
+- Fix CLI: executable bit on `bin/agent-orchestrator.js` (`agent-orchestrator: not found`)
+- Add `agent-orchestrator-kit` bin alias (matches package name for npx)
+
 ### 0.1.1
 - Added all OpenSpec skills (`openspec-*`, `spec-workflow-openspec`)
 - Added CI workflow template `.github/workflows/agent-verify.yml`

package/bin/agent-orchestrator.js

@@ -10,6 +10,8 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const KIT_ROOT = join(__dirname, '..');
 const KIT_VERSION = JSON.parse(readFileSync(join(KIT_ROOT, 'package.json'), 'utf-8')).version;
 
+const VALID_PROFILES = ['generic', 'vue3', 'node', 'mvp'];
+
 const KIT_SKILL_DIRS = [
   'agent-orchestration',
   'openspec-howto',
@@ -29,6 +31,8 @@ const KIT_MANAGED_PATHS = [
   'scripts/sync-local-agent-skills.sh',
 ];
 
+const GITIGNORE_LINES = ['.cursor', '.cursor/memory.json', '.amp/settings.json', '.claude'];
+
 const log = {
   info: (msg) => console.log(pc.cyan('  →'), msg),
   ok: (msg) => console.log(pc.green('  ✓'), msg),
@@ -58,20 +62,19 @@ function copyDir(src, dest, opts = {}) {
   }
 }
 
+function gitignoreLines(content) {
+  return content.split('\n').map((l) => l.trim()).filter(Boolean);
+}
+
 function mergeGitignore(projectDir, lines) {
   const gitignorePath = join(projectDir, '.gitignore');
-  let content = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf-8') : '';
-  let changed = false;
-  for (const line of lines) {
-    if (!content.includes(line)) {
-      content += `\n${line}`;
-      changed = true;
-    }
-  }
-  if (changed) {
-    writeFileSync(gitignorePath, content.trimStart());
-    log.ok('.gitignore updated');
-  }
+  const raw = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf-8') : '';
+  const existing = gitignoreLines(raw);
+  const toAdd = lines.filter((line) => !existing.includes(line));
+  if (toAdd.length === 0) return;
+  const prefix = raw.length > 0 && !raw.endsWith('\n') ? '\n' : '';
+  writeFileSync(gitignorePath, raw + prefix + toAdd.join('\n') + '\n');
+  log.ok('.gitignore updated');
 }
 
 function resolveTemplate(templateName, profile) {
@@ -89,6 +92,138 @@ function applyPlaceholders(filePath, vars) {
   writeFileSync(filePath, content);
 }
 
+function resolveProfile(profile) {
+  if (VALID_PROFILES.includes(profile)) return profile;
+  log.warn(`Unknown profile "${profile}". Valid: ${VALID_PROFILES.join(', ')}. Using generic.`);
+  return 'generic';
+}
+
+function detectPackageManager(projectDir) {
+  if (existsSync(join(projectDir, 'pnpm-lock.yaml'))) return 'pnpm';
+  if (existsSync(join(projectDir, 'yarn.lock'))) return 'yarn';
+  return 'npm';
+}
+
+function pmCommands(pm) {
+  const map = {
+    npm: { install: 'npm ci', lint: 'npm run lint', build: 'npm run build', test: 'npm test' },
+    yarn: { install: 'yarn install --frozen-lockfile', lint: 'yarn lint', build: 'yarn build', test: 'yarn test' },
+    pnpm: { install: 'pnpm install --frozen-lockfile', lint: 'pnpm run lint', build: 'pnpm run build', test: 'pnpm test' },
+  };
+  return map[pm] || map.npm;
+}
+
+function hasOpenSpec(projectDir) {
+  return existsSync(join(projectDir, 'openspec', 'config.yaml'));
+}
+
+function installOpenspecConfigExample(projectDir, profile, vars, force) {
+  const src = resolveTemplate('openspec-config.yaml.example', profile);
+  if (!existsSync(src)) return;
+
+  const openspecDir = join(projectDir, 'openspec');
+  const configPath = join(openspecDir, 'config.yaml');
+  const examplePath = join(openspecDir, 'config.yaml.example');
+
+  mkdirSync(openspecDir, { recursive: true });
+
+  if (existsSync(configPath) && !force) {
+    log.warn('skip (exists): openspec/config.yaml');
+    return;
+  }
+
+  if (!existsSync(configPath)) {
+    copyFileSync(src, examplePath);
+    applyPlaceholders(examplePath, vars);
+    log.ok('openspec/config.yaml.example');
+    return;
+  }
+
+  if (force) {
+    copyFileSync(src, configPath);
+    applyPlaceholders(configPath, vars);
+    log.ok('openspec/config.yaml');
+  }
+}
+
+function patchOrchestratorVerifier(projectDir, pm) {
+  const orchPath = join(projectDir, '.agents', 'orchestrator.yaml');
+  if (!existsSync(orchPath)) return;
+
+  const cmds = pmCommands(pm);
+  let content = readFileSync(orchPath, 'utf-8');
+
+  content = content.replace(/^(\s*package_manager:\s*).+$/m, `$1${pm}`);
+  if (!/^package_manager:/m.test(content)) {
+    content = content.replace(
+      /^(project:\n(?:  .+\n)+)/m,
+      `$1\npackage_manager: ${pm}\n`,
+    );
+  }
+
+  content = content.replace(/^(\s*lint_command:\s*).+$/m, `$1"${cmds.lint}"`);
+  content = content.replace(/^(\s*build_command:\s*).+$/m, `$1"${cmds.build}"`);
+  content = content.replace(/^(\s*test_command:\s*).+$/m, `$1"${cmds.test}"`);
+
+  writeFileSync(orchPath, content);
+}
+
+function printNextSteps(profile, projectDir) {
+  const pm = detectPackageManager(projectDir);
+  const openspecReady = hasOpenSpec(projectDir);
+  const lines = [`${pc.bold('Next steps:')}`];
+
+  if (!openspecReady) {
+    lines.push(`  0. Install OpenSpec (required — kit does not install it):`);
+    lines.push(`     ${pc.cyan('npm i -D @fission-ai/openspec && npx openspec init')}`);
+    lines.push(`     Then copy ${pc.cyan('openspec/config.yaml.example')} → ${pc.cyan('openspec/config.yaml')} if present`);
+  } else {
+    lines.push(`  0. OpenSpec detected ✓ — run ${pc.cyan('npx openspec validate --all --strict')} to verify`);
+  }
+
+  lines.push(`  1. Review ${pc.cyan('AGENTS.md')} and ${pc.cyan('.agents/orchestrator.yaml')}`);
+  lines.push(`  2. Sync to your IDE:`);
+  lines.push(`     ${pc.cyan('./scripts/sync-local-agent-skills.sh')}`);
+
+  if (profile === 'vue3') {
+    lines.push(`  3. Install Vue/JS stack skills:`);
+    lines.push(`     ${pc.cyan('npx frontend-agent-skills install --agent all --yes')}`);
+    lines.push(`  4. MCP: copy .mcp.json (Cursor) / .amp/settings.json (Amp) from *.example files`);
+    lines.push(`  5. Start your first change:`);
+  } else if (profile === 'mvp') {
+    lines.push(`  3. For quick demos use ${pc.cyan('/opsx:quick <name>')} (propose + apply, no review gate)`);
+    lines.push(`  4. MCP: copy .mcp.json (Cursor) / .amp/settings.json (Amp) from *.example files`);
+    lines.push(`  5. Start exploring:`);
+  } else {
+    lines.push(`  3. MCP: copy .mcp.json (Cursor) / .amp/settings.json (Amp) from *.example files`);
+    lines.push(`  4. Start your first change:`);
+  }
+
+  const startCmd = profile === 'mvp' ? '/opsx:quick' : '/opsx:explore';
+  lines.push(`     ${pc.cyan(startCmd)}`);
+
+  if (pm !== 'npm') {
+    lines.push(`  ${pc.dim(`Detected package manager: ${pm} (verifier commands updated in orchestrator.yaml)`)}`);
+  }
+
+  console.log('\n' + lines.join('\n') + '\n');
+}
+
+function syncAmp(projectDir) {
+  log.info('Amp Code reads .agents/ natively — no skill sync needed');
+  mkdirSync(join(projectDir, '.amp'), { recursive: true });
+  const ampExample = join(projectDir, '.agents', 'amp.settings.json.example');
+  const ampDest = join(projectDir, '.amp', 'settings.json');
+  if (existsSync(ampExample) && !existsSync(ampDest)) {
+    copyFileSync(ampExample, ampDest);
+    log.ok('.amp/settings.json created from example');
+  } else if (existsSync(ampDest)) {
+    log.ok('.amp/settings.json already present');
+  } else {
+    log.warn('.amp/settings.json missing — copy from .agents/amp.settings.json.example');
+  }
+}
+
 program
   .name('agent-orchestrator')
   .description('Universal AI agent orchestration kit for Cursor, Claude Code, and Amp Code')
@@ -97,22 +232,25 @@ program
 program
   .command('init')
   .description('Install orchestrator kit into the current project')
-  .option('--profile <profile>', 'Stack profile: generic | vue3 | node | python', 'generic')
+  .option('--profile <profile>', `Stack profile: ${VALID_PROFILES.join(' | ')}`, 'generic')
   .option('--lang <lang>', 'Agent response language (en | uk | ...)', 'en')
   .option('--name <name>', 'Project name (defaults to directory name)')
   .option('--force', 'Overwrite existing files', false)
   .action((opts) => {
     const projectDir = process.cwd();
     const projectName = opts.name || basename(projectDir);
+    const profile = resolveProfile(opts.profile);
+    const pm = detectPackageManager(projectDir);
 
     log.title(`agent-orchestrator init  v${KIT_VERSION}`);
     log.info(`Project: ${projectName}`);
-    log.info(`Profile: ${opts.profile}`);
+    log.info(`Profile: ${profile}`);
     log.info(`Language: ${opts.lang}`);
+    log.info(`Package manager: ${pm}`);
 
     const templateDir = join(KIT_ROOT, 'templates');
-    const profileDir = join(KIT_ROOT, 'profiles', opts.profile);
-    const vars = { PROJECT_NAME: projectName, LANG: opts.lang, KIT_VERSION };
+    const profileDir = join(KIT_ROOT, 'profiles', profile);
+    const vars = { PROJECT_NAME: projectName, LANG: opts.lang, KIT_VERSION, PACKAGE_MANAGER: pm };
 
     log.title('Installing .agents/');
     copyDir(join(templateDir, '.agents'), join(projectDir, '.agents'), { overwrite: opts.force });
@@ -141,7 +279,7 @@ program
 
     log.title('Installing root files');
     for (const f of ['AGENTS.md', 'CLAUDE.md']) {
-      const src = resolveTemplate(f, opts.profile);
+      const src = resolveTemplate(f, profile);
       const dest = join(projectDir, f);
       if (!opts.force && existsSync(dest)) {
         log.warn(`skip (exists): ${f}`);
@@ -154,30 +292,26 @@ program
       }
     }
 
-    const orchSrc = resolveTemplate('orchestrator.yaml', opts.profile);
+    const orchSrc = resolveTemplate('orchestrator.yaml', profile);
     const orchDest = join(projectDir, '.agents', 'orchestrator.yaml');
     if (!opts.force && existsSync(orchDest)) {
       log.warn('skip (exists): .agents/orchestrator.yaml');
     } else if (existsSync(orchSrc)) {
       copyFileSync(orchSrc, orchDest);
       applyPlaceholders(orchDest, vars);
+      patchOrchestratorVerifier(projectDir, pm);
       log.ok('.agents/orchestrator.yaml');
     }
 
+    log.title('OpenSpec config template');
+    installOpenspecConfigExample(projectDir, profile, vars, opts.force);
+
     log.title('Updating .gitignore');
-    mergeGitignore(projectDir, ['.cursor', '.cursor/memory.json', '.amp/settings.json']);
+    mergeGitignore(projectDir, GITIGNORE_LINES);
 
     log.title('Done');
     log.ok(`agent-orchestrator-kit v${KIT_VERSION} installed`);
-    console.log(`
-${pc.bold('Next steps:')}
-  1. Review ${pc.cyan('AGENTS.md')} and ${pc.cyan('.agents/orchestrator.yaml')}
-  2. Sync to your IDE:
-     ${pc.cyan('./scripts/sync-local-agent-skills.sh')}
-  3. Copy MCP config: .mcp.json (Cursor) / .amp/settings.json (Amp) from *.example files
-  4. Start your first change:
-     ${pc.cyan('/opsx:explore')}
-`);
+    printNextSteps(profile, projectDir);
   });
 
 program
@@ -208,7 +342,7 @@ program
 
 program
   .command('sync')
-  .description('Sync .agents/ to local IDE directories (Cursor, Claude Code)')
+  .description('Sync .agents/ to local IDE directories (Cursor, Claude Code, Amp)')
   .option('--target <target>', 'cursor | claude | amp | all', 'all')
   .action((opts) => {
     const projectDir = process.cwd();
@@ -217,6 +351,7 @@ program
 
     const syncCursor = ['cursor', 'all'].includes(opts.target);
     const syncClaude = ['claude', 'all'].includes(opts.target);
+    const syncAmpTarget = ['amp', 'all'].includes(opts.target);
 
     if (syncCursor) {
       log.info('Syncing .agents/ → .cursor/');
@@ -244,8 +379,14 @@ program
       }
     }
 
+    if (syncAmpTarget) {
+      syncAmp(projectDir);
+    }
+
+    mergeGitignore(projectDir, GITIGNORE_LINES);
+
     log.ok('Sync complete');
-    log.warn('.cursor/ and .claude/ are local only — not committed to git');
+    log.warn('.cursor/, .claude/, .amp/ are local only — not committed to git');
   });
 
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-orchestrator-kit",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Universal AI agent orchestration kit for Cursor, Claude Code, and Amp Code — spec-driven pipeline with OpenSpec integration",
   "keywords": [
     "ai-agent",
@@ -17,20 +17,22 @@
   "homepage": "https://github.com/makshc2/agent-orchestrator-kit#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/makshc2/agent-orchestrator-kit.git"
+    "url": "git+https://github.com/makshc2/agent-orchestrator-kit.git"
   },
   "bugs": {
     "url": "https://github.com/makshc2/agent-orchestrator-kit/issues"
   },
   "type": "module",
   "bin": {
-    "agent-orchestrator": "./bin/agent-orchestrator.js"
+    "agent-orchestrator-kit": "bin/agent-orchestrator.js",
+    "agent-orchestrator": "bin/agent-orchestrator.js"
   },
   "files": [
     "bin/",
     "templates/",
     "profiles/",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "engines": {
@@ -41,7 +43,11 @@
     "picocolors": "^1.0.0"
   },
   "scripts": {
+    "prepack": "chmod +x bin/agent-orchestrator.js",
+    "prepublishOnly": "npm test",
     "test": "node --test test/*.test.js",
-    "link": "npm link"
+    "link": "npm link",
+    "release:check": "npm test && npm pack --dry-run",
+    "release:tag": "git tag v$(node -p \"require('./package.json').version\")"
   }
 }

package/profiles/mvp/AGENTS.md

@@ -0,0 +1,47 @@
+# Agent Orchestration — {{PROJECT_NAME}} (MVP)
+
+> Powered by [agent-orchestrator-kit](https://github.com/makshc2/agent-orchestrator-kit) v{{KIT_VERSION}} — **mvp profile**
+
+Lightweight AI pipeline for **demos, spikes, and hypothesis testing**. Full spec review is optional.
+
+## Pipeline
+
+```
+explore → quick (propose + apply) → verify → archive (optional)
+```
+
+Or full path when needed:
+
+```
+explore → propose → apply → verify
+```
+
+## Roles
+
+| Role | Command | When |
+|------|---------|------|
+| Explorer | `/opsx:explore` | Scope unclear |
+| Quick | `/opsx:quick <name>` | Demo / spike / 1–3 files |
+| Architect | `/opsx:propose <name>` | Need full artifacts |
+| Implementer | `/opsx:apply <name>` | Continue existing change |
+| Verifier | local build/lint | Before demo handoff |
+
+## Hard Rules (MVP)
+
+- **`require_spec_review: false`** — no review gate
+- Up to **3 active changes** in parallel
+- **Archive optional** for throwaway demos
+- Still run **build + lint** before declaring done
+- Switch to **vue3/generic profile** when promoting demo to production
+
+## Quick Start
+
+```bash
+/opsx:quick add-demo-widget
+# or
+/opsx:explore → /opsx:quick <name>
+```
+
+## Configuration
+
+See `.agents/orchestrator.yaml` — `profile: mvp`, `quick_mode_enabled: true`.

package/profiles/mvp/README.md

@@ -0,0 +1,36 @@
+# MVP Profile
+
+Fast AI pipeline for **demos, prototypes, and hypothesis testing**.
+
+```bash
+npx agent-orchestrator-kit init --profile mvp --lang uk --name "My Demo"
+```
+
+## Differences from vue3/generic
+
+| Setting | vue3 | mvp |
+|---------|------|-----|
+| `require_spec_review` | true | **false** |
+| `max_active_changes` | 1 | **3** |
+| `archive_after_merge` | true | **false** |
+| Primary command | `/opsx:propose` | **`/opsx:quick`** |
+| Delta specs | required | optional |
+
+## Recommended stack setup
+
+```bash
+npm i -D @fission-ai/openspec
+npx openspec init
+# copy openspec/config.yaml.example → openspec/config.yaml
+
+npx frontend-agent-skills install --agent all --yes
+./scripts/sync-local-agent-skills.sh
+```
+
+## When to graduate to vue3 profile
+
+- Feature goes to production
+- Team needs spec review gate
+- Multi-day changes with delta specs
+
+Update `.agents/orchestrator.yaml` manually or re-init with `--profile vue3` (preserves openspec/).

package/profiles/mvp/openspec-config.yaml.example

@@ -0,0 +1,17 @@
+schema: spec-driven
+
+context: |
+  Проєкт: {{PROJECT_NAME}} — MVP / demo / hypothesis testing.
+  Стек: Vue 3 (Composition API, <script setup>), Pinia, Vite, Axios.
+  Мова агента: {{LANG}}.
+  Режим: швидкі ітерації — proposal + tasks достатньо; delta specs опційні.
+
+rules:
+  proposal:
+    - Коротко: проблема, scope, non-goals (≤ 15 рядків)
+    - Acceptance criteria — 3–5 перевірних пунктів
+  tasks:
+    - 3–7 атомарних задач
+    - Останній пункт: build + lint
+  specs:
+    - Опційно для MVP — пропускай якщо change тривіальний

package/profiles/mvp/orchestrator.yaml

@@ -0,0 +1,60 @@
+version: 1
+kit_version: "{{KIT_VERSION}}"
+
+project:
+  name: "{{PROJECT_NAME}}"
+  profile: mvp
+  stack: vue3
+  agent_language: "{{LANG}}"
+
+package_manager: npm
+
+pipeline:
+  require_spec_review: false
+  max_active_changes: 3
+  archive_after_merge: false
+  quick_mode_enabled: true
+
+roles:
+  explorer:
+    command: /opsx:explore
+    mode: read-only
+    model_hint: fast
+  architect:
+    command: /opsx:propose
+    mode: specs-only
+    model_hint: strong
+  quick:
+    command: /opsx:quick
+    mode: specs-and-code
+    model_hint: strong
+    notes: "Propose + apply in one session for demos and spikes"
+  implementer:
+    command: /opsx:apply
+    mode: code
+    model_hint: strong
+  spec_reviewer:
+    enabled: false
+  verifier:
+    type: local
+    gates:
+      - lint
+      - build
+
+handoff:
+  explore_to_propose: decision_brief
+  propose_to_apply: validate_or_quick
+  apply_to_verify: all_tasks_checked
+
+memory:
+  enabled: true
+  file: .cursor/memory.json
+
+mcp:
+  baseline:
+    - memory
+
+verifier:
+  lint_command: "npm run lint"
+  build_command: "npm run build"
+  test_command: ""

package/profiles/node/orchestrator.yaml

@@ -6,6 +6,8 @@ project:
   stack: node
   agent_language: "{{LANG}}"
 
+package_manager: npm
+
 pipeline:
   require_spec_review: true
   max_active_changes: 1

package/profiles/vue3/README.md

@@ -1,14 +1,36 @@
 # Vue 3 Profile
 
-After `agent-orchestrator-kit init --profile vue3`, also install Vue-specific skills:
+After `agent-orchestrator-kit init --profile vue3`, install stack skills from [frontend-agent-skills](https://www.npmjs.com/package/frontend-agent-skills):
 
 ```bash
-npx vue-cursor-skills install
-rsync -a --delete .cursor/skills/ .agents/skills/
+# OpenSpec (if not in repo yet)
+npm i -D @fission-ai/openspec && npx openspec init
+cp openspec/config.yaml.example openspec/config.yaml   # generated by kit init
+
+# Amp — installs directly to .agents/skills/ (no rsync needed)
+npx frontend-agent-skills install --agent amp --yes
+
+# Cursor / Claude Code — sync local IDE dirs after install
 ./scripts/sync-local-agent-skills.sh
 ```
 
-This adds: `vue-core`, `vue-pinia`, `vue-router`, `vue-axios`, `vue-architecture`, `vue-composables`, `vite`, and debug skills.
+Or install for all IDEs at once:
+
+```bash
+npx frontend-agent-skills install --agent all --yes
+```
+
+Selective install:
+
+```bash
+npx frontend-agent-skills install --agent amp --category vue --yes
+npx frontend-agent-skills install --agent amp --category javascript --yes
+npx frontend-agent-skills list
+```
+
+This adds Vue skills (`vue-core`, `vue-pinia`, `vue-router`, `vue-axios`, `vue-architecture`, `vue-composables`, `vue-debug`, …), `vite`, and JavaScript skills (`javascript-core`, `javascript-dom`, `javascript-debug`, …).
+
+> **Migrating from `vue-cursor-skills`?** Renamed in v2.0.0 — same skills, clearer name. Old CLI alias still works.
 
 ## Recommended OpenSpec config.yaml additions
 

package/profiles/vue3/openspec-config.yaml.example

@@ -0,0 +1,21 @@
+schema: spec-driven
+
+context: |
+  Проєкт: {{PROJECT_NAME}} — Vue 3 SPA.
+  Стек: Vue 3 (Composition API, <script setup>), Pinia, Vue Router, Axios, Vite.
+  Мова агента: {{LANG}}.
+  Код: production-ready, без Options API, без зайвих коментарів.
+
+rules:
+  proposal:
+    - Пиши українською (якщо agent_language: uk)
+    - Завжди включай Non-goals та Acceptance criteria
+  design:
+    - Посилайся на існуючі патерни в src/
+    - Описуй зміни на рівні компонентів, stores, API
+  tasks:
+    - Розбивай на задачі до ~2 годин
+    - Останній пункт: build + lint без помилок
+  specs:
+    - Delta format: ADDED / MODIFIED / REMOVED
+    - Кожна вимога — мінімум один Scenario

package/profiles/vue3/orchestrator.yaml

@@ -6,6 +6,8 @@ project:
   stack: vue3
   agent_language: "{{LANG}}"
 
+package_manager: npm
+
 pipeline:
   require_spec_review: true
   max_active_changes: 1

package/templates/.agents/commands/opsx-apply.md

@@ -20,6 +20,19 @@ Implement tasks from an OpenSpec change.
 
    Always announce: "Using change: <name>" and how to override (e.g., `/opsx:apply <other>`).
 
+1.5. **Check review gate**
+
+   Read `.agents/orchestrator.yaml` → `pipeline.require_spec_review`.
+
+   If `true` (default for generic/vue3/node):
+   - Look for `openspec/changes/<name>/review.md` with `Verdict: APPROVE`
+   - OR explicit **APPROVE ✓** from `/opsx:review <name>` in this session (user pasted verdict)
+   - OR Memory MCP entity `Change:<name>` with `status: spec-approved`
+   - If none found → **STOP**. Tell user:
+     > "Spec review required. Run `/opsx:review <name>` in a separate read-only session, then start a new apply session after **Approve ✓`."
+
+   If `false` (mvp profile) or user confirms quick/demo mode → proceed.
+
 2. **Check status to understand the schema**
    ```bash
    openspec status --change "<name>" --json

package/templates/.agents/commands/opsx-quick.md

@@ -0,0 +1,69 @@
+---
+name: /opsx-quick
+id: opsx-quick
+category: Workflow
+description: Fast path for MVP/demo — propose artifacts and apply in one session (skips review gate)
+---
+
+Quick mode for **small changes, demos, and hypothesis testing**. Combines propose + apply in one session.
+
+**Use when:**
+- Spike / proof-of-concept / demo UI
+- 1–3 files, clear scope
+- `pipeline.require_spec_review: false` in `.agents/orchestrator.yaml` (mvp profile)
+
+**Do NOT use when:**
+- Multi-file refactor, API contract changes, production features
+- Team requires spec review (`require_spec_review: true`)
+
+---
+
+**Input**: Change name (kebab-case) or description. Example: `/opsx:quick add-export-button`
+
+**Steps**
+
+1. **Check orchestrator config**
+
+   Read `.agents/orchestrator.yaml`:
+   - If `pipeline.require_spec_review: true` → warn user and ask to confirm skip OR use full pipeline (`/opsx:propose` → `/opsx:review` → `/opsx:apply`)
+   - If `false` or `profile: mvp` → proceed
+
+2. **Create change (minimal artifacts)**
+
+   ```bash
+   openspec new change "<name>"
+   ```
+
+   Create **lightweight** artifacts (no delta specs unless user asks):
+   - `proposal.md` — problem, scope, non-goals (5–10 lines)
+   - `tasks.md` — 3–7 atomic tasks with checkboxes
+   - `design.md` — optional, skip if trivial
+
+   Skip `specs/` delta for MVP unless behavior must be documented.
+
+3. **Validate**
+
+   ```bash
+   openspec validate <name> --strict --type change
+   ```
+
+4. **Apply immediately**
+
+   Follow `/opsx:apply` steps for the same change:
+   - Read tasks.md
+   - Implement 1–3 tasks per pass
+   - Mark `[x]`
+   - Run build/lint from `orchestrator.yaml` verifier commands
+
+5. **Exit**
+
+   - If demo done and no merge planned → optionally skip archive
+   - If merging → run `/opsx:archive` after CI green
+
+---
+
+**Guardrails**
+- Max ~3 hours of work — if bigger, switch to full pipeline
+- Still run build/lint before declaring done
+- Do not skip OpenSpec entirely — at minimum proposal + tasks
+- For vue3: use vue-core, vue-pinia skills during implementation

package/templates/.agents/commands/opsx-review.md

@@ -74,6 +74,13 @@ Evaluate each item. Mark ✓ or ✗:
 - [ ] ADDED/MODIFIED/REMOVED sections used correctly
 - [ ] No conflicts with main `openspec/specs/`
 
+**Vue 3** (when `project.stack: vue3` in `.agents/orchestrator.yaml`)
+- [ ] Components use `<script setup>` + Composition API (no Options API)
+- [ ] State via Pinia setup stores (`defineStore` + composable style)
+- [ ] HTTP via Axios service/composable patterns (not raw fetch scattered)
+- [ ] Tasks reference concrete component/store paths under `src/`
+- [ ] No scope creep into unrelated UI refactors
+
 ### 5. Output verdict
 
 #### If all ✓ (or only minor notes):
@@ -93,6 +100,31 @@ Evaluate each item. Mark ✓ or ✗:
 **Ready for implementation.** Run `/opsx:apply <name>` to proceed.
 ```
 
+Also **write review record** (gates apply when `require_spec_review: true`):
+
+Create or update `openspec/changes/<name>/review.md`:
+
+```markdown
+# Spec Review
+
+**Change:** <name>
+**Date:** <ISO date>
+**Verdict:** APPROVE
+
+## Checklist summary
+- Proposal: ✓
+- Design: ✓
+- Tasks: ✓
+- Delta specs: ✓
+
+## Notes
+<optional notes>
+```
+
+For **REQUEST CHANGES**, write the same file with `Verdict: REQUEST CHANGES` and issues list.
+
+This is the **only file** you may write during review (not `src/`, not `tasks.md` checkboxes).
+
 #### If any ✗:
 
 ```
@@ -119,7 +151,7 @@ Fix the above, then re-run `/opsx:review <name>`.
 ## Guardrails
 
 - **Never** edit source code, `src/`, or `tasks.md` checkboxes
-- **Never** create new files (only read)
+- **May write only** `openspec/changes/<name>/review.md` (verdict record for apply gate)
 - **Never** run apply commands
 - Ask for clarification only if a critical artifact is missing or unreadable
 - If proposal is ambiguous on scope, flag as ✗ — do not assume intent

package/templates/.agents/rules/agent-orchestration.mdc

@@ -10,17 +10,18 @@ This project uses a spec-driven 5-role pipeline. Read `.agents/orchestrator.yaml
 ## Role Commands
 - `/opsx:explore` → read-only thinking, no code
 - `/opsx:propose <name>` → creates `openspec/changes/<name>/` artifacts only
-- `/opsx:review <name>` → read-only spec review, outputs Approve or Request Changes
-- `/opsx:apply <name>` → writes `src/`, marks `tasks.md [x]`
+- `/opsx:review <name>` → read-only spec review, writes `review.md`, outputs Approve or Request Changes
+- `/opsx:apply <name>` → writes `src/`, marks `tasks.md [x]` (blocked if no review when `require_spec_review: true`)
+- `/opsx:quick <name>` → MVP: propose + apply in one session (when `require_spec_review: false`)
 - `/opsx:archive` → merges delta specs, moves change to archive
 
 ## Session Rules
-- One active change at a time
-- Each role = new chat session
+- One active change at a time (unless mvp profile: up to 3)
+- Each role = new chat session (except `/opsx:quick` combines propose+apply)
 - No code in explore or review sessions
-- No apply without explicit **Approve** from review
+- No apply without review when `pipeline.require_spec_review: true` — check `review.md` or Approve in context
 - After apply: build + lint before PR
-- After merge: always run `/opsx:archive`
+- After merge: run `/opsx:archive` (when `archive_after_merge: true`)
 
 ## Never
 - Mix propose and apply in one session

package/templates/.agents/rules/openspec-workflow.mdc

@@ -5,7 +5,7 @@ alwaysApply: true
 
 # OpenSpec Workflow (/opsx)
 
-`/opsx:explore`, `/opsx:propose`, `/opsx:apply`, `/opsx:archive`, `/opsx:sync`, `/opsx:review` — AI workflow commands, not source code.
+`/opsx:explore`, `/opsx:propose`, `/opsx:apply`, `/opsx:archive`, `/opsx:sync`, `/opsx:review`, `/opsx:quick` — AI workflow commands, not source code.
 
 ## File Locations
 
@@ -22,8 +22,9 @@ alwaysApply: true
 
 - `/opsx:explore` → skill `openspec-explore` (thinking only)
 - `/opsx:propose <name>` → skill `openspec-propose`
-- `/opsx:review <name>` → command `opsx-review` (read-only)
+- `/opsx:review <name>` → command `opsx-review` (read-only, writes review.md)
 - `/opsx:apply` → skill `openspec-apply-change`
+- `/opsx:quick <name>` → command `opsx-quick` (mvp: propose + apply)
 - `/opsx:archive` → skill `openspec-archive-change`
 - `/opsx:sync` → skill `openspec-sync-specs`
 

package/templates/.agents/skills/agent-orchestration/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Spec-driven AI agent pipeline orchestration built on OpenSpec. Load when deciding which
   role/command to use, how to handoff between phases, which model to pick, or when a session
   should stop and a new one start. Commands: /opsx:explore, /opsx:propose, /opsx:review,
-  /opsx:apply, /opsx:archive.
+  /opsx:apply, /opsx:archive, /opsx:quick.
 disable-model-invocation: false
 allowed-tools: Bash, Read
 ---
@@ -20,7 +20,12 @@ is the primary source of wasted tokens and failed implementations.
 explore → propose → review → apply → verify → archive
 ```
 
-Read `.agents/orchestrator.yaml` for project-specific config (language, flags, MCP).
+**MVP profile** (`require_spec_review: false`):
+```
+explore → quick (propose+apply) → verify → archive (optional)
+```
+
+Read `.agents/orchestrator.yaml` for project-specific config (language, flags, MCP, review gate).
 
 ## Roles & Commands
 
@@ -28,9 +33,10 @@ Read `.agents/orchestrator.yaml` for project-specific config (language, flags, M
 |------|---------|------|------------|----------------|
 | Explorer | `/opsx:explore` | read-only | fast | chat only |
 | Architect | `/opsx:propose <name>` | specs-only | strong | `openspec/changes/` |
-| Spec Reviewer | `/opsx:review <name>` | read-only | medium | Approve / Request Changes |
+| Spec Reviewer | `/opsx:review <name>` | read-only | medium | `review.md`, Approve / Request Changes |
 | Implementer | `/opsx:apply <name>` | code | strong | `src/`, `tasks.md [x]` |
-| Verifier | CI scripts | — | — | exit codes |
+| Quick (MVP) | `/opsx:quick <name>` | specs+code | strong | `openspec/changes/` + `src/` |
+| Verifier | CI / local scripts | — | — | exit codes |
 
 ## Handoff Protocol
 
@@ -60,7 +66,12 @@ openspec status --change "<name>"                # applyRequires artifacts all d
 ```
 
 ### review → apply
-Exit Reviewer only when verdict is explicit **APPROVE ✓**.
+Exit Reviewer only when verdict is explicit **APPROVE ✓** and `review.md` written.
+
+Before apply, check `.agents/orchestrator.yaml`:
+- `require_spec_review: true` → apply MUST find `review.md` with `Verdict: APPROVE` or Approve in session
+- `require_spec_review: false` → apply allowed directly (mvp / quick mode)
+
 If Request Changes — fix artifacts, re-run `/opsx:review`.
 
 ### apply → verify
@@ -80,8 +91,8 @@ After PR merged + CI green:
 
 **Start of each session:**
 1. Announce role: "Starting Spec Reviewer session for change: <name>"
-2. Check `openspec list` — confirm max 1 active change
-3. Read `orchestrator.yaml` for project config
+2. Check `openspec list` — confirm active change limit (`max_active_changes` in orchestrator.yaml)
+3. Read `orchestrator.yaml` for project config and review gate
 
 **During session:**
 - Stay in role — do not drift into next phase
@@ -121,7 +132,8 @@ At start of new session: read relevant entities to restore context without re-ex
 
 - [ ] explore session closed before propose started
 - [ ] `openspec validate --strict` passed before review
-- [ ] explicit **Approve** received before apply
+- [ ] explicit **Approve** received before apply (when `require_spec_review: true`)
+- [ ] `review.md` with `Verdict: APPROVE` exists (when review required)
 - [ ] all tasks `[x]` + build OK before PR
 - [ ] `/opsx:archive` run after merge
 

package/templates/.agents/skills/spec-workflow-openspec/SKILL.md

@@ -51,9 +51,10 @@ openspec/
 
 Для CLI, валідації, іменування changes і типових сценаріїв — читай skill **`openspec-howto`**.
 
-## Vue skills + Amp
+## Frontend skills + Amp
 
-При встановленні `vue-cursor-skills`:
-- дзеркалюй `.cursor/skills/` → `.agents/skills/`
+При встановленні [frontend-agent-skills](https://www.npmjs.com/package/frontend-agent-skills) (`vue-cursor-skills` — старий alias):
+- для Amp: `npx frontend-agent-skills install --agent amp --yes` (напряму в `.agents/skills/`)
+- для Cursor/Claude: `./scripts/sync-local-agent-skills.sh` після install
 - **не** налаштовуй SpecKit
 - якщо в проєкті є `openspec/` — дотримуйся OpenSpec workflow

package/templates/.github/workflows/agent-verify.yml

@@ -14,18 +14,69 @@ jobs:
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: npm
 
-      - run: npm ci
+      - name: Detect package manager
+        id: pm
+        run: |
+          if [ -f pnpm-lock.yaml ]; then
+            echo "manager=pnpm" >> "$GITHUB_OUTPUT"
+          elif [ -f yarn.lock ]; then
+            echo "manager=yarn" >> "$GITHUB_OUTPUT"
+          else
+            echo "manager=npm" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Enable corepack (pnpm)
+        if: steps.pm.outputs.manager == 'pnpm'
+        run: corepack enable
+
+      - name: Install dependencies (npm)
+        if: steps.pm.outputs.manager == 'npm'
+        run: npm ci
+
+      - name: Install dependencies (yarn)
+        if: steps.pm.outputs.manager == 'yarn'
+        run: yarn install --frozen-lockfile
+
+      - name: Install dependencies (pnpm)
+        if: steps.pm.outputs.manager == 'pnpm'
+        run: pnpm install --frozen-lockfile
 
       - name: OpenSpec validate
         run: npx openspec validate --all --strict
 
-      - name: Lint
+      - name: Lint (npm)
+        if: steps.pm.outputs.manager == 'npm'
         run: npm run lint --if-present
 
-      - name: Build
+      - name: Lint (yarn)
+        if: steps.pm.outputs.manager == 'yarn'
+        run: yarn lint
+
+      - name: Lint (pnpm)
+        if: steps.pm.outputs.manager == 'pnpm'
+        run: pnpm run lint
+
+      - name: Build (npm)
+        if: steps.pm.outputs.manager == 'npm'
         run: npm run build --if-present
 
-      - name: Test
+      - name: Build (yarn)
+        if: steps.pm.outputs.manager == 'yarn'
+        run: yarn build
+
+      - name: Build (pnpm)
+        if: steps.pm.outputs.manager == 'pnpm'
+        run: pnpm run build
+
+      - name: Test (npm)
+        if: steps.pm.outputs.manager == 'npm'
         run: npm test --if-present
+
+      - name: Test (yarn)
+        if: steps.pm.outputs.manager == 'yarn'
+        run: yarn test
+
+      - name: Test (pnpm)
+        if: steps.pm.outputs.manager == 'pnpm'
+        run: pnpm test

package/templates/orchestrator.yaml

@@ -5,6 +5,8 @@ project:
   name: "{{PROJECT_NAME}}"
   agent_language: "{{LANG}}"
 
+package_manager: npm
+
 pipeline:
   require_spec_review: true
   max_active_changes: 1

package/templates/scripts/sync-local-agent-skills.sh

@@ -71,7 +71,7 @@ GITIGNORE=".gitignore"
 CHANGED=0
 
 for line in ".cursor" ".cursor/memory.json" ".amp/settings.json" ".claude"; do
-  if ! grep -qF "$line" "$GITIGNORE" 2>/dev/null; then
+  if ! grep -qxF "$line" "$GITIGNORE" 2>/dev/null; then
     echo "$line" >> "$GITIGNORE"
     ok "Added '$line' to .gitignore"
     CHANGED=1