@xulthekl/team-flow 0.22.4

package/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "team-flow",
+  "interface": {
+    "displayName": "team-flow"
+  },
+  "plugins": [
+    {
+      "name": "team-flow",
+      "source": {
+        "source": "local",
+        "path": "./"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Developer Tools"
+    }
+  ]
+}

package/.agents/skills

@@ -0,0 +1 @@
+../skills

package/.claude/always/phase-guard.md

@@ -0,0 +1,3 @@
+# team-flow v0.22.4 | 阶段: {{state}} | 工作流: {{workflow}}
+当前阶段允许的操作由 workflow-start 路由规则定义。
+禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。

package/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "team-flow",
+  "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + workflow-orchestrator + workflow-bootstrap + e2e + session-handoff + workflow-feedback. 23 skills + 8 agents, one install.",
+  "owner": {
+    "name": "LT",
+    "url": "https://github.com/LT"
+  },
+  "plugins": [
+    {
+      "name": "team-flow",
+      "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback. 23 skills + 8 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
+      "version": "0.22.4",
+      "source": "./",
+      "author": {
+        "name": "LT",
+        "url": "https://github.com/LT"
+      }
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,31 @@
+{
+  "name": "team-flow",
+  "version": "0.22.4",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 23 skills + 8 agents, one install.",
+  "source": "./",
+  "author": {
+    "name": "LT",
+    "url": "https://github.com/LT"
+  },
+  "homepage": "https://github.com/LT/team-flow",
+  "repository": "https://github.com/LT/team-flow",
+  "license": "MIT",
+  "keywords": [
+    "workflow",
+    "skills",
+    "spec-driven-development",
+    "tdd",
+    "sdd",
+    "contract-driven",
+    "code-review",
+    "debugging",
+    "spec-sync",
+    "architecture",
+    "compound-engineering",
+    "prototype",
+    "claude-code",
+    "cursor",
+    "trae"
+  ],
+  "skills": "./skills/"
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,45 @@
+{
+  "name": "team-flow",
+  "version": "0.22.4",
+  "description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
+  "author": {
+    "name": "MageByte",
+    "url": "https://github.com/MageByte-Zero"
+  },
+  "homepage": "https://github.com/MageByte-Zero/team-flow",
+  "repository": "https://github.com/MageByte-Zero/team-flow",
+  "license": "MIT",
+  "keywords": [
+    "workflow",
+    "skills",
+    "spec-driven-development",
+    "tdd",
+    "sdd",
+    "contract-driven",
+    "code-review",
+    "debugging",
+    "spec-sync",
+    "codex"
+  ],
+  "skills": "./skills/",
+  "hooks": {},
+  "interface": {
+    "displayName": "team-flow",
+    "shortDescription": "Spec-first workflow with guarded execution.",
+    "longDescription": "A self-contained Codex workflow plugin with nine skills for intent exploration, planning artifacts, execution contracts, TDD execution, review gates, systematic debugging, closure, and delta spec sync.",
+    "developerName": "MageByte",
+    "category": "Developer Tools",
+    "composerIcon": "./assets/icon.svg",
+    "capabilities": [
+      "Write",
+      "Review"
+    ],
+    "websiteURL": "https://github.com/MageByte-Zero/team-flow",
+    "defaultPrompt": [
+      "Use workflow-start to start a new change.",
+      "Review the current team-flow stage.",
+      "Bridge the approved plan into an execution contract."
+    ],
+    "brandColor": "#2563EB"
+  }
+}

package/.codexignore

@@ -0,0 +1,6 @@
+# Codex plugin scanner ignore patterns
+# Directories that are not part of the plugin distribution
+changes/
+node_modules/
+.claude/
+tmp/

package/.cursor-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "team-flow-marketplace",
+  "owner": {
+    "name": "LT"
+  },
+  "metadata": {
+    "description": "Unified workflow plugin marketplace for Cursor (team-flow: team-flow + compound + architecture-design + prototype).",
+    "version": "0.22.4"
+  },
+  "plugins": [
+    {
+      "name": "team-flow",
+      "source": ".",
+      "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype. 17 collaborative skills."
+    }
+  ]
+}

package/.cursor-plugin/plugin.json

@@ -0,0 +1,31 @@
+{
+  "name": "team-flow",
+  "displayName": "team-flow",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 23 skills + 8 agents, one install.",
+  "version": "0.22.4",
+  "author": {
+    "name": "LT",
+    "url": "https://github.com/LT"
+  },
+  "homepage": "https://github.com/LT/team-flow",
+  "repository": "https://github.com/LT/team-flow",
+  "license": "MIT",
+  "logo": "assets/icon.svg",
+  "keywords": [
+    "workflow",
+    "skills",
+    "spec-driven-development",
+    "tdd",
+    "sdd",
+    "contract-driven",
+    "code-review",
+    "debugging",
+    "spec-sync",
+    "architecture",
+    "compound-engineering",
+    "prototype",
+    "ai-coding"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks/"
+}

package/.github/copilot-instructions.md

@@ -0,0 +1,15 @@
+# Phase Guard
+
+**当前阶段**: exploring | **工作流**: auto
+
+## ✅ 允许操作
+- 澄清需求、比较方案
+- 与用户讨论 scope 和 capabilities
+
+## ⛔ 禁止操作
+- 创建规划工件（proposal.md, specs/, design.md, tasks.md）
+- 执行实现代码
+- 修改 execution-contract.md
+
+## 🔔 决策点
+- DP-1: 需求确认 — 进入 specifying 前需用户确认 scope

package/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"

package/.github/plugin/marketplace.json

@@ -0,0 +1,42 @@
+{
+  "name": "team-flow",
+  "owner": {
+    "name": "LT",
+    "url": "https://github.com/LT"
+  },
+  "metadata": {
+    "description": "Unified workflow plugins and skills for AI coding agents (team-flow: team-flow + compound + architecture-design + prototype).",
+    "version": "0.22.4"
+  },
+  "plugins": [
+    {
+      "name": "team-flow",
+      "description": "Unified workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, delta spec sync, architecture-design, and local HTML prototyping.",
+      "version": "0.22.4",
+      "source": ".",
+      "author": {
+        "name": "LT",
+        "url": "https://github.com/LT"
+      },
+      "homepage": "https://github.com/LT/team-flow",
+      "repository": "https://github.com/LT/team-flow",
+      "license": "MIT",
+      "keywords": [
+        "workflow",
+        "skills",
+        "spec-driven-development",
+        "tdd",
+        "sdd",
+        "contract-driven",
+        "code-review",
+        "debugging",
+        "spec-sync",
+        "architecture",
+        "compound-engineering",
+        "prototype"
+      ],
+      "category": "Productivity",
+      "skills": "skills/"
+    }
+  ]
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,98 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+    branches: [main]
+
+jobs:
+  build-and-test:
+    name: Build & Test
+    runs-on: ubuntu-latest
+    if: "!startsWith(github.ref, 'refs/tags/')"
+    strategy:
+      matrix:
+        node-version: [20, 22]
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+      - name: Check version consistency
+        run: node scripts/check-version-consistency.mjs
+      - name: CLI smoke
+        run: |
+          node scripts/team-flow.mjs doctor
+          node scripts/team-flow.mjs --version
+          node scripts/team-flow.mjs config --get execution.inlineThreshold
+      - name: Token efficiency lint (warning only)
+        run: node scripts/lint/lint-skills.mjs --include token
+        continue-on-error: true
+
+  platform-install-smoke:
+    name: Platform Install Smoke (8 platforms)
+    runs-on: ubuntu-latest
+    if: "!startsWith(github.ref, 'refs/tags/')"
+    strategy:
+      matrix:
+        node-version: [20, 22]
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: ${{ matrix.node-version }}
+      - name: Smoke test all 8 platform installers (--local)
+        shell: bash
+        run: |
+          set -e
+          declare -A SKILLS=( [cline]=.cline/skills [kiro]=.kiro/skills [windsurf]=.windsurf/skills [qwen]=.qwen/skills [amazon-q]=.amazonq/skills [roocode]=.roo/skills [continue]=.continue/skills [pi]=.pi/skills )
+          declare -A RULES=( [cline]=.clinerules/phase-guard.md [kiro]=.kiro/steering/phase-guard.md [windsurf]=.windsurf/rules/phase-guard.md [qwen]=.qwen/rules/phase-guard.md [amazon-q]=.amazonq/rules/phase-guard.md [roocode]=.roo/rules/phase-guard.md [continue]=.continue/rules/phase-guard.md )
+          for id in cline kiro windsurf qwen amazon-q roocode continue pi; do
+            tmp="$(mktemp -d)"
+            ( cd "$tmp" && node "$GITHUB_WORKSPACE/scripts/install-$id.mjs" --local "$GITHUB_WORKSPACE" > /dev/null )
+            [ -d "$tmp/${SKILLS[$id]}" ] || { echo "FAIL $id: skills dir missing"; exit 1; }
+            count="$(ls "$tmp/${SKILLS[$id]}" | wc -l | tr -d ' ')"
+            [ "$count" -ge 9 ] || { echo "FAIL $id: only $count skills (expected 9)"; exit 1; }
+            if [ -n "${RULES[$id]:-}" ]; then
+              [ -f "$tmp/${RULES[$id]}" ] || { echo "FAIL $id: phase-guard rule missing"; exit 1; }
+            fi
+            echo "OK $id — 9 skills, rule=${RULES[$id]:-none}"
+          done
+          echo "All 8 platform installers passed smoke test."
+
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org
+          cache: npm
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+      - name: Check version consistency
+        run: node scripts/check-version-consistency.mjs
+      - name: Token efficiency lint (warning only)
+        run: node scripts/lint/lint-skills.mjs --include token
+        continue-on-error: true
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release create "$GITHUB_REF_NAME" --generate-notes
+      - name: Publish to npm
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/hol-plugin-scanner.yml

@@ -0,0 +1,17 @@
+name: Plugin Scanner
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: hashgraph-online/ai-plugin-scanner-action@c4737ed2f724bb612bd7df8c63f6835dd34181a3 # v1.2.392 / plugin-scanner 2.0.992 — pinned (last version under which main passed; @v1 auto-bumps). TODO: bump forward once shell-injection findings are cleaned up.
+        with:
+          plugin_dir: "."
+          fail_on_severity: high

package/.opencode/INSTALL.md

@@ -0,0 +1,61 @@
+# Installing team-flow for OpenCode
+
+## Prerequisites
+
+- [OpenCode.ai](https://opencode.ai) installed
+
+## Installation
+
+### Plugin Mode (recommended)
+
+Clone the repository and point OpenCode to the plugin entry:
+
+```bash
+git clone https://github.com/MageByte-Zero/team-flow.git ~/team-flow
+```
+
+Then in your OpenCode project, reference this plugin file by absolute path in `.opencode/config.json` (or via the UI):
+
+```text
+~/team-flow/.opencode/plugins/team-flow.js
+```
+
+Do not copy only `team-flow.js` into another project; the plugin reads `../../skills` and `../../GEMINI.md` relative to its own location.
+
+### Manual Skills Symlink
+
+OpenCode discovers agent skills from project skill directories. For a specific project:
+
+```bash
+git clone https://github.com/MageByte-Zero/team-flow.git
+mkdir -p your-project/.agents
+ln -s /absolute/path/to/team-flow/skills your-project/.agents/skills
+```
+
+If symlinks are not available, copy instead:
+
+```bash
+cp -R /absolute/path/to/team-flow/skills your-project/.agents/skills
+```
+
+## Usage
+
+Ask OpenCode to use the workflow entry skill:
+
+```
+用 workflow-start 开始
+```
+
+Or explicitly:
+
+```
+/team-flow:workflow-start
+```
+
+## Troubleshooting
+
+### Skills not found
+
+1. Verify that `.agents/skills/workflow-start/SKILL.md` exists.
+2. Restart OpenCode after adding or changing the skill directory.
+3. Use a real directory copy instead of a symlink if your environment does not follow symlinks.

package/.opencode/plugins/team-flow.js

@@ -0,0 +1,70 @@
+/**
+ * team-flow plugin for OpenCode.ai
+ *
+ * Registers skills directory and injects workflow-start bootstrap context
+ * at session start, following the same pattern as Superpowers' OpenCode plugin.
+ */
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const skillsDir = path.resolve(__dirname, '../../skills');
+
+// Module-level cache — read the bootstrap once per session
+let _bootstrapCache = undefined;
+
+const getBootstrapContent = () => {
+  if (_bootstrapCache !== undefined) return _bootstrapCache;
+
+  // Read GEMINI.md as the bootstrap context (shared across platforms)
+  const geminiMd = path.resolve(__dirname, '../../GEMINI.md');
+  if (!fs.existsSync(geminiMd)) {
+    _bootstrapCache = null;
+    return null;
+  }
+
+  const content = fs.readFileSync(geminiMd, 'utf8');
+
+  _bootstrapCache = `<EXTREMELY_IMPORTANT>
+You have team-flow installed.
+
+${content}
+
+**Tool Mapping for OpenCode:**
+When skill instructions reference tools, substitute OpenCode equivalents:
+- Read files → \`read\`
+- Create, edit, or delete files → \`apply_patch\`
+- Run shell commands → \`bash\`
+- Search files → \`grep\`, \`glob\`
+- Fetch a URL → \`webfetch\`
+- Create or update todos → \`todowrite\`
+</EXTREMELY_IMPORTANT>`;
+
+  return _bootstrapCache;
+};
+
+export const SpecSuperflowPlugin = async (_opts) => {
+  return {
+    // Register skills directory so OpenCode discovers team-flow skills
+    config: async (config) => {
+      config.skills = config.skills || {};
+      config.skills.paths = config.skills.paths || [];
+      if (!config.skills.paths.includes(skillsDir)) {
+        config.skills.paths.push(skillsDir);
+      }
+    },
+
+    // Inject bootstrap context into the first user message per session
+    'experimental.chat.messages.transform': async (_input, output) => {
+      const bootstrap = getBootstrapContent();
+      if (!bootstrap || !output.messages.length) return;
+      const firstUser = output.messages.find(m => m.info.role === 'user');
+      if (!firstUser || !firstUser.parts.length) return;
+      if (firstUser.parts.some(p => p.type === 'text' && p.text.includes('EXTREMELY_IMPORTANT'))) return;
+
+      const ref = firstUser.parts[0];
+      firstUser.parts.unshift({ ...ref, type: 'text', text: bootstrap });
+    },
+  };
+};