agentic-flow-kit 1.8.7 → 2.1.0

package/locales/en/overrides/.qwen/agents/ui-verifier.md

@@ -0,0 +1,10 @@
+---
+name: ui-verifier
+description: "Runs browser-based verification for an implemented UI change and returns reproducible evidence without editing repository files"
+model: inherit
+approvalMode: plan
+---
+
+# UI Verifier
+
+Shared role contract: `.agents/roles/ui-verifier.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.qwen/agents/wiki-compiler.md

@@ -0,0 +1,13 @@
+---
+name: wiki-compiler
+description: "Translates a code commit into strict JSON describing what business capability the system gained, written for non-coding readers (product/customer service); read-only analysis, never edits files"
+disallowedTools:
+  - write_file
+  - edit
+  - replace
+model: inherit
+---
+
+# Wiki Compiler
+
+Shared role contract: `.agents/roles/wiki-compiler.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.qwen/commands/wf-deploy.md

@@ -0,0 +1,7 @@
+---
+description: "Deploy: merge checklist (static gates + pair checks + regression + DB + authorization + PR review/merge)"
+---
+
+Authoritative command: `.agents/commands/deploy.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.qwen/commands/wf-maintain.md

@@ -0,0 +1,7 @@
+---
+description: "Maintain: incident record + retrospective trio (fix / prevention / rule entries)"
+---
+
+Authoritative command: `.agents/commands/maintain.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.qwen/commands/wf-new-task.md

@@ -0,0 +1,7 @@
+---
+description: "New Task: closed-loop entry — classify first, then route (L0/L1 fast lane; L2/L3 → wf-stages)"
+---
+
+Authoritative command: `.agents/commands/new-task.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.qwen/commands/wf-pipeline-run.md

@@ -0,0 +1,7 @@
+---
+description: "pipeline-run automation entry: single command drives the six-stage loop (experimental; state machine unverified)"
+---
+
+Authoritative command: `.agents/commands/pipeline-run.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.qwen/commands/wf-pr-review.md

@@ -0,0 +1,7 @@
+---
+description: "PR panel review: multi-agent finders + independent votes + ledger"
+---
+
+Authoritative command: `.agents/commands/pr-review.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.qwen/commands/wf-review.md

@@ -0,0 +1,7 @@
+---
+description: "Code review standard: risk-graded machine gates + AI self-review checklist; user decides severity and merge"
+---
+
+Authoritative command: `.agents/commands/review.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.qwen/commands/wf-stages.md

@@ -0,0 +1,7 @@
+---
+description: "L2/L3 staged flow: Plan intent → Design spec → Build plan + implementation → Test static gates + UI verification + independent review + closeout (L1 → wf-new-task)"
+---
+
+Authoritative command: `.agents/commands/stages.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.trae/agents/implementer.md

@@ -0,0 +1,9 @@
+---
+name: implementer
+description: "Implements an approved, tightly scoped code change or test when the task includes owned files and executable acceptance criteria"
+tools: Read, Glob, Grep, Edit, Write, Shell, Exec, StopCommand, DeleteFile
+---
+
+# Implementer
+
+Shared role contract: `.agents/roles/implementer.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.trae/agents/independent-reviewer.md

@@ -0,0 +1,10 @@
+---
+name: independent-reviewer
+description: "Independently reviews a fixed spec, plan, or code diff for correctness and project-rule violations without modifying files"
+tools: Read, Glob, Grep
+disallowedTools: Edit, Write, Shell, Exec, StopCommand, DeleteFile
+---
+
+# Independent Reviewer
+
+Shared role contract: `.agents/roles/independent-reviewer.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.trae/agents/pr-adjudicator.md

@@ -0,0 +1,10 @@
+---
+name: pr-adjudicator
+description: "Read-only adjudicator for PR panel review; handles escalated candidates and returns verdicts"
+tools: Read, Glob, Grep
+disallowedTools: Edit, Write, Shell, Exec, StopCommand, DeleteFile
+---
+
+# PR Adjudicator
+
+Shared role contract: `.agents/roles/pr-adjudicator.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.trae/agents/pr-finder.md

@@ -0,0 +1,10 @@
+---
+name: pr-finder
+description: "Read-only finder for PR panel review; finds bugs independently per lens and returns candidate JSON"
+tools: Read, Glob, Grep
+disallowedTools: Edit, Write, Shell, Exec, StopCommand, DeleteFile
+---
+
+# PR Finder
+
+Shared role contract: `.agents/roles/pr-finder.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.trae/agents/pr-verifier.md

@@ -0,0 +1,10 @@
+---
+name: pr-verifier
+description: "Read-only verifier for PR panel review; independently verifies a candidate and returns a vote JSON"
+tools: Read, Glob, Grep
+disallowedTools: Edit, Write, Shell, Exec, StopCommand, DeleteFile
+---
+
+# PR Verifier
+
+Shared role contract: `.agents/roles/pr-verifier.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.trae/agents/ui-verifier.md

@@ -0,0 +1,10 @@
+---
+name: ui-verifier
+description: "Runs browser-based verification for an implemented UI change and returns reproducible evidence without editing repository files"
+tools: Read, Glob, Grep, Shell, Exec, StopCommand, mcp_Chrome_DevTools_MCP_navigate_page, mcp_Chrome_DevTools_MCP_new_page, mcp_Chrome_DevTools_MCP_list_pages, mcp_Chrome_DevTools_MCP_select_page, mcp_Chrome_DevTools_MCP_close_page, mcp_Chrome_DevTools_MCP_take_snapshot, mcp_Chrome_DevTools_MCP_take_screenshot, mcp_Chrome_DevTools_MCP_click, mcp_Chrome_DevTools_MCP_fill, mcp_Chrome_DevTools_MCP_fill_form, mcp_Chrome_DevTools_MCP_type_text, mcp_Chrome_DevTools_MCP_press_key, mcp_Chrome_DevTools_MCP_hover, mcp_Chrome_DevTools_MCP_drag, mcp_Chrome_DevTools_MCP_evaluate_script, mcp_Chrome_DevTools_MCP_wait_for, mcp_Chrome_DevTools_MCP_resize_page, mcp_Chrome_DevTools_MCP_emulate, mcp_Chrome_DevTools_MCP_list_console_messages, mcp_Chrome_DevTools_MCP_get_console_message, mcp_Chrome_DevTools_MCP_list_network_requests, mcp_Chrome_DevTools_MCP_get_network_request, mcp_Chrome_DevTools_MCP_handle_dialog, mcp_Chrome_DevTools_MCP_upload_file, mcp_Chrome_DevTools_MCP_get_css_styles, mcp_Chrome_DevTools_MCP_performance_start_trace, mcp_Chrome_DevTools_MCP_performance_stop_trace, mcp_Chrome_DevTools_MCP_performance_analyze_insight, mcp_Chrome_DevTools_MCP_take_heapsnapshot, mcp_Chrome_DevTools_MCP_lighthouse_audit, mcp_Chrome_DevTools_MCP_screencast_start, mcp_Chrome_DevTools_MCP_screencast_stop
+disallowedTools: Edit, Write, DeleteFile
+---
+
+# UI Verifier
+
+Shared role contract: `.agents/roles/ui-verifier.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.trae/agents/wiki-compiler.md

@@ -0,0 +1,10 @@
+---
+name: wiki-compiler
+description: "Translates a code commit into strict JSON describing what business capability the system gained, written for non-coding readers (product/customer service); read-only analysis, never edits files"
+tools: Read, Glob, Grep, Shell, Exec, StopCommand
+disallowedTools: Edit, Write, DeleteFile
+---
+
+# Wiki Compiler
+
+Shared role contract: `.agents/roles/wiki-compiler.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.trae/commands/wf-deploy.md

@@ -0,0 +1,8 @@
+---
+name: wf-deploy
+description: "Deploy: merge checklist (static gates + pair checks + regression + DB + authorization + PR review/merge)"
+---
+
+Authoritative command: `.agents/commands/deploy.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.trae/commands/wf-maintain.md

@@ -0,0 +1,8 @@
+---
+name: wf-maintain
+description: "Maintain: incident record + retrospective trio (fix / prevention / rule entries)"
+---
+
+Authoritative command: `.agents/commands/maintain.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.trae/commands/wf-new-task.md

@@ -0,0 +1,8 @@
+---
+name: wf-new-task
+description: "New Task: closed-loop entry — classify first, then route (L0/L1 fast lane; L2/L3 → wf-stages)"
+---
+
+Authoritative command: `.agents/commands/new-task.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.trae/commands/wf-pipeline-run.md

@@ -0,0 +1,8 @@
+---
+name: wf-pipeline-run
+description: "pipeline-run automation entry: single command drives the six-stage loop (experimental; state machine unverified)"
+---
+
+Authoritative command: `.agents/commands/pipeline-run.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.trae/commands/wf-pr-review.md

@@ -0,0 +1,8 @@
+---
+name: wf-pr-review
+description: "PR panel review: multi-agent finders + independent votes + ledger"
+---
+
+Authoritative command: `.agents/commands/pr-review.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.trae/commands/wf-review.md

@@ -0,0 +1,8 @@
+---
+name: wf-review
+description: "Code review standard: risk-graded machine gates + AI self-review checklist; user decides severity and merge"
+---
+
+Authoritative command: `.agents/commands/review.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.trae/commands/wf-stages.md

@@ -0,0 +1,8 @@
+---
+name: wf-stages
+description: "L2/L3 staged flow: Plan intent → Design spec → Build plan + implementation → Test static gates + UI verification + independent review + closeout (L1 → wf-new-task)"
+---
+
+Authoritative command: `.agents/commands/stages.md`
+
+This file is a pointer shell. Read the authoritative source at execution time; do not copy the body here.

package/locales/en/overrides/.trae/rules/backend-scope.md

@@ -0,0 +1,5 @@
+---
+description: Read backend/AGENTS.md before changing backend files
+alwaysApply: true
+---
+Before modifying or reviewing any file under `backend/`, read and follow `backend/AGENTS.md` (including §6 data integrity / API contract / database operation hard constraints).

package/locales/en/overrides/.trae/rules/frontend-scope.md

@@ -0,0 +1,5 @@
+---
+description: Read frontend/AGENTS.md before changing frontend files
+alwaysApply: true
+---
+Before modifying or reviewing any file under `frontend/`, read and follow `frontend/AGENTS.md` (including the BC/G gates and Never rules).

package/locales/en/overrides/.zcode/agents/implementer.md

@@ -0,0 +1,8 @@
+---
+name: implementer
+description: "Implements an approved, tightly scoped code change or test when the task includes owned files and executable acceptance criteria"
+---
+
+# Implementer
+
+Shared role contract: `.agents/roles/implementer.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.zcode/agents/independent-reviewer.md

@@ -0,0 +1,8 @@
+---
+name: independent-reviewer
+description: "Independently reviews a fixed spec, plan, or code diff for correctness and project-rule violations without modifying files"
+---
+
+# Independent Reviewer
+
+Shared role contract: `.agents/roles/independent-reviewer.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.zcode/agents/ui-verifier.md

@@ -0,0 +1,8 @@
+---
+name: ui-verifier
+description: "Runs browser-based verification for an implemented UI change and returns reproducible evidence without editing repository files"
+---
+
+# UI Verifier
+
+Shared role contract: `.agents/roles/ui-verifier.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/.zcode/agents/wiki-compiler.md

@@ -0,0 +1,8 @@
+---
+name: wiki-compiler
+description: "Translates a code commit into strict JSON describing what business capability the system gained, written for non-coding readers (product/customer service); read-only analysis, never edits files"
+---
+
+# Wiki Compiler
+
+Shared role contract: `.agents/roles/wiki-compiler.md`. This file keeps only the host frontmatter.

package/locales/en/overrides/AGENTS.md

@@ -0,0 +1,52 @@
+# Repository Guidelines
+
+{{projectName}}. {{stackDescription}}
+
+## 1. Runtime Connectivity
+The frontend dev server on port {{webPort}} connects to the API at `http://localhost:{{apiPort}}`; the API must listen on {{apiPort}} to be reachable. Environment facts live in `.agents/notes/runtime-env.md` §6; machine-specific absolute paths and versions are self-registered in `.agents/notes/runtime-env.local.md`.
+
+## 2. Local Setup (required after clone)
+> Missing these silently disables the gates. See `.agents/notes/runtime-env.md` §7.
+- `git config core.hooksPath .githooks` — mount the repository hooks.
+- `git config merge.ours.driver true` — enable `merge=ours` merge protection.
+- `git config merge.jsonl-union.driver "node .agents/scripts/git-merge-jsonl.mjs %O %A %B"` — enable union merge for `.agents/*.jsonl` ledgers.
+- **Never** use `--no-verify` for commit / merge / push.
+- **Self-check**: `node .agents/scripts/check-local-gates.mjs --fix`
+
+## 3. Universal Laws
+- **Security/privacy**: never commit secrets, tokens, `.env` files, or real user data; if sensitive material is found, stop spreading it immediately.
+- **Irreversible actions**: production deploys, remote pushes, and data deletion are off by default; they require explicit user instruction and must not bypass gates.
+- **Minimal change**: do the smallest change that satisfies the request; no drive-by refactors, formatting churn, or unrelated lint fixes.
+- **Single source**: paths, versions, and known defects are registered only in `.agents/notes/runtime-env.md` §6; do not copy them elsewhere.
+- **Context discipline**: bulk data collection, long logs, large diffs, and repo-wide inventories go to subagents; the main thread keeps conclusions and `file:line` only.
+- **Commits**: Conventional Commits; types limited to `feat/fix/docs/style/refactor/perf/chore`.
+
+## 4. Workflow Routing
+Jump to the corresponding command file by task type:
+
+| Task type | Command file | Responsibility |
+|---|---|---|
+| **L0 minimal** | `.agents/commands/new-task.md` | Fully machine-decidable micro-change; same fast lane as L1: edit → `verify --face`/`--scope` → one commit |
+| **L1 fast lane** | `.agents/commands/new-task.md` | Classify, implement, `verify --scope`, close in one commit (open a skill only for standalone closeout). Do not open `stages.md` |
+| **New requirement / feature** | `.agents/commands/new-task.md` | L1 uses the fast lane; L2/L3 move to `stages.md` |
+| **L2/L3 staged flow** | `.agents/commands/stages.md` | Four chapters Plan→Design→Build→Test: intent → spec → plan + implementation → static gates → UI verification → independent review → closeout |
+| **Fix / incident** | `.agents/commands/maintain.md` | For non-incident L1, only §1 filing then return to the fast lane. Read fully for production incidents and L2/L3 |
+| **Deploy / release** | `.agents/commands/deploy.md` | Static gates → regression checks (including DB verification) → authorization → PR review/merge |
+| **Merge review** | `.agents/commands/review.md` | P0/P1/P2 graded review → verdict |
+| **Automation driver** | `.agents/commands/pipeline-run.md` | Experimental, reserved: the state machine is unverified and has zero runs; add state-machine tests before enabling |
+| **Unattended / overnight** | `.agents/skills/autonomous-run/SKILL.md` | Long-run contract: per-unit sign-off + stop conditions; gates and confirmation doors are not waived |
+| **Performance / visual parity** | `.agents/skills/perf/SKILL.md` · `.agents/skills/visual-parity/SKILL.md` | Baseline first, then one variable at a time; claim parity only after the diff table is zero |
+
+> **Short-name corrections**: report the short name mid-task; the index is `.agents/config/principles.md`.
+
+> **Engine-face exemption**: changes to the AI-Native governance engine itself are **exempt from the workflow trio** — no intents/specs/plans and no confirmation doors; use Conventional Commits directly. Engine face = all of `.agents/`, `.githooks/`, `azure-pipelines.yml`, workflow templates and ledgers, root `package.json`, and host adapter directories; machine-local host directories are not committed. **Wiki exemption**: content edits under `wiki/` (including INDEX and boards) share the same exemption. **Boundary**: git hooks and static gates still run; deleting wiki files still requires a separate user instruction; executing data-maintenance SQL is not exempt.
+
+## 5. Directory-level Rules
+**Do not backfill this document.** Implementation details live in each directory's `AGENTS.md`:
+- **Backend**: `backend/AGENTS.md`
+- **Frontend**: `frontend/AGENTS.md`
+- **Paired documents**: keep paired documents registered in `wiki/INDEX.md` in sync, and update `wiki/INDEX.md` and `wiki/知识沉淀总览.html` together.
+
+## 6. Project Adaptations
+- **Build/test/typecheck**: the command list is single-sourced in `.agents/hooks/commit-check.config.json`.
+- **Smoke probes**: script paths and endpoint facts live in `.agents/notes/runtime-env.md` §6.1.

package/locales/en/overrides/CLAUDE.md

@@ -0,0 +1,20 @@
+# Project Guidance
+
+Single source of truth: root `AGENTS.md` (read it fully before starting). This file is the Claude Code host memory mirror; do not duplicate authoritative rules here.
+
+## Runtime / Setup
+- Frontend dev server `{{webPort}}` → API `http://localhost:{{apiPort}}`.
+- After clone: `node .agents/scripts/check-local-gates.mjs --fix`.
+- Never use `--no-verify` for commit / merge / push.
+
+## Routing
+- L0/L1: `.agents/commands/new-task.md`
+- L2/L3: `.agents/commands/stages.md`
+- Fix/incident: `.agents/commands/maintain.md`
+- Deploy: `.agents/commands/deploy.md`
+- Review: `.agents/commands/review.md`
+- Automation: `.agents/commands/pipeline-run.md` (experimental)
+
+## Boundaries
+- Host hooks and pointer shells are wired from this directory to `.agents/`.
+- Authoritative commands and role contracts live in `.agents/commands/` and `.agents/roles/`.

package/locales/en/overrides/wiki/INDEX.md

@@ -0,0 +1,33 @@
+# Wiki index
+
+> This directory is the project knowledge base, organized by topic. Board: `知识沉淀总览.html` (same directory, three-column mapping table).
+>
+> New installs start empty: place documents in the matching topic directory, then run `node .agents/scripts/gen-wiki-board.mjs`; this index and the board are regenerated automatically.
+
+## Topic directories at a glance
+
+| 主题 | 文件数 | 用途 |
+|---|---|---|
+| 产品需求 | 0 | New requirement prototype package (logic.md + app.html) |
+| 开发方案 | 0 | Data dictionary, API definitions, business module overview |
+| 数据维护 | 0 | Ledger of schema change / data repair / import / query / backup SQL |
+| 项目规范 | 0 | Development standards and hard constraints |
+| 用户功能 | 0 | Module feature docs, verification manuals, data-flow volumes |
+| 测试报告 | 0 | Archive of test and review reports |
+| drafts-archive | — | Original document backups (subdirectories by date-topic) |
+
+合计：**0 份**知识文档，**6 个主题**
+
+---
+
+## 文件 → 主题 → 归属目录 映射表
+
+(Generated by `node .agents/scripts/gen-wiki-board.mjs`, do not hand-edit.)
+
+---
+
+## 命名规则
+
+- Name new documents as `<日期>-<主题>/` or `<主题>-<名称>.md`.
+- Paired documents (html/md) must be maintained in sync.
+- Generated areas (overview table data rows, mapping table, board DATA) must not be hand-edited.

package/locales/en/overrides/wiki/drafts-archive/README.md

@@ -0,0 +1,6 @@
+# Drafts Archive
+
+This is the protocol directory for archived drafts. Decommissioned content is recorded here; **git history is the only trace** for deleted material.
+
+- Keep only the archive protocol/readme; do not add active documents.
+- New designs belong in `workflow/specs/` or `workflow/plans/`.

package/locales/en/overrides/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md

@@ -0,0 +1,22 @@
+# Data Maintenance Ledger
+
+This directory records all project data-maintenance SQL and execution status, grouped by phase:
+
+| Directory | Purpose |
+|---|---|
+| `schema变更/` | Schema changes (DDL); one `date-topic/` subdirectory per batch |
+| `数据修复/` | Existing-data fixes (DML); state affected row counts and rollback |
+| `数据导入/` | External data import scripts and mapping notes |
+| `查询/` | Read-only diagnostic SQL |
+| `备份/` | Backup and restore scripts |
+
+## Hard Constraints
+
+- Every new SQL must record its execution status and authorization source.
+- Never run a full-table `DELETE` / `UPDATE` without a `WHERE` clause.
+- Executing production SQL is irreversible and requires explicit user authorization; follow the project data-maintenance ledger and DB verification rules.
+- Script and ledger examples live in `_TEMPLATE.md` (if present).
+
+## Generated Artifacts
+
+`README.md` follows this directory protocol; the batch inventory is the subdirectories plus git history.