agentic-flow-kit 1.8.2 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +113 -148
- package/bin/flow-kit.mjs +5 -2
- package/locales/en/installer.json +25 -0
- package/locales/en/overrides/.agents/commands/deploy.md +52 -0
- package/locales/en/overrides/.agents/commands/maintain.md +76 -0
- package/locales/en/overrides/.agents/commands/new-task.md +89 -0
- package/locales/en/overrides/.agents/commands/pipeline-run.md +56 -0
- package/locales/en/overrides/.agents/commands/pr-review.md +30 -0
- package/locales/en/overrides/.agents/commands/review.md +93 -0
- package/locales/en/overrides/.agents/commands/stages.md +256 -0
- package/locales/en/overrides/.agents/notes/pr-review-cost-discipline.md +48 -0
- package/locales/en/overrides/.agents/notes/process-order-rule.md +21 -0
- package/locales/en/overrides/.agents/notes/runtime-env.local.example.md +21 -0
- package/locales/en/overrides/.agents/pipelines/_TEMPLATE.md +75 -0
- package/locales/en/overrides/.agents/pipelines/pipeline-closing.md +28 -0
- package/locales/en/overrides/.agents/roles/implementer.md +28 -0
- package/locales/en/overrides/.agents/roles/independent-reviewer.md +39 -0
- package/locales/en/overrides/.agents/roles/pr-adjudicator.md +27 -0
- package/locales/en/overrides/.agents/roles/pr-finder.md +51 -0
- package/locales/en/overrides/.agents/roles/pr-verifier.md +44 -0
- package/locales/en/overrides/.agents/roles/ui-verifier.md +22 -0
- package/locales/en/overrides/.agents/roles/wiki-compiler.md +47 -0
- package/locales/en/overrides/.agents/skills/arena/SKILL.md +50 -0
- package/locales/en/overrides/.agents/skills/autonomous-run/SKILL.md +45 -0
- package/locales/en/overrides/.agents/skills/blast-radius/SKILL.md +53 -0
- package/locales/en/overrides/.agents/skills/csharp-quality-gates/SKILL.md +109 -0
- package/locales/en/overrides/.agents/skills/dev-tour/SKILL.md +98 -0
- package/locales/en/overrides/.agents/skills/dream/SKILL.md +63 -0
- package/locales/en/overrides/.agents/skills/eval/SKILL.md +42 -0
- package/locales/en/overrides/.agents/skills/interrogate/SKILL.md +49 -0
- package/locales/en/overrides/.agents/skills/number-vetting/SKILL.md +35 -0
- package/locales/en/overrides/.agents/skills/page-refactor/SKILL.md +192 -0
- package/locales/en/overrides/.agents/skills/papercut-fix/SKILL.md +92 -0
- package/locales/en/overrides/.agents/skills/pause-safely/SKILL.md +31 -0
- package/locales/en/overrides/.agents/skills/perf/SKILL.md +42 -0
- package/locales/en/overrides/.agents/skills/review-method/SKILL.md +92 -0
- package/locales/en/overrides/.agents/skills/session-resume/SKILL.md +69 -0
- package/locales/en/overrides/.agents/skills/shipyard-workflow-closeout/SKILL.md +109 -0
- package/locales/en/overrides/.agents/skills/show-me-your-work/SKILL.md +57 -0
- package/locales/en/overrides/.agents/skills/tfs-pr/SKILL.md +95 -0
- package/locales/en/overrides/.agents/skills/verify-ui/SKILL.md +116 -0
- package/locales/en/overrides/.agents/skills/visual-parity/SKILL.md +35 -0
- package/locales/en/overrides/.agents/skills/why/SKILL.md +56 -0
- package/locales/en/overrides/.agents/skills/wiki/SKILL.md +53 -0
- package/locales/en/overrides/.claude/agents/implementer.md +9 -0
- package/locales/en/overrides/.claude/agents/independent-reviewer.md +10 -0
- package/locales/en/overrides/.claude/agents/pr-adjudicator.md +10 -0
- package/locales/en/overrides/.claude/agents/pr-finder.md +10 -0
- package/locales/en/overrides/.claude/agents/pr-verifier.md +10 -0
- package/locales/en/overrides/.claude/agents/ui-verifier.md +10 -0
- package/locales/en/overrides/.claude/agents/wiki-compiler.md +10 -0
- package/locales/en/overrides/.claude/commands/wf-deploy.md +8 -0
- package/locales/en/overrides/.claude/commands/wf-maintain.md +8 -0
- package/locales/en/overrides/.claude/commands/wf-new-task.md +8 -0
- package/locales/en/overrides/.claude/commands/wf-pipeline-run.md +8 -0
- package/locales/en/overrides/.claude/commands/wf-pr-review.md +8 -0
- package/locales/en/overrides/.claude/commands/wf-review.md +8 -0
- package/locales/en/overrides/.claude/commands/wf-stages.md +8 -0
- package/locales/en/overrides/.cline/agents/implementer.yml +13 -0
- package/locales/en/overrides/.cline/agents/independent-reviewer.yml +11 -0
- package/locales/en/overrides/.cline/agents/pr-adjudicator.yml +11 -0
- package/locales/en/overrides/.cline/agents/pr-finder.yml +11 -0
- package/locales/en/overrides/.cline/agents/pr-verifier.yml +11 -0
- package/locales/en/overrides/.cline/agents/ui-verifier.yml +8 -0
- package/locales/en/overrides/.cline/agents/wiki-compiler.yml +14 -0
- package/locales/en/overrides/.cline/workflows/wf-deploy.md +8 -0
- package/locales/en/overrides/.cline/workflows/wf-maintain.md +8 -0
- package/locales/en/overrides/.cline/workflows/wf-new-task.md +8 -0
- package/locales/en/overrides/.cline/workflows/wf-pipeline-run.md +8 -0
- package/locales/en/overrides/.cline/workflows/wf-pr-review.md +8 -0
- package/locales/en/overrides/.cline/workflows/wf-review.md +8 -0
- package/locales/en/overrides/.cline/workflows/wf-stages.md +8 -0
- package/locales/en/overrides/.codebuddy/CODEBUDDY.md +7 -0
- package/locales/en/overrides/.codebuddy/agents/implementer.md +9 -0
- package/locales/en/overrides/.codebuddy/agents/independent-reviewer.md +10 -0
- package/locales/en/overrides/.codebuddy/agents/pr-adjudicator.md +10 -0
- package/locales/en/overrides/.codebuddy/agents/pr-finder.md +10 -0
- package/locales/en/overrides/.codebuddy/agents/pr-verifier.md +10 -0
- package/locales/en/overrides/.codebuddy/agents/ui-verifier.md +11 -0
- package/locales/en/overrides/.codebuddy/agents/wiki-compiler.md +10 -0
- package/locales/en/overrides/.codebuddy/commands/wf-deploy.md +8 -0
- package/locales/en/overrides/.codebuddy/commands/wf-maintain.md +8 -0
- package/locales/en/overrides/.codebuddy/commands/wf-new-task.md +8 -0
- package/locales/en/overrides/.codebuddy/commands/wf-pipeline-run.md +8 -0
- package/locales/en/overrides/.codebuddy/commands/wf-pr-review.md +8 -0
- package/locales/en/overrides/.codebuddy/commands/wf-review.md +8 -0
- package/locales/en/overrides/.codebuddy/commands/wf-stages.md +8 -0
- package/locales/en/overrides/.codebuddy/rules/backend-scope.md +5 -0
- package/locales/en/overrides/.codebuddy/rules/frontend-scope.md +5 -0
- package/locales/en/overrides/.codebuddy/skills/tfs-pr/SKILL.md +6 -0
- package/locales/en/overrides/.commandcode/agents/implementer.md +10 -0
- package/locales/en/overrides/.commandcode/agents/independent-reviewer.md +9 -0
- package/locales/en/overrides/.commandcode/agents/pr-adjudicator.md +9 -0
- package/locales/en/overrides/.commandcode/agents/pr-finder.md +9 -0
- package/locales/en/overrides/.commandcode/agents/pr-verifier.md +9 -0
- package/locales/en/overrides/.commandcode/agents/ui-verifier.md +10 -0
- package/locales/en/overrides/.commandcode/agents/wiki-compiler.md +10 -0
- package/locales/en/overrides/.commandcode/commands/wf-deploy.md +7 -0
- package/locales/en/overrides/.commandcode/commands/wf-maintain.md +7 -0
- package/locales/en/overrides/.commandcode/commands/wf-new-task.md +7 -0
- package/locales/en/overrides/.commandcode/commands/wf-pipeline-run.md +7 -0
- package/locales/en/overrides/.commandcode/commands/wf-pr-review.md +7 -0
- package/locales/en/overrides/.commandcode/commands/wf-review.md +7 -0
- package/locales/en/overrides/.commandcode/commands/wf-stages.md +7 -0
- package/locales/en/overrides/.opencode/agents/implementer.md +51 -0
- package/locales/en/overrides/.opencode/agents/independent-reviewer.md +18 -0
- package/locales/en/overrides/.opencode/agents/pr-adjudicator.md +18 -0
- package/locales/en/overrides/.opencode/agents/pr-finder.md +18 -0
- package/locales/en/overrides/.opencode/agents/pr-verifier.md +18 -0
- package/locales/en/overrides/.opencode/agents/ui-verifier.md +45 -0
- package/locales/en/overrides/.opencode/agents/wiki-compiler.md +51 -0
- package/locales/en/overrides/.opencode/commands/wf-deploy.md +7 -0
- package/locales/en/overrides/.opencode/commands/wf-maintain.md +7 -0
- package/locales/en/overrides/.opencode/commands/wf-new-task.md +7 -0
- package/locales/en/overrides/.opencode/commands/wf-pipeline-run.md +7 -0
- package/locales/en/overrides/.opencode/commands/wf-pr-review.md +7 -0
- package/locales/en/overrides/.opencode/commands/wf-review.md +7 -0
- package/locales/en/overrides/.opencode/commands/wf-stages.md +7 -0
- package/locales/en/overrides/.pi/agents/implementer.md +11 -0
- package/locales/en/overrides/.pi/agents/independent-reviewer.md +12 -0
- package/locales/en/overrides/.pi/agents/pr-adjudicator.md +12 -0
- package/locales/en/overrides/.pi/agents/pr-finder.md +11 -0
- package/locales/en/overrides/.pi/agents/pr-verifier.md +11 -0
- package/locales/en/overrides/.pi/agents/ui-verifier.md +11 -0
- package/locales/en/overrides/.pi/agents/wiki-compiler.md +11 -0
- package/locales/en/overrides/.qoder/agents/implementer.md +9 -0
- package/locales/en/overrides/.qoder/agents/independent-reviewer.md +10 -0
- package/locales/en/overrides/.qoder/agents/pr-adjudicator.md +10 -0
- package/locales/en/overrides/.qoder/agents/pr-finder.md +10 -0
- package/locales/en/overrides/.qoder/agents/pr-verifier.md +10 -0
- package/locales/en/overrides/.qoder/agents/ui-verifier.md +10 -0
- package/locales/en/overrides/.qoder/agents/wiki-compiler.md +10 -0
- package/locales/en/overrides/.qoder/commands/wf-deploy.md +8 -0
- package/locales/en/overrides/.qoder/commands/wf-maintain.md +8 -0
- package/locales/en/overrides/.qoder/commands/wf-new-task.md +8 -0
- package/locales/en/overrides/.qoder/commands/wf-pipeline-run.md +8 -0
- package/locales/en/overrides/.qoder/commands/wf-pr-review.md +8 -0
- package/locales/en/overrides/.qoder/commands/wf-review.md +8 -0
- package/locales/en/overrides/.qoder/commands/wf-stages.md +8 -0
- package/locales/en/overrides/.qwen/agents/implementer.md +10 -0
- package/locales/en/overrides/.qwen/agents/independent-reviewer.md +10 -0
- package/locales/en/overrides/.qwen/agents/pr-adjudicator.md +10 -0
- package/locales/en/overrides/.qwen/agents/pr-finder.md +10 -0
- package/locales/en/overrides/.qwen/agents/pr-verifier.md +10 -0
- package/locales/en/overrides/.qwen/agents/ui-verifier.md +10 -0
- package/locales/en/overrides/.qwen/agents/wiki-compiler.md +13 -0
- package/locales/en/overrides/.qwen/commands/wf-deploy.md +7 -0
- package/locales/en/overrides/.qwen/commands/wf-maintain.md +7 -0
- package/locales/en/overrides/.qwen/commands/wf-new-task.md +7 -0
- package/locales/en/overrides/.qwen/commands/wf-pipeline-run.md +7 -0
- package/locales/en/overrides/.qwen/commands/wf-pr-review.md +7 -0
- package/locales/en/overrides/.qwen/commands/wf-review.md +7 -0
- package/locales/en/overrides/.qwen/commands/wf-stages.md +7 -0
- package/locales/en/overrides/.trae/agents/implementer.md +9 -0
- package/locales/en/overrides/.trae/agents/independent-reviewer.md +10 -0
- package/locales/en/overrides/.trae/agents/pr-adjudicator.md +10 -0
- package/locales/en/overrides/.trae/agents/pr-finder.md +10 -0
- package/locales/en/overrides/.trae/agents/pr-verifier.md +10 -0
- package/locales/en/overrides/.trae/agents/ui-verifier.md +10 -0
- package/locales/en/overrides/.trae/agents/wiki-compiler.md +10 -0
- package/locales/en/overrides/.trae/commands/wf-deploy.md +8 -0
- package/locales/en/overrides/.trae/commands/wf-maintain.md +8 -0
- package/locales/en/overrides/.trae/commands/wf-new-task.md +8 -0
- package/locales/en/overrides/.trae/commands/wf-pipeline-run.md +8 -0
- package/locales/en/overrides/.trae/commands/wf-pr-review.md +8 -0
- package/locales/en/overrides/.trae/commands/wf-review.md +8 -0
- package/locales/en/overrides/.trae/commands/wf-stages.md +8 -0
- package/locales/en/overrides/.trae/rules/backend-scope.md +5 -0
- package/locales/en/overrides/.trae/rules/frontend-scope.md +5 -0
- package/locales/en/overrides/.zcode/agents/implementer.md +8 -0
- package/locales/en/overrides/.zcode/agents/independent-reviewer.md +8 -0
- package/locales/en/overrides/.zcode/agents/ui-verifier.md +8 -0
- package/locales/en/overrides/.zcode/agents/wiki-compiler.md +8 -0
- package/locales/en/overrides/AGENTS.md +52 -0
- package/locales/en/overrides/CLAUDE.md +20 -0
- package/locales/en/overrides/wiki/INDEX.md +33 -0
- package/locales/en/overrides/wiki/drafts-archive/README.md +6 -0
- package/locales/en/overrides/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md +22 -0
- package/locales/en/overrides/wiki//347/237/245/350/257/206/346/262/211/346/267/200/346/200/273/350/247/210.html +230 -0
- package/locales/en/overrides/workflow/INDEX.md +13 -0
- package/locales/en/overrides/workflow/README.md +67 -0
- package/locales/en/overrides/workflow/archive/README.md +3 -0
- package/locales/en/overrides/workflow/delegations.md +4 -0
- package/locales/en/overrides/workflow/effective-policy.md +4 -0
- package/locales/en/overrides/workflow/gate-cost.md +4 -0
- package/locales/en/overrides/workflow/incidents/_TEMPLATE.md +49 -0
- package/locales/en/overrides/workflow/intents/_TEMPLATE.md +43 -0
- package/locales/en/overrides/workflow/metrics.md +4 -0
- package/locales/en/overrides/workflow/papercuts.md +3 -0
- package/locales/en/overrides/workflow/plans/_TEMPLATE.md +47 -0
- package/locales/en/overrides/workflow/regression-checklist.md +3 -0
- package/locales/en/overrides/workflow/specs/_TEMPLATE.md +86 -0
- package/locales/en/overrides/workflow/verify-evidence.md +4 -0
- package/locales/zh-CN/installer.json +25 -0
- package/package.json +23 -36
- package/schemas/install-manifest.schema.json +24 -0
- package/schemas/project-profile.schema.json +28 -0
- package/src/cli/args.mjs +41 -0
- package/src/cli/main.mjs +72 -0
- package/src/commands/add-host.mjs +29 -0
- package/src/commands/doctor.mjs +80 -0
- package/src/commands/install.mjs +149 -0
- package/src/commands/upgrade.mjs +30 -0
- package/src/git/config.mjs +61 -0
- package/src/hosts/registry.mjs +26 -0
- package/src/i18n.mjs +32 -0
- package/src/install/apply.mjs +124 -0
- package/src/install/manifest.mjs +40 -0
- package/src/install/plan.mjs +83 -0
- package/src/render/tokens.mjs +58 -0
- package/templates/engine/.agents/board/dev-tour.html +1940 -0
- package/templates/engine/.agents/board/index.html +835 -0
- package/templates/engine/.agents/commands/deploy.md +52 -0
- package/templates/engine/.agents/commands/maintain.md +76 -0
- package/templates/engine/.agents/commands/new-task.md +89 -0
- package/templates/engine/.agents/commands/pipeline-run.md +56 -0
- package/templates/engine/.agents/commands/pr-review.md +30 -0
- package/templates/engine/.agents/commands/review.md +93 -0
- package/templates/engine/.agents/commands/stages.md +256 -0
- package/templates/engine/.agents/config/commit-msg-rules.json +7 -0
- package/templates/engine/.agents/config/engine.json +11 -0
- package/templates/engine/.agents/config/gate-budgets.json +5 -0
- package/templates/engine/.agents/config/mechanism-registry.md +62 -0
- package/templates/engine/.agents/config/model-roles.json +26 -0
- package/templates/engine/.agents/config/model-roles.local.example.json +7 -0
- package/templates/engine/.agents/config/pr-review.json +67 -0
- package/templates/engine/.agents/config/principles.md +32 -0
- package/templates/engine/.agents/config/workflow-enums.txt +25 -0
- package/templates/engine/.agents/hooks/check-architecture.mjs +168 -0
- package/templates/engine/.agents/hooks/check-audit-fields.mjs +56 -0
- package/templates/engine/.agents/hooks/check-commit-plan-ref.mjs +84 -0
- package/templates/engine/.agents/hooks/check-confirm-order.mjs +281 -0
- package/templates/engine/.agents/hooks/check-delete-guard.mjs +63 -0
- package/templates/engine/.agents/hooks/check-notify-guard.mjs +55 -0
- package/templates/engine/.agents/hooks/commit-check.cjs +208 -0
- package/templates/engine/.agents/hooks/gates.json +33 -0
- package/templates/engine/.agents/hooks/local-pre-commit.mjs +27 -0
- package/templates/engine/.agents/hooks/pre-shell-check.cjs +361 -0
- package/templates/engine/.agents/hooks/pre-write-check.cjs +220 -0
- package/templates/engine/.agents/notes/gate-diet.md +75 -0
- package/templates/engine/.agents/notes/pr-review-cost-discipline.md +48 -0
- package/templates/engine/.agents/notes/process-order-rule.md +21 -0
- package/templates/engine/.agents/notes/runtime-env.local.example.md +21 -0
- package/templates/engine/.agents/pipelines/_TEMPLATE.md +75 -0
- package/templates/engine/.agents/pipelines/pipeline-closing.md +28 -0
- package/templates/engine/.agents/pipelines//347/244/272/344/276/213-/345/271/266/350/241/214/345/256/236/347/216/260/350/257/204/345/256/241.md +16 -0
- package/templates/engine/.agents/roles/implementer.md +28 -0
- package/templates/engine/.agents/roles/independent-reviewer.md +39 -0
- package/templates/engine/.agents/roles/pr-adjudicator.md +27 -0
- package/templates/engine/.agents/roles/pr-finder.md +51 -0
- package/templates/engine/.agents/roles/pr-verifier.md +44 -0
- package/templates/engine/.agents/roles/ui-verifier.md +22 -0
- package/templates/engine/.agents/roles/wiki-compiler.md +47 -0
- package/templates/engine/.agents/scripts/agg-delegations.mjs +439 -0
- package/templates/engine/.agents/scripts/agg-judgments.mjs +301 -0
- package/templates/engine/.agents/scripts/agg-kb-usage.mjs +196 -0
- package/templates/engine/.agents/scripts/append-compensation.mjs +109 -0
- package/templates/engine/.agents/scripts/archive-sweep.mjs +229 -0
- package/templates/engine/.agents/scripts/auto-tour.mjs +77 -0
- package/templates/engine/.agents/scripts/board-port.mjs +17 -0
- package/templates/engine/.agents/scripts/check-doc-body-drift.mjs +102 -0
- package/templates/engine/.agents/scripts/check-engine-artifacts.mjs +54 -0
- package/templates/engine/.agents/scripts/check-hook-wiring.mjs +75 -0
- package/templates/engine/.agents/scripts/check-lane-surface.mjs +393 -0
- package/templates/engine/.agents/scripts/check-ledger-doc-presence.mjs +71 -0
- package/templates/engine/.agents/scripts/check-ledger-invariant.mjs +873 -0
- package/templates/engine/.agents/scripts/check-local-gate-config.mjs +95 -0
- package/templates/engine/.agents/scripts/check-local-gates.mjs +248 -0
- package/templates/engine/.agents/scripts/check-loop-kit.mjs +550 -0
- package/templates/engine/.agents/scripts/check-loop-rev-semantics.mjs +59 -0
- package/templates/engine/.agents/scripts/check-loop-sections/s01-pairing.mjs +116 -0
- package/templates/engine/.agents/scripts/check-loop-sections/s03x-regr-evidence.mjs +38 -0
- package/templates/engine/.agents/scripts/check-loop-sections/s08-acceptance.mjs +130 -0
- package/templates/engine/.agents/scripts/check-loop-sections/s15-fingerprint.mjs +152 -0
- package/templates/engine/.agents/scripts/check-loop-sections/s23-convergence-audit.mjs +182 -0
- package/templates/engine/.agents/scripts/check-loop-sections/s29-regr-enforcer.mjs +69 -0
- package/templates/engine/.agents/scripts/check-loop.mjs +131 -0
- package/templates/engine/.agents/scripts/check-regression-consistency.mjs +252 -0
- package/templates/engine/.agents/scripts/check-schema-residue.mjs +144 -0
- package/templates/engine/.agents/scripts/check-scope-range.mjs +156 -0
- package/templates/engine/.agents/scripts/check-scope.mjs +121 -0
- package/templates/engine/.agents/scripts/check-scripts-syntax.mjs +138 -0
- package/templates/engine/.agents/scripts/check-secrets-lite.mjs +239 -0
- package/templates/engine/.agents/scripts/check-secrets.mjs +104 -0
- package/templates/engine/.agents/scripts/check-test-impact-map.mjs +107 -0
- package/templates/engine/.agents/scripts/ci-assert-frontend-deps.mjs +42 -0
- package/templates/engine/.agents/scripts/ci-commit-hygiene.mjs +86 -0
- package/templates/engine/.agents/scripts/ci-install-gitleaks.mjs +75 -0
- package/templates/engine/.agents/scripts/ci-push-before.mjs +49 -0
- package/templates/engine/.agents/scripts/closeout.mjs +127 -0
- package/templates/engine/.agents/scripts/compact-ledgers.mjs +70 -0
- package/templates/engine/.agents/scripts/confirm-doc.mjs +737 -0
- package/templates/engine/.agents/scripts/delegation-presence.mjs +38 -0
- package/templates/engine/.agents/scripts/dev-tour-model.mjs +1398 -0
- package/templates/engine/.agents/scripts/dream-run.mjs +283 -0
- package/templates/engine/.agents/scripts/ensure-board.mjs +187 -0
- package/templates/engine/.agents/scripts/failure-attribution.mjs +11 -0
- package/templates/engine/.agents/scripts/fill-intent.mjs +60 -0
- package/templates/engine/.agents/scripts/fill-plan.mjs +105 -0
- package/templates/engine/.agents/scripts/fill-spec.mjs +72 -0
- package/templates/engine/.agents/scripts/gen-dev-tour.mjs +191 -0
- package/templates/engine/.agents/scripts/gen-effective-policy.mjs +113 -0
- package/templates/engine/.agents/scripts/gen-engine-map.mjs +292 -0
- package/templates/engine/.agents/scripts/gen-narrative-claims.mjs +275 -0
- package/templates/engine/.agents/scripts/gen-verify-evidence.mjs +115 -0
- package/templates/engine/.agents/scripts/gen-wiki-board.mjs +221 -0
- package/templates/engine/.agents/scripts/gen-workflow-index.mjs +201 -0
- package/templates/engine/.agents/scripts/gen-workflow-metrics.mjs +692 -0
- package/templates/engine/.agents/scripts/git-merge-jsonl.mjs +62 -0
- package/templates/engine/.agents/scripts/judgment-ledger.mjs +68 -0
- package/templates/engine/.agents/scripts/kb-cache-evict.mjs +50 -0
- package/templates/engine/.agents/scripts/kb-search.mjs +423 -0
- package/templates/engine/.agents/scripts/lane-surface-audit.mjs +145 -0
- package/templates/engine/.agents/scripts/ledger-loader.mjs +77 -0
- package/templates/engine/.agents/scripts/ledger-shards.mjs +346 -0
- package/templates/engine/.agents/scripts/metrics-core.mjs +131 -0
- package/templates/engine/.agents/scripts/pipeline-run.mjs +964 -0
- package/templates/engine/.agents/scripts/policy.mjs +250 -0
- package/templates/engine/.agents/scripts/pr-create.mjs +54 -0
- package/templates/engine/.agents/scripts/pr-review.mjs +1551 -0
- package/templates/engine/.agents/scripts/quote-grounding.mjs +233 -0
- package/templates/engine/.agents/scripts/regen-ledgers.mjs +59 -0
- package/templates/engine/.agents/scripts/rewrite-file.mjs +135 -0
- package/templates/engine/.agents/scripts/rule-budget.mjs +246 -0
- package/templates/engine/.agents/scripts/stage-gates.mjs +812 -0
- package/templates/engine/.agents/scripts/test-impact-lib.mjs +451 -0
- package/templates/engine/.agents/scripts/test-impact.mjs +105 -0
- package/templates/engine/.agents/scripts/trust-mode.mjs +130 -0
- package/templates/engine/.agents/scripts/verify-scope.mjs +163 -0
- package/templates/engine/.agents/scripts/verify-wiki-consistency.mjs +264 -0
- package/templates/engine/.agents/scripts/verify.mjs +847 -0
- package/templates/engine/.agents/scripts/warn-format.mjs +57 -0
- package/templates/engine/.agents/scripts/wf-journal.mjs +230 -0
- package/templates/engine/.agents/scripts/workflow-board-server.mjs +696 -0
- package/templates/engine/.agents/scripts/workflow-enums.mjs +70 -0
- package/templates/engine/.agents/scripts/workflows-check.mjs +260 -0
- package/templates/engine/.agents/settings.json +33 -0
- package/templates/engine/.agents/skills/arena/SKILL.md +50 -0
- package/templates/engine/.agents/skills/autonomous-run/SKILL.md +45 -0
- package/templates/engine/.agents/skills/blast-radius/SKILL.md +53 -0
- package/templates/engine/.agents/skills/csharp-quality-gates/SKILL.md +109 -0
- package/templates/engine/.agents/skills/csharp-quality-gates/scripts/quality-gates.mjs +430 -0
- package/templates/engine/.agents/skills/dev-tour/SKILL.md +98 -0
- package/templates/engine/.agents/skills/dream/SKILL.md +63 -0
- package/templates/engine/.agents/skills/eval/SKILL.md +42 -0
- package/templates/engine/.agents/skills/eval/scripts/eval-score.mjs +59 -0
- package/templates/engine/.agents/skills/interrogate/SKILL.md +49 -0
- package/templates/engine/.agents/skills/interrogate/scripts/interrogate-plan.mjs +72 -0
- package/templates/engine/.agents/skills/number-vetting/SKILL.md +35 -0
- package/templates/engine/.agents/skills/page-refactor/SKILL.md +192 -0
- package/templates/engine/.agents/skills/page-refactor/references/templates.md +989 -0
- package/templates/engine/.agents/skills/papercut-fix/SKILL.md +92 -0
- package/templates/engine/.agents/skills/papercut-fix/references/response-template.md +81 -0
- package/templates/engine/.agents/skills/pause-safely/SKILL.md +31 -0
- package/templates/engine/.agents/skills/perf/SKILL.md +42 -0
- package/templates/engine/.agents/skills/review-method/SKILL.md +92 -0
- package/templates/engine/.agents/skills/review-method/golden-set.md +61 -0
- package/templates/engine/.agents/skills/session-resume/SKILL.md +69 -0
- package/templates/engine/.agents/skills/session-resume/scripts/worktree-audit.mjs +110 -0
- package/templates/engine/.agents/skills/shipyard-workflow-closeout/SKILL.md +109 -0
- package/templates/engine/.agents/skills/show-me-your-work/SKILL.md +57 -0
- package/templates/engine/.agents/skills/show-me-your-work/references/decision-log-template.tsv +1 -0
- package/templates/engine/.agents/skills/show-me-your-work/scripts/decision-log.mjs +24 -0
- package/templates/engine/.agents/skills/tfs-pr/SKILL.md +95 -0
- package/templates/engine/.agents/skills/tfs-pr/scripts/tfs-pr.mjs +947 -0
- package/templates/engine/.agents/skills/verify-ui/SKILL.md +116 -0
- package/templates/engine/.agents/skills/verify-ui/features/.gitkeep +0 -0
- package/templates/engine/.agents/skills/verify-ui/scripts/gen-verify-feature.mjs +114 -0
- package/templates/engine/.agents/skills/visual-parity/SKILL.md +35 -0
- package/templates/engine/.agents/skills/why/SKILL.md +56 -0
- package/templates/engine/.agents/skills/why/scripts/why-evidence.mjs +74 -0
- package/templates/engine/.agents/skills/wiki/SKILL.md +53 -0
- package/templates/engine/.agents/tests/auto-tour.test.mjs +82 -0
- package/templates/engine/.agents/tests/dev-tour-model.test.mjs +452 -0
- package/templates/engine/.agents/tests/fill-plan-lite.test.mjs +46 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-bare-mid-path.md +14 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-bare-mid-path.model.json +179 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-fake-path-guard.md +21 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-fake-path-guard.model.json +194 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-h3-batches.md +20 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-h3-batches.model.json +207 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-issues.md +24 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-issues.model.json +225 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-l1-single-file.md +15 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-l1-single-file.model.json +160 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layer-word-unique.md +29 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layer-word-unique.model.json +266 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layers-fallback.md +17 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layers-fallback.model.json +207 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-numbered-steps.md +39 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-numbered-steps.model.json +359 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-path-guess.md +16 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-path-guess.model.json +131 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-table-rows.md +29 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-table-rows.model.json +190 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-task-checkboxes.md +39 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-task-checkboxes.model.json +362 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-union-label.md +24 -0
- package/templates/engine/.agents/tests/fixtures/dev-tour/plan-union-label.model.json +224 -0
- package/templates/engine/.agents/tests/tools/gen-synthetic-plan.mjs +108 -0
- package/templates/git/.gitattributes +22 -0
- package/templates/git/.githooks/commit-msg +72 -0
- package/templates/git/.githooks/post-commit +62 -0
- package/templates/git/.githooks/pre-commit +197 -0
- package/templates/git/.githooks/pre-merge-commit +28 -0
- package/templates/git/.githooks/pre-push +201 -0
- package/templates/git/.gitignore.engine +11 -0
- package/templates/hosts/claude/CLAUDE.md +55 -0
- package/templates/hosts/claude/agents/implementer.md +7 -0
- package/templates/hosts/claude/agents/independent-reviewer.md +8 -0
- package/templates/hosts/claude/agents/pr-adjudicator.md +8 -0
- package/templates/hosts/claude/agents/pr-finder.md +8 -0
- package/templates/hosts/claude/agents/pr-verifier.md +8 -0
- package/templates/hosts/claude/agents/ui-verifier.md +8 -0
- package/templates/hosts/claude/agents/wiki-compiler.md +8 -0
- package/templates/hosts/claude/commands/wf-deploy.md +10 -0
- package/templates/hosts/claude/commands/wf-maintain.md +10 -0
- package/templates/hosts/claude/commands/wf-new-task.md +10 -0
- package/templates/hosts/claude/commands/wf-pipeline-run.md +10 -0
- package/templates/hosts/claude/commands/wf-pr-review.md +10 -0
- package/templates/hosts/claude/commands/wf-review.md +10 -0
- package/templates/hosts/claude/commands/wf-stages.md +10 -0
- package/templates/hosts/claude/settings.json +57 -0
- package/templates/hosts/cline/agents/implementer.yml +15 -0
- package/templates/hosts/cline/agents/independent-reviewer.yml +20 -0
- package/templates/hosts/cline/agents/pr-adjudicator.yml +18 -0
- package/templates/hosts/cline/agents/pr-finder.yml +19 -0
- package/templates/hosts/cline/agents/pr-verifier.yml +18 -0
- package/templates/hosts/cline/agents/ui-verifier.yml +17 -0
- package/templates/hosts/cline/agents/wiki-compiler.yml +20 -0
- package/templates/hosts/cline/hooks/PreToolUse.cjs +260 -0
- package/templates/hosts/cline/workflows/wf-deploy.md +8 -0
- package/templates/hosts/cline/workflows/wf-maintain.md +8 -0
- package/templates/hosts/cline/workflows/wf-new-task.md +8 -0
- package/templates/hosts/cline/workflows/wf-pipeline-run.md +8 -0
- package/templates/hosts/cline/workflows/wf-pr-review.md +8 -0
- package/templates/hosts/cline/workflows/wf-review.md +8 -0
- package/templates/hosts/cline/workflows/wf-stages.md +8 -0
- package/templates/hosts/codebuddy/CODEBUDDY.md +7 -0
- package/templates/hosts/codebuddy/agents/implementer.md +9 -0
- package/templates/hosts/codebuddy/agents/independent-reviewer.md +10 -0
- package/templates/hosts/codebuddy/agents/pr-adjudicator.md +10 -0
- package/templates/hosts/codebuddy/agents/pr-finder.md +10 -0
- package/templates/hosts/codebuddy/agents/pr-verifier.md +10 -0
- package/templates/hosts/codebuddy/agents/ui-verifier.md +11 -0
- package/templates/hosts/codebuddy/agents/wiki-compiler.md +10 -0
- package/templates/hosts/codebuddy/commands/wf-deploy.md +10 -0
- package/templates/hosts/codebuddy/commands/wf-maintain.md +10 -0
- package/templates/hosts/codebuddy/commands/wf-new-task.md +10 -0
- package/templates/hosts/codebuddy/commands/wf-pipeline-run.md +10 -0
- package/templates/hosts/codebuddy/commands/wf-pr-review.md +10 -0
- package/templates/hosts/codebuddy/commands/wf-review.md +10 -0
- package/templates/hosts/codebuddy/commands/wf-stages.md +10 -0
- package/templates/hosts/codebuddy/rules/backend-scope.md +5 -0
- package/templates/hosts/codebuddy/rules/frontend-scope.md +5 -0
- package/templates/hosts/codebuddy/settings.json +31 -0
- package/templates/hosts/codebuddy/skills/tfs-pr/SKILL.md +6 -0
- package/templates/hosts/commandcode/agents/implementer.md +10 -0
- package/templates/hosts/commandcode/agents/independent-reviewer.md +9 -0
- package/templates/hosts/commandcode/agents/pr-adjudicator.md +9 -0
- package/templates/hosts/commandcode/agents/pr-finder.md +9 -0
- package/templates/hosts/commandcode/agents/pr-verifier.md +9 -0
- package/templates/hosts/commandcode/agents/ui-verifier.md +11 -0
- package/templates/hosts/commandcode/agents/wiki-compiler.md +10 -0
- package/templates/hosts/commandcode/commands/wf-deploy.md +9 -0
- package/templates/hosts/commandcode/commands/wf-maintain.md +9 -0
- package/templates/hosts/commandcode/commands/wf-new-task.md +9 -0
- package/templates/hosts/commandcode/commands/wf-pipeline-run.md +9 -0
- package/templates/hosts/commandcode/commands/wf-pr-review.md +9 -0
- package/templates/hosts/commandcode/commands/wf-review.md +9 -0
- package/templates/hosts/commandcode/commands/wf-stages.md +9 -0
- package/templates/hosts/commandcode/settings.json +59 -0
- package/templates/hosts/opencode/agents/implementer.md +51 -0
- package/templates/hosts/opencode/agents/independent-reviewer.md +18 -0
- package/templates/hosts/opencode/agents/pr-adjudicator.md +18 -0
- package/templates/hosts/opencode/agents/pr-finder.md +18 -0
- package/templates/hosts/opencode/agents/pr-verifier.md +18 -0
- package/templates/hosts/opencode/agents/ui-verifier.md +45 -0
- package/templates/hosts/opencode/agents/wiki-compiler.md +51 -0
- package/templates/hosts/opencode/commands/wf-deploy.md +7 -0
- package/templates/hosts/opencode/commands/wf-maintain.md +7 -0
- package/templates/hosts/opencode/commands/wf-new-task.md +7 -0
- package/templates/hosts/opencode/commands/wf-pipeline-run.md +7 -0
- package/templates/hosts/opencode/commands/wf-pr-review.md +7 -0
- package/templates/hosts/opencode/commands/wf-review.md +7 -0
- package/templates/hosts/opencode/commands/wf-stages.md +7 -0
- package/templates/hosts/pi/agents/implementer.md +10 -0
- package/templates/hosts/pi/agents/independent-reviewer.md +11 -0
- package/templates/hosts/pi/agents/pr-adjudicator.md +11 -0
- package/templates/hosts/pi/agents/pr-finder.md +10 -0
- package/templates/hosts/pi/agents/pr-verifier.md +10 -0
- package/templates/hosts/pi/agents/ui-verifier.md +10 -0
- package/templates/hosts/pi/agents/wiki-compiler.md +10 -0
- package/templates/hosts/pi/extensions/lib/gates-core.cjs +196 -0
- package/templates/hosts/pi/extensions/shipyard-gates.ts +95 -0
- package/templates/hosts/pi/settings.json +5 -0
- package/templates/hosts/qoder/agents/implementer.md +9 -0
- package/templates/hosts/qoder/agents/independent-reviewer.md +10 -0
- package/templates/hosts/qoder/agents/pr-adjudicator.md +10 -0
- package/templates/hosts/qoder/agents/pr-finder.md +10 -0
- package/templates/hosts/qoder/agents/pr-verifier.md +10 -0
- package/templates/hosts/qoder/agents/ui-verifier.md +10 -0
- package/templates/hosts/qoder/agents/wiki-compiler.md +10 -0
- package/templates/hosts/qoder/commands/wf-deploy.md +8 -0
- package/templates/hosts/qoder/commands/wf-maintain.md +8 -0
- package/templates/hosts/qoder/commands/wf-new-task.md +8 -0
- package/templates/hosts/qoder/commands/wf-pipeline-run.md +8 -0
- package/templates/hosts/qoder/commands/wf-pr-review.md +8 -0
- package/templates/hosts/qoder/commands/wf-review.md +8 -0
- package/templates/hosts/qoder/commands/wf-stages.md +8 -0
- package/templates/hosts/qoder/settings.json +63 -0
- package/templates/hosts/qwen/agents/implementer.md +8 -0
- package/templates/hosts/qwen/agents/independent-reviewer.md +8 -0
- package/templates/hosts/qwen/agents/pr-adjudicator.md +8 -0
- package/templates/hosts/qwen/agents/pr-finder.md +8 -0
- package/templates/hosts/qwen/agents/pr-verifier.md +8 -0
- package/templates/hosts/qwen/agents/ui-verifier.md +8 -0
- package/templates/hosts/qwen/agents/wiki-compiler.md +11 -0
- package/templates/hosts/qwen/commands/wf-deploy.md +9 -0
- package/templates/hosts/qwen/commands/wf-maintain.md +9 -0
- package/templates/hosts/qwen/commands/wf-new-task.md +9 -0
- package/templates/hosts/qwen/commands/wf-pipeline-run.md +9 -0
- package/templates/hosts/qwen/commands/wf-pr-review.md +9 -0
- package/templates/hosts/qwen/commands/wf-review.md +9 -0
- package/templates/hosts/qwen/commands/wf-stages.md +9 -0
- package/templates/hosts/qwen/settings.json +59 -0
- package/templates/hosts/trae/agents/implementer.md +9 -0
- package/templates/hosts/trae/agents/independent-reviewer.md +10 -0
- package/templates/hosts/trae/agents/pr-adjudicator.md +10 -0
- package/templates/hosts/trae/agents/pr-finder.md +10 -0
- package/templates/hosts/trae/agents/pr-verifier.md +10 -0
- package/templates/hosts/trae/agents/ui-verifier.md +10 -0
- package/templates/hosts/trae/agents/wiki-compiler.md +10 -0
- package/templates/hosts/trae/commands/wf-deploy.md +8 -0
- package/templates/hosts/trae/commands/wf-maintain.md +8 -0
- package/templates/hosts/trae/commands/wf-new-task.md +8 -0
- package/templates/hosts/trae/commands/wf-pipeline-run.md +8 -0
- package/templates/hosts/trae/commands/wf-pr-review.md +8 -0
- package/templates/hosts/trae/commands/wf-review.md +8 -0
- package/templates/hosts/trae/commands/wf-stages.md +8 -0
- package/templates/hosts/trae/hooks.json +17 -0
- package/templates/hosts/trae/rules/backend-scope.md +5 -0
- package/templates/hosts/trae/rules/frontend-scope.md +5 -0
- package/templates/hosts/zcode/agents/implementer.md +8 -0
- package/templates/hosts/zcode/agents/independent-reviewer.md +8 -0
- package/templates/hosts/zcode/agents/ui-verifier.md +8 -0
- package/templates/hosts/zcode/agents/wiki-compiler.md +8 -0
- package/templates/hosts/zcode/config.json +31 -0
- package/templates/hosts/zcode/workflows/code-review.dwf.ts +428 -0
- package/templates/hosts/zcode/workflows/fullchain-flow-test.dwf.ts +898 -0
- package/templates/profiles/dotnet/.agents/config/lane-surfaces.txt +33 -0
- package/templates/profiles/dotnet/.agents/config/rule-budgets.txt +84 -0
- package/templates/profiles/dotnet/.agents/config/test-impact-map.json +590 -0
- package/templates/profiles/dotnet/.agents/config/workflow-modules.txt +18 -0
- package/templates/profiles/dotnet/.agents/hooks/commit-check.config.json +18 -0
- package/templates/profiles/dotnet/.agents/hooks/delete-guard-allowlist.txt +28 -0
- package/templates/profiles/dotnet/.agents/notes/runtime-env.md +178 -0
- package/templates/profiles/dotnet/AGENTS.md +52 -0
- package/templates/profiles/empty/.agents/config/lane-surfaces.txt +12 -0
- package/templates/profiles/empty/.agents/config/rule-budgets.txt +3 -0
- package/templates/profiles/empty/.agents/config/test-impact-map.json +8 -0
- package/templates/profiles/empty/.agents/config/workflow-modules.txt +2 -0
- package/templates/profiles/empty/.agents/hooks/commit-check.config.json +5 -0
- package/templates/profiles/empty/.agents/hooks/delete-guard-allowlist.txt +2 -0
- package/templates/profiles/empty/.agents/notes/runtime-env.md +44 -0
- package/templates/profiles/empty/AGENTS.md +52 -0
- package/templates/profiles/node/.agents/config/lane-surfaces.txt +12 -0
- package/templates/profiles/node/.agents/config/rule-budgets.txt +3 -0
- package/templates/profiles/node/.agents/config/test-impact-map.json +8 -0
- package/templates/profiles/node/.agents/config/workflow-modules.txt +2 -0
- package/templates/profiles/node/.agents/hooks/commit-check.config.json +5 -0
- package/templates/profiles/node/.agents/hooks/delete-guard-allowlist.txt +2 -0
- package/templates/profiles/node/.agents/notes/runtime-env.md +44 -0
- package/templates/profiles/node/AGENTS.md +52 -0
- package/templates/scaffold/wiki/INDEX.md +33 -0
- package/templates/scaffold/wiki/drafts-archive/README.md +7 -0
- package/templates/scaffold/wiki//344/272/247/345/223/201/351/234/200/346/261/202/.gitkeep +0 -0
- package/templates/scaffold/wiki//345/274/200/345/217/221/346/226/271/346/241/210/.gitkeep +0 -0
- package/templates/scaffold/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md +22 -0
- package/templates/scaffold/wiki//346/265/213/350/257/225/346/212/245/345/221/212/.gitkeep +0 -0
- package/templates/scaffold/wiki//347/224/250/346/210/267/345/212/237/350/203/275/.gitkeep +0 -0
- package/templates/scaffold/wiki//347/237/245/350/257/206/346/262/211/346/267/200/346/200/273/350/247/210.html +230 -0
- package/templates/scaffold/wiki//351/241/271/347/233/256/350/247/204/350/214/203/.gitkeep +0 -0
- package/templates/scaffold/workflow/INDEX.md +13 -0
- package/templates/scaffold/workflow/README.md +67 -0
- package/templates/scaffold/workflow/archive/README.md +3 -0
- package/templates/scaffold/workflow/delegations.d/.gitkeep +0 -0
- package/templates/scaffold/workflow/delegations.md +4 -0
- package/templates/scaffold/workflow/effective-policy.md +4 -0
- package/templates/scaffold/workflow/evidence/.gitkeep +0 -0
- package/templates/scaffold/workflow/gate-cost.md +4 -0
- package/templates/scaffold/workflow/gate-metrics.d/.gitkeep +0 -0
- package/templates/scaffold/workflow/incidents/_TEMPLATE.md +49 -0
- package/templates/scaffold/workflow/intents/_TEMPLATE.md +43 -0
- package/templates/scaffold/workflow/metrics.md +4 -0
- package/templates/scaffold/workflow/papercuts.d/.gitkeep +0 -0
- package/templates/scaffold/workflow/papercuts.md +3 -0
- package/templates/scaffold/workflow/plans/_TEMPLATE.md +47 -0
- package/templates/scaffold/workflow/regression-checklist.d/.gitkeep +0 -0
- package/templates/scaffold/workflow/regression-checklist.md +3 -0
- package/templates/scaffold/workflow/research/.gitkeep +0 -0
- package/templates/scaffold/workflow/reviews.d/.gitkeep +0 -0
- package/templates/scaffold/workflow/specs/_TEMPLATE.md +87 -0
- package/templates/scaffold/workflow/verify-evidence/.gitkeep +0 -0
- package/templates/scaffold/workflow/verify-evidence.md +4 -0
- package/LICENSE +0 -21
- package/modules/gates/README.md +0 -25
- package/modules/gates/dotnet-ca/README.md +0 -24
- package/modules/gates/dotnet-ca/check-architecture.sh +0 -150
- package/modules/gates/dotnet-ca/local-pre-commit.line +0 -1
- package/modules/gates/generated-readonly/README.md +0 -13
- package/modules/gates/generated-readonly/check-generated.mjs +0 -61
- package/modules/gates/generated-readonly/local-pre-commit.line +0 -1
- package/modules/gates/node-layer/README.md +0 -9
- package/modules/gates/node-layer/check-node-layer.mjs +0 -29
- package/modules/gates/node-layer/local-pre-commit.line +0 -1
- package/modules/gates/py-import/README.md +0 -9
- package/modules/gates/py-import/check-py-import.mjs +0 -30
- package/modules/gates/py-import/local-pre-commit.line +0 -1
- package/modules/gates/test-protect/README.md +0 -23
- package/modules/gates/test-protect/check-test-protect.mjs +0 -64
- package/modules/gates/test-protect/local-pre-commit.line +0 -1
- package/modules/hosts/README.md +0 -57
- package/modules/hosts/claude/agents/implementer.md +0 -51
- package/modules/hosts/claude/agents/independent-reviewer.md +0 -49
- package/modules/hosts/claude/agents/ui-verifier.md +0 -48
- package/modules/hosts/claude/commands/wf-build.md +0 -69
- package/modules/hosts/claude/commands/wf-deploy.md +0 -58
- package/modules/hosts/claude/commands/wf-design.md +0 -49
- package/modules/hosts/claude/commands/wf-gate-checklist.md +0 -77
- package/modules/hosts/claude/commands/wf-maintain.md +0 -76
- package/modules/hosts/claude/commands/wf-new-task.md +0 -102
- package/modules/hosts/claude/commands/wf-pipeline-run.md +0 -35
- package/modules/hosts/claude/commands/wf-plan.md +0 -40
- package/modules/hosts/claude/commands/wf-review.md +0 -49
- package/modules/hosts/claude/commands/wf-sync-hosts.md +0 -64
- package/modules/hosts/claude/commands/wf-test.md +0 -68
- package/modules/hosts/codex/agents/implementer.md +0 -51
- package/modules/hosts/codex/agents/independent-reviewer.md +0 -49
- package/modules/hosts/codex/agents/ui-verifier.md +0 -48
- package/modules/hosts/codex/commands/wf-build.md +0 -69
- package/modules/hosts/codex/commands/wf-deploy.md +0 -58
- package/modules/hosts/codex/commands/wf-design.md +0 -49
- package/modules/hosts/codex/commands/wf-gate-checklist.md +0 -77
- package/modules/hosts/codex/commands/wf-maintain.md +0 -76
- package/modules/hosts/codex/commands/wf-new-task.md +0 -102
- package/modules/hosts/codex/commands/wf-pipeline-run.md +0 -35
- package/modules/hosts/codex/commands/wf-plan.md +0 -40
- package/modules/hosts/codex/commands/wf-review.md +0 -49
- package/modules/hosts/codex/commands/wf-sync-hosts.md +0 -64
- package/modules/hosts/codex/commands/wf-test.md +0 -68
- package/modules/hosts/codex/skills/flow-kit/SKILL.md +0 -14
- package/modules/hosts/cursor/agents/implementer.md +0 -51
- package/modules/hosts/cursor/agents/independent-reviewer.md +0 -49
- package/modules/hosts/cursor/agents/ui-verifier.md +0 -48
- package/modules/hosts/cursor/commands/wf-build.md +0 -69
- package/modules/hosts/cursor/commands/wf-deploy.md +0 -58
- package/modules/hosts/cursor/commands/wf-design.md +0 -49
- package/modules/hosts/cursor/commands/wf-gate-checklist.md +0 -77
- package/modules/hosts/cursor/commands/wf-maintain.md +0 -76
- package/modules/hosts/cursor/commands/wf-new-task.md +0 -102
- package/modules/hosts/cursor/commands/wf-pipeline-run.md +0 -35
- package/modules/hosts/cursor/commands/wf-plan.md +0 -40
- package/modules/hosts/cursor/commands/wf-review.md +0 -49
- package/modules/hosts/cursor/commands/wf-sync-hosts.md +0 -64
- package/modules/hosts/cursor/commands/wf-test.md +0 -68
- package/modules/hosts/omp/agents/implementer.md +0 -52
- package/modules/hosts/omp/agents/independent-reviewer.md +0 -50
- package/modules/hosts/omp/agents/ui-verifier.md +0 -49
- package/modules/hosts/opencode/agents/implementer.md +0 -59
- package/modules/hosts/opencode/agents/independent-reviewer.md +0 -53
- package/modules/hosts/opencode/agents/ui-verifier.md +0 -52
- package/modules/hosts/opencode/commands/wf-build.md +0 -69
- package/modules/hosts/opencode/commands/wf-deploy.md +0 -58
- package/modules/hosts/opencode/commands/wf-design.md +0 -49
- package/modules/hosts/opencode/commands/wf-gate-checklist.md +0 -77
- package/modules/hosts/opencode/commands/wf-maintain.md +0 -76
- package/modules/hosts/opencode/commands/wf-new-task.md +0 -102
- package/modules/hosts/opencode/commands/wf-pipeline-run.md +0 -35
- package/modules/hosts/opencode/commands/wf-plan.md +0 -40
- package/modules/hosts/opencode/commands/wf-review.md +0 -49
- package/modules/hosts/opencode/commands/wf-sync-hosts.md +0 -64
- package/modules/hosts/opencode/commands/wf-test.md +0 -68
- package/modules/hosts/trae/agents/implementer.md +0 -52
- package/modules/hosts/trae/agents/independent-reviewer.md +0 -51
- package/modules/hosts/trae/agents/ui-verifier.md +0 -50
- package/modules/hosts/trae/commands/wf-build.md +0 -70
- package/modules/hosts/trae/commands/wf-deploy.md +0 -59
- package/modules/hosts/trae/commands/wf-design.md +0 -50
- package/modules/hosts/trae/commands/wf-gate-checklist.md +0 -78
- package/modules/hosts/trae/commands/wf-maintain.md +0 -77
- package/modules/hosts/trae/commands/wf-new-task.md +0 -103
- package/modules/hosts/trae/commands/wf-pipeline-run.md +0 -36
- package/modules/hosts/trae/commands/wf-plan.md +0 -41
- package/modules/hosts/trae/commands/wf-review.md +0 -50
- package/modules/hosts/trae/commands/wf-sync-hosts.md +0 -65
- package/modules/hosts/trae/commands/wf-test.md +0 -69
- package/modules/hosts/trae/hooks/post-edit-check.cjs +0 -98
- package/modules/hosts/trae/hooks/pre-shell-check.cjs +0 -192
- package/modules/hosts/trae/hooks/resolve-shell.cjs +0 -30
- package/modules/hosts/trae/hooks.json +0 -29
- package/modules/hosts/trae/rules/beautify-input-chinese.md +0 -6
- package/modules/hosts/trae/rules/git-commit-message.md +0 -10
- package/modules/hosts/trae/rules/project-workflow.md +0 -14
- package/modules/hosts/zcode/agents/implementer.md +0 -51
- package/modules/hosts/zcode/agents/independent-reviewer.md +0 -49
- package/modules/hosts/zcode/agents/ui-verifier.md +0 -48
- package/src/add-gate.mjs +0 -116
- package/src/add-gate.test.mjs +0 -103
- package/src/add-host.mjs +0 -68
- package/src/cli.mjs +0 -169
- package/src/doctor.mjs +0 -629
- package/src/executor.mjs +0 -262
- package/src/executor.test.mjs +0 -295
- package/src/fresh-init.test.mjs +0 -64
- package/src/gate-dotnet-ca.test.mjs +0 -124
- package/src/gates.test.mjs +0 -143
- package/src/init.mjs +0 -382
- package/src/init.test.mjs +0 -163
- package/src/instance-ref.test.mjs +0 -62
- package/src/jscpd-drift.test.mjs +0 -144
- package/src/pack.test.mjs +0 -24
- package/src/profiles.mjs +0 -183
- package/src/render.mjs +0 -132
- package/src/rule-budget.test.mjs +0 -103
- package/src/run-tests.mjs +0 -56
- package/src/stack-profile.test.mjs +0 -95
- package/src/sync-hosts.mjs +0 -257
- package/src/sync-hosts.test.mjs +0 -291
- package/src/sync.mjs +0 -228
- package/src/sync.test.mjs +0 -452
- package/src/trae-hooks.test.mjs +0 -127
- package/src/validate.mjs +0 -77
- package/src/validate.test.mjs +0 -95
- package/templates/.gitattributes +0 -17
- package/templates/AGENTS.md +0 -57
- package/templates/_agents/board/index.html +0 -676
- package/templates/_agents/commands/build.md +0 -84
- package/templates/_agents/commands/deploy.md +0 -66
- package/templates/_agents/commands/design.md +0 -63
- package/templates/_agents/commands/gate-checklist.md +0 -91
- package/templates/_agents/commands/maintain.md +0 -90
- package/templates/_agents/commands/new-task.md +0 -110
- package/templates/_agents/commands/pipeline-run.md +0 -43
- package/templates/_agents/commands/plan.md +0 -48
- package/templates/_agents/commands/review.md +0 -62
- package/templates/_agents/commands/sync-hosts.md +0 -77
- package/templates/_agents/commands/test.md +0 -87
- package/templates/_agents/control-surfaces.txt +0 -53
- package/templates/_agents/engine-lock.json +0 -342
- package/templates/_agents/hooks/check-index-incremental.mjs +0 -48
- package/templates/_agents/hooks/check-pairing-incremental.mjs +0 -66
- package/templates/_agents/hooks/check-wiki-ledger.mjs +0 -30
- package/templates/_agents/hooks/commit-check.cjs +0 -193
- package/templates/_agents/hooks/local-pre-commit +0 -6
- package/templates/_agents/lane-surfaces.txt +0 -17
- package/templates/_agents/level-hints.txt +0 -30
- package/templates/_agents/loop/papercut-debt/DESIGN.md +0 -112
- package/templates/_agents/mechanism-registry.md +0 -27
- package/templates/_agents/metric-claims.txt +0 -81
- package/templates/_agents/notes/engine-internals.md +0 -17
- package/templates/_agents/notes/runtime-env.md +0 -18
- package/templates/_agents/roles/implementer.md +0 -47
- package/templates/_agents/roles/independent-reviewer.md +0 -45
- package/templates/_agents/roles/ui-verifier.md +0 -44
- package/templates/_agents/rule-budgets.txt +0 -18
- package/templates/_agents/scripts/agg-delegations.cjs +0 -302
- package/templates/_agents/scripts/agg-delegations.test.mjs +0 -282
- package/templates/_agents/scripts/agg-gate-stats.mjs +0 -113
- package/templates/_agents/scripts/agg-gate-stats.test.mjs +0 -95
- package/templates/_agents/scripts/agg-judgments.mjs +0 -156
- package/templates/_agents/scripts/agg-judgments.test.mjs +0 -93
- package/templates/_agents/scripts/archive-sweep.mjs +0 -235
- package/templates/_agents/scripts/archive-sweep.test.mjs +0 -129
- package/templates/_agents/scripts/check-attribution.mjs +0 -37
- package/templates/_agents/scripts/check-convergence.mjs +0 -124
- package/templates/_agents/scripts/check-engine-integrity.mjs +0 -220
- package/templates/_agents/scripts/check-engine-integrity.test.mjs +0 -215
- package/templates/_agents/scripts/check-funnel.mjs +0 -56
- package/templates/_agents/scripts/check-hygiene.mjs +0 -167
- package/templates/_agents/scripts/check-hygiene.test.mjs +0 -182
- package/templates/_agents/scripts/check-index-incremental.test.mjs +0 -73
- package/templates/_agents/scripts/check-lane-surface.mjs +0 -238
- package/templates/_agents/scripts/check-lane-surface.test.mjs +0 -302
- package/templates/_agents/scripts/check-ledger-invariant.mjs +0 -527
- package/templates/_agents/scripts/check-ledger-invariant.test.mjs +0 -639
- package/templates/_agents/scripts/check-loop-rev.test.mjs +0 -336
- package/templates/_agents/scripts/check-loop-unit.test.mjs +0 -103
- package/templates/_agents/scripts/check-loop.mjs +0 -1958
- package/templates/_agents/scripts/check-loop.sh +0 -6
- package/templates/_agents/scripts/check-loop.test.mjs +0 -3875
- package/templates/_agents/scripts/check-metric-claims.mjs +0 -277
- package/templates/_agents/scripts/check-prejudgment.mjs +0 -64
- package/templates/_agents/scripts/check-registry.mjs +0 -45
- package/templates/_agents/scripts/check-scope.mjs +0 -96
- package/templates/_agents/scripts/check-scope.test.mjs +0 -96
- package/templates/_agents/scripts/check-scripts-syntax.mjs +0 -61
- package/templates/_agents/scripts/check-scripts-syntax.test.mjs +0 -72
- package/templates/_agents/scripts/check-spec-verif.mjs +0 -47
- package/templates/_agents/scripts/check-stage-index.mjs +0 -40
- package/templates/_agents/scripts/check-stage-index.test.mjs +0 -77
- package/templates/_agents/scripts/closeout-l1.mjs +0 -217
- package/templates/_agents/scripts/closeout-l1.test.mjs +0 -105
- package/templates/_agents/scripts/commit-check-trigger.test.mjs +0 -205
- package/templates/_agents/scripts/compact-ledgers.mjs +0 -97
- package/templates/_agents/scripts/compact-ledgers.test.mjs +0 -162
- package/templates/_agents/scripts/confirm-doc.mjs +0 -603
- package/templates/_agents/scripts/confirm-doc.test.mjs +0 -1103
- package/templates/_agents/scripts/doctor.test.mjs +0 -770
- package/templates/_agents/scripts/draft-sediment.mjs +0 -178
- package/templates/_agents/scripts/draft-sediment.test.mjs +0 -272
- package/templates/_agents/scripts/edit-face-check.mjs +0 -109
- package/templates/_agents/scripts/edit-face-check.test.mjs +0 -99
- package/templates/_agents/scripts/ensure-board.mjs +0 -185
- package/templates/_agents/scripts/fill-intent.mjs +0 -91
- package/templates/_agents/scripts/fill-intent.test.mjs +0 -113
- package/templates/_agents/scripts/fill-plan.mjs +0 -79
- package/templates/_agents/scripts/fill-plan.test.mjs +0 -224
- package/templates/_agents/scripts/fill-spec.mjs +0 -70
- package/templates/_agents/scripts/fill-spec.test.mjs +0 -266
- package/templates/_agents/scripts/fixture-scripts.mjs +0 -153
- package/templates/_agents/scripts/fixture-scripts.test.mjs +0 -112
- package/templates/_agents/scripts/gate-checklist.mjs +0 -209
- package/templates/_agents/scripts/gate-checklist.test.mjs +0 -201
- package/templates/_agents/scripts/gate-seg.mjs +0 -54
- package/templates/_agents/scripts/gate-seg.test.mjs +0 -112
- package/templates/_agents/scripts/gen-effective-policy.mjs +0 -107
- package/templates/_agents/scripts/gen-effective-policy.test.mjs +0 -100
- package/templates/_agents/scripts/gen-verify-evidence.mjs +0 -107
- package/templates/_agents/scripts/gen-verify-evidence.test.mjs +0 -84
- package/templates/_agents/scripts/gen-wiki-board.mjs +0 -276
- package/templates/_agents/scripts/gen-wiki-board.test.mjs +0 -249
- package/templates/_agents/scripts/gen-workflow-dashboard.mjs +0 -251
- package/templates/_agents/scripts/gen-workflow-dashboard.test.mjs +0 -188
- package/templates/_agents/scripts/gen-workflow-index.mjs +0 -201
- package/templates/_agents/scripts/gen-workflow-index.test.mjs +0 -152
- package/templates/_agents/scripts/gen-workflow-metrics.mjs +0 -334
- package/templates/_agents/scripts/gen-workflow-metrics.test.mjs +0 -224
- package/templates/_agents/scripts/git-merge-jsonl.mjs +0 -63
- package/templates/_agents/scripts/git-merge-jsonl.test.mjs +0 -125
- package/templates/_agents/scripts/judgment-ledger.mjs +0 -65
- package/templates/_agents/scripts/judgment-ledger.test.mjs +0 -129
- package/templates/_agents/scripts/kb-cache-evict.mjs +0 -50
- package/templates/_agents/scripts/kb-cache-evict.test.mjs +0 -104
- package/templates/_agents/scripts/kb-search.mjs +0 -413
- package/templates/_agents/scripts/kb-search.test.mjs +0 -299
- package/templates/_agents/scripts/lane-surface-audit.mjs +0 -143
- package/templates/_agents/scripts/lane-surface-audit.test.mjs +0 -93
- package/templates/_agents/scripts/ledger-doc-chain.test.mjs +0 -166
- package/templates/_agents/scripts/ledger-loader.mjs +0 -108
- package/templates/_agents/scripts/ledger-loader.test.mjs +0 -131
- package/templates/_agents/scripts/ledger-prune.mjs +0 -96
- package/templates/_agents/scripts/ledger-prune.test.mjs +0 -120
- package/templates/_agents/scripts/ledger-shards.mjs +0 -344
- package/templates/_agents/scripts/ledger-shards.test.mjs +0 -356
- package/templates/_agents/scripts/ledger-ts-monotonic.test.mjs +0 -135
- package/templates/_agents/scripts/level-criteria.mjs +0 -231
- package/templates/_agents/scripts/level-criteria.test.mjs +0 -281
- package/templates/_agents/scripts/mechanism-retire-watch.mjs +0 -183
- package/templates/_agents/scripts/mechanism-retire-watch.test.mjs +0 -114
- package/templates/_agents/scripts/papercut-debt-controller.mjs +0 -141
- package/templates/_agents/scripts/papercut-debt-controller.test.mjs +0 -127
- package/templates/_agents/scripts/papercut-debt-sensor.mjs +0 -170
- package/templates/_agents/scripts/papercut-debt-sensor.test.mjs +0 -146
- package/templates/_agents/scripts/pipeline-run-docs.mjs +0 -76
- package/templates/_agents/scripts/pipeline-run-run.mjs +0 -63
- package/templates/_agents/scripts/pipeline-run.mjs +0 -867
- package/templates/_agents/scripts/pipeline-run.test.mjs +0 -517
- package/templates/_agents/scripts/policy.mjs +0 -281
- package/templates/_agents/scripts/pre-push.test.mjs +0 -105
- package/templates/_agents/scripts/resolve-merge-conflicts.mjs +0 -110
- package/templates/_agents/scripts/resolve-merge-conflicts.test.mjs +0 -87
- package/templates/_agents/scripts/rewrite-file.mjs +0 -133
- package/templates/_agents/scripts/rewrite-file.test.mjs +0 -148
- package/templates/_agents/scripts/rule-budget.mjs +0 -96
- package/templates/_agents/scripts/rule-budget.test.mjs +0 -118
- package/templates/_agents/scripts/run-tests.mjs +0 -99
- package/templates/_agents/scripts/run-tests.test.mjs +0 -105
- package/templates/_agents/scripts/solidify-task.mjs +0 -107
- package/templates/_agents/scripts/solidify-task.test.mjs +0 -129
- package/templates/_agents/scripts/stage-gates.mjs +0 -343
- package/templates/_agents/scripts/stage-gates.test.mjs +0 -105
- package/templates/_agents/scripts/trust-mode.mjs +0 -67
- package/templates/_agents/scripts/trust-mode.test.mjs +0 -110
- package/templates/_agents/scripts/verify-wiki-consistency.mjs +0 -253
- package/templates/_agents/scripts/verify-wiki-consistency.test.mjs +0 -123
- package/templates/_agents/scripts/verify.mjs +0 -210
- package/templates/_agents/scripts/verify.test.mjs +0 -358
- package/templates/_agents/scripts/wf-journal.mjs +0 -231
- package/templates/_agents/scripts/wf-journal.test.mjs +0 -216
- package/templates/_agents/scripts/wiki-search.mjs +0 -19
- package/templates/_agents/scripts/wiki-search.test.mjs +0 -57
- package/templates/_agents/scripts/workflow-board-server.mjs +0 -393
- package/templates/_agents/scripts/workflow-board-server.test.mjs +0 -201
- package/templates/_agents/scripts/workflow-enums.mjs +0 -70
- package/templates/_agents/scripts/workflow-enums.test.mjs +0 -118
- package/templates/_agents/scripts/workflows-check.mjs +0 -260
- package/templates/_agents/scripts/workflows-check.test.mjs +0 -278
- package/templates/_agents/scripts-test-exempt.txt +0 -16
- package/templates/_agents/skills/papercut-fix/SKILL.md +0 -60
- package/templates/_agents/skills/papercut-fix/references/response-template.md +0 -81
- package/templates/_agents/skills/review-method/SKILL.md +0 -55
- package/templates/_agents/skills/verify-ui/SKILL.md +0 -61
- package/templates/_agents/skills/wiki/SKILL.md +0 -106
- package/templates/_agents/workflow-enums.txt +0 -26
- package/templates/_agents/workflow-modules.txt +0 -11
- package/templates/_agents/workflows/_TEMPLATE.md +0 -75
- package/templates/_agents/workflows/pipeline-closing.md +0 -28
- package/templates/_agents/workflows//347/244/272/344/276/213-/345/271/266/350/241/214/345/256/236/347/216/260/350/257/204/345/256/241.md +0 -16
- package/templates/_githooks/commit-msg +0 -17
- package/templates/_githooks/post-commit +0 -10
- package/templates/_githooks/pre-commit +0 -126
- package/templates/_githooks/pre-merge-commit +0 -29
- package/templates/_githooks/pre-push +0 -136
- package/templates/_github/workflows/kit-ci.yml +0 -49
- package/templates/wiki/INDEX.md +0 -73
- package/templates/wiki/drafts-archive/README.md +0 -3
- package/templates/wiki//344/272/247/345/223/201/351/234/200/346/261/202/README.md +0 -3
- package/templates/wiki//345/274/200/345/217/221/346/226/271/346/241/210/README.md +0 -3
- package/templates/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md +0 -3
- package/templates/wiki//346/265/213/350/257/225/346/212/245/345/221/212/README.md +0 -3
- package/templates/wiki//347/224/250/346/210/267/345/212/237/350/203/275/README.md +0 -3
- package/templates/wiki//347/237/245/350/257/206/346/262/211/346/267/200/346/200/273/350/247/210.html +0 -77
- package/templates/wiki//351/241/271/347/233/256/350/247/204/350/214/203/README.md +0 -3
- package/templates/wiki//351/241/271/347/233/256/350/256/241/345/210/222/README.md +0 -3
- package/templates/workflow/README.md +0 -90
- package/templates/workflow/delegations.md +0 -29
- package/templates/workflow/incidents/_TEMPLATE.md +0 -51
- package/templates/workflow/intents/_TEMPLATE.md +0 -46
- package/templates/workflow/papercuts.md +0 -9
- package/templates/workflow/plans/_TEMPLATE.md +0 -47
- package/templates/workflow/regression-checklist.md +0 -23
- package/templates/workflow/specs/_TEMPLATE.md +0 -80
- /package/templates/{_agents → engine/.agents}/board/marked.min.js +0 -0
- /package/templates/{_agents/workflows → engine/.agents/pipelines}/steps//347/244/272/344/276/213-/351/203/250/347/275/262/351/252/214/350/257/201.md" +0 -0
- /package/templates/{_agents → engine/.agents}/scripts/git-core.mjs +0 -0
|
File without changes
|
|
File without changes
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# 数据维护台账
|
|
2
|
+
|
|
3
|
+
本目录登记全项目数据维护 SQL 与执行状态,按阶段分类:
|
|
4
|
+
|
|
5
|
+
| 目录 | 用途 |
|
|
6
|
+
|---|---|
|
|
7
|
+
| `schema变更/` | 表结构变更(DDL),每个批次一个 `日期-主题/` 子目录 |
|
|
8
|
+
| `数据修复/` | 存量数据修复(DML),须写明影响行数与回滚口径 |
|
|
9
|
+
| `数据导入/` | 外部数据导入脚本与映射说明 |
|
|
10
|
+
| `查询/` | 只读排查 SQL |
|
|
11
|
+
| `备份/` | 备份与恢复脚本 |
|
|
12
|
+
|
|
13
|
+
## 硬约束
|
|
14
|
+
|
|
15
|
+
- 新增 SQL 必须登记执行状态与授权来源。
|
|
16
|
+
- 禁止无 `WHERE` 的全表 `DELETE` / `UPDATE`。
|
|
17
|
+
- 执行生产 SQL 属不可逆操作,须用户明确授权,且按项目数据维护台账与 DB 验证口径走。
|
|
18
|
+
- 脚本与台账示例见 `_TEMPLATE.md`(若存在)。
|
|
19
|
+
|
|
20
|
+
## 生成物
|
|
21
|
+
|
|
22
|
+
`README.md` 由本目录协议维护;具体批次清单以子目录与 git 历史为准。
|
|
File without changes
|
|
File without changes
|
|
@@ -0,0 +1,230 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="zh-CN">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8" />
|
|
5
|
+
<title>知识沉淀总览 · {{projectName}}</title>
|
|
6
|
+
<style>
|
|
7
|
+
:root {
|
|
8
|
+
--bg: #f7f8fb;
|
|
9
|
+
--card: #ffffff;
|
|
10
|
+
--border: #e6e8ee;
|
|
11
|
+
--text: #1f2937;
|
|
12
|
+
--muted: #6b7280;
|
|
13
|
+
--accent: #2563eb;
|
|
14
|
+
--accent-soft: #eff4ff;
|
|
15
|
+
--warn: #d97706;
|
|
16
|
+
--shadow: 0 1px 2px rgba(0,0,0,.04), 0 4px 16px rgba(0,0,0,.04);
|
|
17
|
+
}
|
|
18
|
+
* { box-sizing: border-box; }
|
|
19
|
+
body {
|
|
20
|
+
margin: 0;
|
|
21
|
+
font-family: -apple-system, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
|
|
22
|
+
background: var(--bg);
|
|
23
|
+
color: var(--text);
|
|
24
|
+
line-height: 1.5;
|
|
25
|
+
}
|
|
26
|
+
header {
|
|
27
|
+
padding: 32px 40px 16px;
|
|
28
|
+
background: linear-gradient(135deg, #1e3a8a 0%, #2563eb 100%);
|
|
29
|
+
color: #fff;
|
|
30
|
+
}
|
|
31
|
+
header h1 { margin: 0 0 4px; font-size: 24px; font-weight: 600; }
|
|
32
|
+
header .meta { opacity: .85; font-size: 13px; }
|
|
33
|
+
main { max-width: 1400px; margin: 0 auto; padding: 24px 40px 64px; }
|
|
34
|
+
.summary {
|
|
35
|
+
display: grid;
|
|
36
|
+
grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
|
|
37
|
+
gap: 12px;
|
|
38
|
+
margin-bottom: 24px;
|
|
39
|
+
}
|
|
40
|
+
.stat {
|
|
41
|
+
background: var(--card);
|
|
42
|
+
border: 1px solid var(--border);
|
|
43
|
+
border-radius: 10px;
|
|
44
|
+
padding: 14px 16px;
|
|
45
|
+
box-shadow: var(--shadow);
|
|
46
|
+
}
|
|
47
|
+
.stat .num { font-size: 22px; font-weight: 600; color: var(--accent); }
|
|
48
|
+
.stat .lbl { font-size: 12px; color: var(--muted); margin-top: 2px; }
|
|
49
|
+
.toolbar {
|
|
50
|
+
display: flex;
|
|
51
|
+
gap: 8px;
|
|
52
|
+
margin-bottom: 12px;
|
|
53
|
+
flex-wrap: wrap;
|
|
54
|
+
align-items: center;
|
|
55
|
+
}
|
|
56
|
+
.toolbar input {
|
|
57
|
+
flex: 1 1 280px;
|
|
58
|
+
max-width: 480px;
|
|
59
|
+
padding: 8px 12px;
|
|
60
|
+
border: 1px solid var(--border);
|
|
61
|
+
border-radius: 8px;
|
|
62
|
+
font-size: 13px;
|
|
63
|
+
background: var(--card);
|
|
64
|
+
}
|
|
65
|
+
.toolbar select {
|
|
66
|
+
padding: 8px 12px;
|
|
67
|
+
border: 1px solid var(--border);
|
|
68
|
+
border-radius: 8px;
|
|
69
|
+
font-size: 13px;
|
|
70
|
+
background: var(--card);
|
|
71
|
+
}
|
|
72
|
+
.topic-section {
|
|
73
|
+
background: var(--card);
|
|
74
|
+
border: 1px solid var(--border);
|
|
75
|
+
border-radius: 12px;
|
|
76
|
+
margin-bottom: 16px;
|
|
77
|
+
overflow: hidden;
|
|
78
|
+
box-shadow: var(--shadow);
|
|
79
|
+
}
|
|
80
|
+
.topic-header {
|
|
81
|
+
padding: 12px 16px;
|
|
82
|
+
background: var(--accent-soft);
|
|
83
|
+
display: flex;
|
|
84
|
+
align-items: center;
|
|
85
|
+
justify-content: space-between;
|
|
86
|
+
cursor: pointer;
|
|
87
|
+
user-select: none;
|
|
88
|
+
}
|
|
89
|
+
.topic-header:hover { background: #e0ebff; }
|
|
90
|
+
.topic-header .name { font-weight: 600; color: var(--accent); font-size: 15px; }
|
|
91
|
+
.topic-header .count {
|
|
92
|
+
background: var(--accent);
|
|
93
|
+
color: #fff;
|
|
94
|
+
border-radius: 12px;
|
|
95
|
+
padding: 2px 10px;
|
|
96
|
+
font-size: 12px;
|
|
97
|
+
font-weight: 500;
|
|
98
|
+
}
|
|
99
|
+
table {
|
|
100
|
+
width: 100%;
|
|
101
|
+
border-collapse: collapse;
|
|
102
|
+
font-size: 13px;
|
|
103
|
+
}
|
|
104
|
+
thead th {
|
|
105
|
+
text-align: left;
|
|
106
|
+
padding: 10px 16px;
|
|
107
|
+
background: #fafbfd;
|
|
108
|
+
border-bottom: 1px solid var(--border);
|
|
109
|
+
color: var(--muted);
|
|
110
|
+
font-weight: 500;
|
|
111
|
+
font-size: 12px;
|
|
112
|
+
text-transform: uppercase;
|
|
113
|
+
letter-spacing: .04em;
|
|
114
|
+
}
|
|
115
|
+
tbody td {
|
|
116
|
+
padding: 8px 16px;
|
|
117
|
+
border-bottom: 1px solid #f0f2f5;
|
|
118
|
+
vertical-align: top;
|
|
119
|
+
}
|
|
120
|
+
tbody tr:last-child td { border-bottom: none; }
|
|
121
|
+
tbody tr:hover { background: #fafbff; }
|
|
122
|
+
td.file { font-family: "SF Mono", Consolas, monospace; font-size: 12.5px; color: #111827; }
|
|
123
|
+
td.file a { color: var(--accent); text-decoration: none; }
|
|
124
|
+
td.file a:hover { text-decoration: underline; }
|
|
125
|
+
td.topic-cell { color: var(--muted); }
|
|
126
|
+
td.dir a {
|
|
127
|
+
color: var(--accent);
|
|
128
|
+
text-decoration: none;
|
|
129
|
+
font-family: "SF Mono", Consolas, monospace;
|
|
130
|
+
font-size: 12px;
|
|
131
|
+
}
|
|
132
|
+
td.dir a:hover { text-decoration: underline; }
|
|
133
|
+
footer { padding: 24px 40px; color: var(--muted); font-size: 12px; text-align: center; }
|
|
134
|
+
</style>
|
|
135
|
+
</head>
|
|
136
|
+
<body>
|
|
137
|
+
<header>
|
|
138
|
+
<h1>知识沉淀总览</h1>
|
|
139
|
+
<div class="meta">{{projectName}} · 项目知识沉淀</div>
|
|
140
|
+
</header>
|
|
141
|
+
|
|
142
|
+
<main>
|
|
143
|
+
<div class="summary" id="summary"></div>
|
|
144
|
+
|
|
145
|
+
<div class="toolbar">
|
|
146
|
+
<input type="text" id="search" placeholder="🔍 搜索文件名 / 主题 / 归属目录…" />
|
|
147
|
+
<select id="topicFilter">
|
|
148
|
+
<option value="">全部主题</option>
|
|
149
|
+
</select>
|
|
150
|
+
</div>
|
|
151
|
+
|
|
152
|
+
<div id="topics"></div>
|
|
153
|
+
</main>
|
|
154
|
+
|
|
155
|
+
<footer>看板由 wiki 技能生成 · 原始数据见 wiki/INDEX.md</footer>
|
|
156
|
+
|
|
157
|
+
<script>
|
|
158
|
+
const DATA = {
|
|
159
|
+
"summary": { "total": 0, "topics": 0, "files": 0, "archive": 0 },
|
|
160
|
+
"topics": []
|
|
161
|
+
};
|
|
162
|
+
|
|
163
|
+
// 顶部统计卡片
|
|
164
|
+
document.getElementById('summary').innerHTML = `
|
|
165
|
+
<div class="stat"><div class="num">${DATA.summary.topics}</div><div class="lbl">主题数</div></div>
|
|
166
|
+
<div class="stat"><div class="num">${DATA.summary.files}</div><div class="lbl">知识文档</div></div>
|
|
167
|
+
<div class="stat"><div class="num">${DATA.summary.archive}</div><div class="lbl">草稿归档</div></div>
|
|
168
|
+
<div class="stat"><div class="num">${DATA.topics.reduce((s,t)=>s+t.files.length,0)}</div><div class="lbl">合计记录</div></div>
|
|
169
|
+
`;
|
|
170
|
+
|
|
171
|
+
// 主题过滤器
|
|
172
|
+
const sel = document.getElementById('topicFilter');
|
|
173
|
+
DATA.topics.forEach(t => {
|
|
174
|
+
const o = document.createElement('option');
|
|
175
|
+
o.value = t.name; o.textContent = `${t.name} (${t.files.length})`;
|
|
176
|
+
sel.appendChild(o);
|
|
177
|
+
});
|
|
178
|
+
|
|
179
|
+
function escapeHtml(s){ return String(s).replace(/[&<>"]/g, c => ({'&':'&','<':'<','>':'>','"':'"'}[c])); }
|
|
180
|
+
|
|
181
|
+
function render(filterText='', topicFilter='') {
|
|
182
|
+
const container = document.getElementById('topics');
|
|
183
|
+
container.innerHTML = '';
|
|
184
|
+
DATA.topics
|
|
185
|
+
.filter(t => !topicFilter || t.name === topicFilter)
|
|
186
|
+
.forEach(t => {
|
|
187
|
+
const rows = t.files.filter(f =>
|
|
188
|
+
!filterText ||
|
|
189
|
+
f.file.toLowerCase().includes(filterText.toLowerCase()) ||
|
|
190
|
+
f.topic.toLowerCase().includes(filterText.toLowerCase()) ||
|
|
191
|
+
f.dir.toLowerCase().includes(filterText.toLowerCase())
|
|
192
|
+
);
|
|
193
|
+
if (rows.length === 0) return;
|
|
194
|
+
const section = document.createElement('div');
|
|
195
|
+
section.className = 'topic-section';
|
|
196
|
+
section.innerHTML = `
|
|
197
|
+
<div class="topic-header">
|
|
198
|
+
<span class="name">📁 ${escapeHtml(t.name)}</span>
|
|
199
|
+
<span class="count">${rows.length}</span>
|
|
200
|
+
</div>
|
|
201
|
+
<table>
|
|
202
|
+
<thead><tr><th style="width:40%">文件名</th><th style="width:20%">主题</th><th>归属目录</th></tr></thead>
|
|
203
|
+
<tbody>
|
|
204
|
+
${rows.map(f => {
|
|
205
|
+
const base = f.file.split('/').pop();
|
|
206
|
+
const fileCell = /\.(html)$/i.test(f.file)
|
|
207
|
+
? `<td class="file"><a href="${escapeHtml(f.dir + base)}" target="_blank" title="打开文档">${escapeHtml(f.file)}</a></td>`
|
|
208
|
+
: `<td class="file">${escapeHtml(f.file)}</td>`;
|
|
209
|
+
return `
|
|
210
|
+
<tr>
|
|
211
|
+
${fileCell}
|
|
212
|
+
<td class="topic-cell">${escapeHtml(f.topic)}</td>
|
|
213
|
+
<td class="dir"><a href="${escapeHtml(f.dir)}" title="打开目录">${escapeHtml(f.dir)}</a></td>
|
|
214
|
+
</tr>`;
|
|
215
|
+
}).join('')}
|
|
216
|
+
</tbody>
|
|
217
|
+
</table>`;
|
|
218
|
+
container.appendChild(section);
|
|
219
|
+
});
|
|
220
|
+
if (!container.innerHTML) {
|
|
221
|
+
container.innerHTML = '<div class="topic-section" style="padding:24px;text-align:center;color:var(--muted)">无匹配记录</div>';
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
document.getElementById('search').addEventListener('input', e => render(e.target.value, sel.value));
|
|
226
|
+
sel.addEventListener('change', e => render(document.getElementById('search').value, e.target.value));
|
|
227
|
+
render();
|
|
228
|
+
</script>
|
|
229
|
+
</body>
|
|
230
|
+
</html>
|
|
File without changes
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# workflow 索引(生成物,勿手改)
|
|
2
|
+
|
|
3
|
+
> 由 `node .agents/scripts/gen-workflow-index.mjs` 从 `workflow/{intents,specs,plans,incidents}/` 重生成。
|
|
4
|
+
> 本文件为新装户占位;首次生成后自动填充活跃层与档案表。
|
|
5
|
+
|
|
6
|
+
## 活跃(0)
|
|
7
|
+
|
|
8
|
+
| 类型 | 级别 | 状态 | 日期 | 模块 | 主题 | 进度 |
|
|
9
|
+
|---|---|---|---|---|---|---|
|
|
10
|
+
|
|
11
|
+
## 档案(只读,不增量)
|
|
12
|
+
|
|
13
|
+
(历史终态件归档后由生成器列出。)
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# workflow — AI 驱动闭环流程(唯一真相源)
|
|
2
|
+
|
|
3
|
+
本目录是 AI 工作流引擎的唯一载体。L1 新需求以一份 plan 为入口;L2/L3 新需求走 intent → spec → plan;修复走 incident。微观任务层采用「任务责任人(Task Owner)+ AI 结对闭环」,确认在对话内一句话完成(TTY / 委托代录);宏观主干层支持多人协作协同,主干(main)合并由 TFS PR 分支策略(Peer Review 团队评审 + 与本地脚本同源的 Azure Pipelines CI 门禁)把关,追溯靠 git(commit + PR 记录 + release tag)。
|
|
4
|
+
|
|
5
|
+
> 闭环新增记录一律写在本目录。
|
|
6
|
+
|
|
7
|
+
## 目录结构
|
|
8
|
+
|
|
9
|
+
| 目录 | 放什么 | 命名 |
|
|
10
|
+
|------|--------|------|
|
|
11
|
+
| `intents/` | L2/L3 新需求入口:背景、目标/非目标、验收标准、级别、触达红线。L1 新需求不建 | `YYYY-MM-DD-<主题>.md` |
|
|
12
|
+
| `specs/` | L2/L3 设计规格:功能行为、数据流、系统改动、约束遵守映射。L1 不建 | 与 intent / incident 同名 |
|
|
13
|
+
| `plans/` | L1 新需求入口(来源 / 目标 / 红线 / 改动方案 / 约束与风险 / 验证计划 / 验收标准)。L2/L3 与修复仍与 intent / incident 同名 | `YYYY-MM-DD-<主题>.md` |
|
|
14
|
+
| `incidents/` | 事故复盘:时间线、根因、为什么没拦住、复盘三件套 | `YYYY-MM-DD-<主题>.md` |
|
|
15
|
+
|
|
16
|
+
**命名一律英文 kebab-case**(如 `2026-09-07-supplier-rating-field.md`),**禁中文文件名**——原 check-loop §9 非 ASCII 文件名 warning 已随 2026-10-28 引擎减重退役,命名约定不变。文档内容(标题/正文)不受此限。
|
|
17
|
+
|
|
18
|
+
**文档协议(2026-09-13 结构化)**:四类文档头部一律为 YAML frontmatter(受限子集,每行 `键: 值`,附 check-loop 机器字段唯一来源)——`状态`(intent/spec/plan:draft/approved/done/superseded/cancelled;incident:open/fixed/closed,**严格枚举**,附注写 `备注:` 键)、`级别`(L1/L2/L3)、`日期`/`发现`(YYYY-MM-DD)、`模块`(**2026-09-22 起新建文档必填**,取值见 `.agents/config/workflow-modules.txt` 词表,单值取主导模块;存量不回填,AI 触碰时顺手补)、L3 spec 的 `确认结果`/`确认时间`、回填件 `流程: legacy`。**`日期` 兜底口径(2026-10-27 修)**:plan 由 `fill-plan.mjs` 与 `plans/_TEMPLATE.md` 生成,**2026-10-27 起 frontmatter 写入 `日期`**(此前 renderPlan 收了 date 参数却不落盘)——凡以 frontmatter `日期` 为适用前提的门(委派台账在场门;检查 18 已随 2026-10-28 引擎减重退役),日期缺省时仍**回落文件名前缀** `YYYY-MM-DD` 作为第二道保险(沿检查 15 既有口径;检查 19 已退役);frontmatter 与文件名皆无日期 → 不可判定 → 跳过。旧口径「无日期即整段跳过」曾使委派门对绝大多数 L2/L3 plan 静默失效(实测 52 份锚后 L2/L3 终态件从未被对账)。**`状态` 迁移须经 `approved`**(确认环节的机器可见态,`done` 只在关单出现):2026-09-23 起新建的 spec/plan 若已 done 而 git 历史中从未出现行首 `状态: approved`,check-loop 报「确认态缺失」warning。check-loop 只扫 frontmatter 取机器字段(`fm_get` 字段断言),正文不再写「状态:/级别:」行;叙述性字段(独立复核/复盘三件套/验收勾验)仍留正文按节锚定。协议变更与存量迁移见 2026-09-13 `docs(workflow)` 提交。**模糊点显式阻断(2026-10-16,NEEDS-CLARIFICATION 标记)**:spec/plan 起草或修订遇无法自行决策的模糊点(多种解释 / 口径缺失 / 依赖外部事实)**禁止脑补**——原地插入 `[NEEDS CLARIFICATION]: <一句话问题>` 向用户求澄清,澄清后删除标记并把决策落为正文;状态推进 approved 前标记须清零(自检纪律;活跃件 grep 该标记即待澄清清单。跨产物断层自动体检延后——与「暂缓加门」取舍的冲突已显式登记,D6 度量补齐后再议)。**承诺面绑定(2026-10-27 新增)**:用户在 approved 那一刻点头的是**承诺面**(判据文本 / 红线 / 目标 / 改动方案 / 约束与风险)——承诺在确认后被改写而未重新点头 = 用户点头的不是关单时兑现的那一份。关单期合法动作(勾验收 + 证据回填、`确认结果`/`确认时间` 回填、复核行改锚)**不改承诺面**,经归一后不误伤;承诺判据被改写则 hard 拦(检查 15)+ 关单时刻拒收(confirm-doc 承诺面绑定门)。改承诺的**唯一出路** = 用户重新点头后跑 `confirm-doc <doc> --reconfirm --delegated "<原话>"` 重录承诺面指纹(不推进状态,状态行仍由 confirm-doc 写,不手改 frontmatter);存量(上线前确认、台账行无 `commit` 字段)不追溯。**改已关单正文须同笔重录指纹(2026-11-10,incident 2026-10-26-workflow-confirmation-drift-hard-block)**:改已关单(done/superseded/closed/cancelled/fixed)文档正文 = 须同笔重录确认指纹(`confirm-doc` / `--reconfirm`)或走补偿行(`append-compensation.mjs`),否则 check-loop 判「确认内容漂移」;提交期有 `check-doc-body-drift.mjs` advisory 可见性(不合门)。
|
|
19
|
+
|
|
20
|
+
各子目录内 `_TEMPLATE.md` 为起步模板,复制后填写,不直接改动模板本身。
|
|
21
|
+
|
|
22
|
+
根目录 `regression-checklist.md` 为**活文档回归清单**:deploy 回归必过条目与 incident 防复发验证的统一落点,随模块上线补充、随 incident 追加。
|
|
23
|
+
|
|
24
|
+
**三份 append-only 台账已分片**(2026-10-13 ledger-shard-ledgers):`regression-checklist` / `delegations` / `papercuts` 的数据行按月存 `workflow/<台账>.d/<YYYY-MM>.md`,主台账只留说明、表头与 GENERATED 区——消除「每次追加全量重写整文件」的体积与合并冲突面。读写单源 = `.agents/scripts/ledger-shards.mjs`(读侧自动合并主台账 ∪ 全部分片,既有消费者无需改动);追加一行用 `node .agents/scripts/ledger-shards.mjs --append <台账> --row "<行>"`。(第四份 `deploy-observations` 已随 deploy 仪式退役删除——2026-10-29 owner 拍板:实际发布不走 tag/24h 观察仪式,合入 = PR 创建→审查→回归→合并→归档,见 `deploy.md` 头注。)confirmations.d 分片始于 2026-10,2026-09 无分片(该月确认仅 git 口径可溯,历史缺口不回补);jsonl 各台账 schema 代际以字段有无自描述(如 quoteGrounding 自 2026-10-24 起),不设版本字段(2026-11-05 决策)。
|
|
25
|
+
|
|
26
|
+
**门禁判定月度分片**(2026-10-22 gate-metrics-shard):`workflow/gate-metrics.d/<YYYY-MM>.jsonl` 每月一行(规则 × WARN/BLOCK),由 `node .agents/scripts/agg-judgments.mjs --emit-month` 生成、随提交入库;pre-push 月检自动补生成上月分片。退役判据(连续 N 月 = 0)读「本地 `.agents/judgments.jsonl` ∪ 分片」取 max——换机/换 worktree 不再归零,多机并集(`.gitattributes` 复用 `jsonl-union`)。
|
|
27
|
+
|
|
28
|
+
## 使用方式
|
|
29
|
+
|
|
30
|
+
- **发起新任务**:执行 `.agents/commands/new-task.md`(定级 + L0 极简道 / L1 快速道总入口);L2/L3 进 `.agents/commands/stages.md` 四章(Plan → Design → Build → Test,2026-11-08 档 2-F 四并一)
|
|
31
|
+
- **看板(可选,默认不拉起)**:需要时手动跑 `node .agents/scripts/ensure-board.mjs`(幂等:探活 / 旧代码自动重启 / 全新启动弹浏览器),实时只读 http://127.0.0.1:8933;**预警层,非门禁;告警口径对齐 check-loop 硬断档**。「旧代码」=`board/index.html` 或 `workflow-board-server.mjs` 的 LastWriteTime 晚于看板进程启动 2s(任一更新即重启);端口被占用时先探活 `/api/board`——响应不含 `cards` 即判为他人进程,不动手不 kill、跳过试下一端口
|
|
32
|
+
- **检索**:活跃流程读 `INDEX.md`(生成物,`node .agents/scripts/gen-workflow-index.mjs` 重生成、`--check` 校验漂移);跨语料检索 `node .agents/scripts/kb-search.mjs "<词>"`(workflow 按节级定位 + wiki 全文,`--type/--module/--status/-n` 过滤;`--status all` 显式全量)
|
|
33
|
+
- **归档**:关单即归档(2026-10-13 archive-on-close)——`confirm-doc.mjs` 落终态后自动把**本次确认涉及的家族**(同名 intent/spec/plan/incident 整族)`git mv` 进 `workflow/archive/<终态月>/{类型}/`,活跃目录不再累积终态件。**特性分支默认不归档**(2026-10-15 起,防 CI 泳道门拦合法合并)——合并后由 main/develop 关单或 sweep 承接,未满 21 天窗的滞留属正常态。历史积压用 `node .agents/scripts/archive-sweep.mjs [--window 21] [--execute]`(缺省 dry-run)手工批次清理;归档件仍可被 `kb-search` 检索(`archive/<批次>/<type>` 已覆盖),check-loop 配对门与内容绑定只扫四目录直下、对归档件不触发。终态件积压时人工月度跑一轮 archive-sweep(dry-run 先看候选,`--execute` 执行)。
|
|
34
|
+
- **spec 生命周期口径(2026-10-16 owner 拍板,Böckeler 三层分类取 spec-anchored + 长期维护)**:spec 是**持续对照的事实源,交付后不失效**——代码改动触及某 spec 覆盖的行为时须对照该 spec(含归档件):行为漂移要么改代码回到 spec,要么同一提交回改 spec;有争议立 incident 裁决。**归档是容量治理不是失效**:归档只把终态件移出活跃扫描面(INDEX 活跃行 / check-loop 四目录扫描 / 月度再生),事实源地位与修订权不变——归档 spec 可原地修订,修订不改归档位置。体积治理先观察后设限:spec 行数/验收条数分布由 metrics.md 观察列采集(advisory 上限与「暂缓加门」取舍冲突,显式延后至 D6 度量补齐后再议)。
|
|
35
|
+
- **同功能续作(先查后建,2026-10-22)**:动工前按「模块 + 功能关键词」检索 `workflow/specs/`、`workflow/archive/**/specs/`、`.agents/skills/verify-ui/features/`、`workflow/regression-checklist.md`。命中覆盖同一行为 → 在原件上修订(spec 按上条口径原地改,不新建);确属新特性才新建。新建任务文档时 topic 带特性键,便于后续检索。
|
|
36
|
+
- **验证**:`.agents/commands/stages.md` Test 章(静态门 + UI 实测);切库探活与 API 防复发断言跑 `node scripts/verify/business/regression-smoke.mjs`(默认只读;`--writes` 自建自清探针,仅 dev 库)
|
|
37
|
+
- **评审**:`.agents/commands/review.md`(按 P0 / P1 / P2 分级:机器兜底 + AI 自查出清单,用户决策定性与合入)
|
|
38
|
+
- **PR 面板评审**:面板已退役为**手动工具**(2026-11-09 自动门退役)——pre-push / CI / pr-create 不再强制评审台账,需要时按 `.agents/commands/pr-review.md` 手动编排;建 PR 走 `node .agents/scripts/pr-create.mjs ...`(先 gate 再调 `tfs-pr create`)
|
|
39
|
+
- **上线**:`.agents/commands/deploy.md`(上线前必跑清单)
|
|
40
|
+
- **量化**:委派/自做结果记 `delegations.md`,聚合跑 `node .agents/scripts/agg-delegations.mjs`(**并发扩容门槛见该文件——数字达标前不扩并发**);语料与常驻面体积的**月度快照**跑 `node .agents/scripts/gen-workflow-metrics.mjs`(每月一行落 `metrics.md`,同月重跑即更新;明细看 stdout)
|
|
41
|
+
- **追溯**:git 即审计。两条驱动路径二选一、禁混用——手动阶段路由(确认后的 workflow 文档用 `docs(workflow)` 收成一笔,代码提交另笔;L1 普通需求只有 plan,修复为 incident+plan,L2/L3 为入口+spec+plan)或 `pipeline-run` 状态机(按阶段 `docsCommit` 落同形态提交,驱动协议单源 `.agents/commands/pipeline-run.md`)。上线不走 tag/24h 观察仪式(release tag 与发布观察台账已退役,2026-10-29)。本地开发依靠 Independent Reviewer 做认知隔离自查,主干合并通过 TFS PR 团队评审与 git 历史形成完整审计证据
|
|
42
|
+
- **级别**:L1 实现级(未命中 L2/L3;新需求的入口是 plan)| L2 规则 / 契约(编码权威 / 共享契约 / 既有接口语义 / 全局横切口径,触达面闭集见 `.agents/commands/new-task.md`)| L3 数据与运行时结构(schema / 迁移 SQL / DI 链 / 认证与中间件管线)。混合改动就高不就低
|
|
43
|
+
|
|
44
|
+
## 执行模型
|
|
45
|
+
|
|
46
|
+
- 默认宿主主智能体负责阶段路由、用户确认、关键判断和最终验收,不注册为额外角色。
|
|
47
|
+
- 阶段命令仅在边界明确时委派 `.agents/roles/implementer.md`、`.agents/roles/independent-reviewer.md`、`.agents/roles/ui-verifier.md`。
|
|
48
|
+
- OpenCode、Trae、ZCode 分别通过 `.opencode/agents/`、`.trae/agents/`、`.zcode/agents/` 下的薄 Adapter 注册角色;角色行为只维护在 `.agents/roles/`。
|
|
49
|
+
- PI 通过 `.pi/agents/` 注册 7 篇角色薄壳(契约同 `.agents/roles/`);`.pi/extensions/` 把 tool_call 接到 `.agents/hooks/` 两门,判据单源不复制。`.pi/` 为本机私有目录(`.gitignore`),不随 clone 传播;阶段命令按根 `AGENTS.md` §4 路由表由主 Agent 直读 `.agents/commands/*.md`(pi 无 wf-* 命令壳),接线实态由 `check-local-gates.mjs` advisory 对账,机理见 `runtime-env.md` §6.4。
|
|
50
|
+
- Cline 通过 `.cline/workflows/`(7 篇指针壳 → `.agents/commands/`)与 `.cline/agents/`(7 篇角色定义,**YAML** → `.agents/roles/`)接入;Cline 原生读 `AGENTS.md` 与 `.agents/skills/`,故规则面与技能面零改动生效。`.cline/` 为本机私有目录(`.gitignore`),不随 clone 传播;**两道门未接线**(Cline hook 协议与仓库 `.agents/hooks/*.cjs` 不兼容,接入需协议适配层),机理见 `runtime-env.md` §6.4。
|
|
51
|
+
- 宿主不支持子智能体时按命令 frontmatter 的 `fallback` 执行;但**独立复核项不设 fallback**——L2 / L3 的 `independent-reviewer` 一律 `required: true`,宿主不支持子智能体时另开新会话,不得回退为原主智能体自查。
|
|
52
|
+
- 子智能体不得跨越用户确认门,也不得自行提交、合入或上线;所有结果由主智能体复核后交用户决策。
|
|
53
|
+
|
|
54
|
+
## 闭环规则
|
|
55
|
+
|
|
56
|
+
1. L1 新需求始于已确认的 plan,不另立 intent。L2/L3 新需求始于已确认的 intent。修复始于已确认的 incident;L1 修复再立同名 L1 plan,走 `.agents/commands/new-task.md` §L1 快速道(常态不打开 `stages.md`)
|
|
57
|
+
2. L2/L3 必须先有同名 spec 确认通过(L2/L3 一律强制独立复核,见 `stages.md` Design §3),方可起草 plan。L1 plan 在 `new-task.md` §L1 快速道起草并确认(`stages.md` 只管 L2/L3),节为入口 / 改动方案 / 约束与风险 / 验证计划 / 验收标准
|
|
58
|
+
3. 实现产物必须通过静态门(架构红线 + build + test)
|
|
59
|
+
4. 线上 / 实测缺陷回落到 `incidents/`,复盘三件套(新 intent、防复发验证、规范条目)缺一不可;**根因属「门禁缺位 / 规范未落地 / 系统性问题」时,即使结构性修复已完成也必须立新 intent** 追踪系统性改进,禁止以「修复已完成」为由绕过 intent 回路
|
|
60
|
+
5. 关单在 test,不依赖是否上 prod。L1 勾验 plan「验收标准」并补证据后 plan → done。L2/L3 勾验 intent「验收标准」后 intent → done,同名 plan 一并 done。修复类 incident 走 open → fixed → closed,同名 plan 一并 done。done 仍有未勾项会被 check-loop 拦(2026-09-12 起新建文档 hard-block,存量仅提示不回填)。上 prod 另走 deploy(PR 合入清单,不走 tag/24h 仪式)
|
|
61
|
+
6. 放弃留档:方案曾确认后不做 → `superseded`;未完成即取消 → `cancelled`。二者均为已确认终态,check-loop 不按「状态未确认」拦截;L3 放弃件豁免「确认结果必须为 approved」
|
|
62
|
+
7. 后续回归清单与周检清单也归档本目录
|
|
63
|
+
8. **检查 17(发版草稿门)已于 2026-10-21 退役删码**:本仓根 `package.json` 无 `version` 字段,版本锚条件永不成立(2026-10-06 盘点);发版不走 tag 仪式(见「追溯」节)。该 hard 门已不存在,勿再按「恒跳过」理解
|
|
64
|
+
|
|
65
|
+
## 历史归档(只读,不增量)
|
|
66
|
+
|
|
67
|
+
- 新需求设计文档一律写进 `workflow/specs/` 或 `workflow/plans/`;关键路径提炼进 `workflow/regression-checklist.md`。
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
---
|
|
2
|
+
状态: open
|
|
3
|
+
级别: L1
|
|
4
|
+
发现: YYYY-MM-DD
|
|
5
|
+
来源: <self | user | test | monitor——谁发现,见 .agents/config/workflow-enums.txt incident.source.all>
|
|
6
|
+
影响环境: <dev | staging | prod | none——缺陷触达的环境,none=未触达运行环境>
|
|
7
|
+
模块: <词表之一,见 .agents/config/workflow-modules.txt>
|
|
8
|
+
---
|
|
9
|
+
# INCIDENT — <日期 主题>
|
|
10
|
+
<!-- 复制为 YYYY-MM-DD-<主题>.md;线上或实测发现的功能缺陷都记录,历史 BUG 可回填 -->
|
|
11
|
+
<!-- frontmatter 受限子集(2026-09-13):状态∈open/fixed/closed(严格枚举,附注写备注键);级别∈L1/L2/L3;闭环引擎启用前的回填件加一行 `流程: legacy`(豁免级别/配对检查);正文不再写状态/级别/发现行 -->
|
|
12
|
+
<!-- 归因两键(2026-10-11 incident-attribution 起新建件必填,check-loop 检查 24 校验):锚前存量不回填;「来源」是缺陷发现方(供来源×环境交叉表机器复算,替代逐件人工判读),「影响环境」写实际触达环境(未触达写 none) -->
|
|
13
|
+
|
|
14
|
+
## 时间线
|
|
15
|
+
- <发现 → 定位 → 止血 → 恢复,带时刻>
|
|
16
|
+
- 用户确认:草稿过目通过(<日期>)
|
|
17
|
+
<!-- 上行是**L2/L3 起草 spec 的机器前置**(fill-spec / confirm-doc 校验):须为「时间线」小节内的行首条目;
|
|
18
|
+
接受形态 `- 用户确认:…` / `- **用户确认**:…` / `- <日期> 用户确认:…`(词前词后加粗、日期前缀均可);
|
|
19
|
+
正文叙述句(如「用户确认了方案」)不算留痕。形态清单写在本注释内,避免样例行自含描述文字 -->
|
|
20
|
+
|
|
21
|
+
## 影响面
|
|
22
|
+
- <页面 / 接口 / 数据范围>
|
|
23
|
+
|
|
24
|
+
## 根因
|
|
25
|
+
<一句话;深层原因另起一行>
|
|
26
|
+
|
|
27
|
+
## 为什么之前没拦住
|
|
28
|
+
<门禁 / 测试 / 规范各查一遍:哪一层本可以拦住>
|
|
29
|
+
|
|
30
|
+
## 复盘三件套(缺一不可)
|
|
31
|
+
|
|
32
|
+
> 目的:让事故真正回到 Plan,不让「防复发」承诺停留在文档里。模块已逐步上线,事故可能来自 dev / staging / prod 任一环境。
|
|
33
|
+
|
|
34
|
+
1. 结构性修复
|
|
35
|
+
- 修复 commit:<SHA + 改动文件清单>
|
|
36
|
+
- 影响环境:dev / staging / prod(已上线模块若波及 prod,需附影响用户数 / 持续时长 / 是否回滚)
|
|
37
|
+
- 是否需要新 intent:
|
|
38
|
+
- 是 → ../intents/YYYY-MM-DD-<主题>.md(根因属「门禁缺位 / 规范未落地 / 系统性问题」时强制立,即使结构性修复已完成)
|
|
39
|
+
- 否 → 理由:<根因属实现 bug、单点修复已完成,且已有规范条目覆盖>
|
|
40
|
+
|
|
41
|
+
2. 防复发验证(必须落到自动化用例或回归清单条目,禁止只写「已人工验证」)
|
|
42
|
+
- 自动化用例:tests/<测试文件>(<用例名 / 数量>)
|
|
43
|
+
- 或 test 步骤:.agents/commands/stages.md Test 章 + <具体操作>
|
|
44
|
+
- 或回归清单条目:workflow/regression-checklist.md(防复发验证节追加一行)
|
|
45
|
+
|
|
46
|
+
3. 规范条目(必须有可追溯的落点)
|
|
47
|
+
- 落点(多选):AGENTS.md <章节> / .agents/hooks/<脚本> / .agents/skills/<skill> / .agents/commands/<cmd> / 回归清单 §<章节>
|
|
48
|
+
- 引用:commit <SHA> / 文件:<路径>#L<行>
|
|
49
|
+
- 若无新增条目,理由:<已有条目覆盖,说明条目位置>
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
状态: draft
|
|
3
|
+
级别: L1
|
|
4
|
+
日期: YYYY-MM-DD
|
|
5
|
+
模块: <词表之一,见 .agents/config/workflow-modules.txt>
|
|
6
|
+
备注: <可选:附注自由文本,check-loop 不解析>
|
|
7
|
+
---
|
|
8
|
+
# INTENT — <主题>
|
|
9
|
+
<!-- 复制本模板为 YYYY-MM-DD-<主题>.md 后填写;plans/ 下同名文件与本文件配对 -->
|
|
10
|
+
<!-- frontmatter 受限子集(2026-09-13):每行 `键: 值`;状态∈draft/approved/done/superseded/cancelled(严格枚举,附注写备注键);级别∈L1/L2/L3;check-loop 只扫 frontmatter 取机器字段,正文不再写状态/级别行 -->
|
|
11
|
+
|
|
12
|
+
## 背景与问题
|
|
13
|
+
<为什么做;写明需求来源(工单 / 沟通记录 / 待办事项)>
|
|
14
|
+
|
|
15
|
+
## 目标
|
|
16
|
+
- <可验证的目标>
|
|
17
|
+
|
|
18
|
+
## 非目标(L1 微改动无实质内容可删本节,不硬填)
|
|
19
|
+
- <明确不做的,防止范围蔓延>
|
|
20
|
+
|
|
21
|
+
## 约束(L1 微改动无实质内容可删本节,不硬填)
|
|
22
|
+
- <复用什么、不许动什么>
|
|
23
|
+
|
|
24
|
+
## 影响面
|
|
25
|
+
- 模块:shared / material(Domain / Application / Infrastructure / API)
|
|
26
|
+
- 数据库:无 / <表名>(涉及 schema 变更 → L3;无 schema 的运行时 / 管线结构面亦为 L3,判据见 `.agents/commands/new-task.md` §级别判断)
|
|
27
|
+
- 前端页面:<路由或组件,无则删本行>
|
|
28
|
+
|
|
29
|
+
## 触达红线(对照 AGENTS.md,勾选仅标记触及范围;具体如何满足在同名 spec 中说明)
|
|
30
|
+
- [ ] Application 禁引 Infrastructure / DbContext(豁免仅限分类树原生 LINQ)
|
|
31
|
+
- [ ] 编码生成逻辑(FormulaEngine / CategoryPrefix)→ 级别至少 L2
|
|
32
|
+
- [ ] 跨调用方契约变更(共享层基类 / DTO 形状 / 接口签名 / 既有参数语义 / 全局响应与分页校验口径)→ 级别至少 L2
|
|
33
|
+
- [ ] schema / 迁移 SQL / DI 链 → 级别 L3
|
|
34
|
+
- [ ] 前端:Drawer 一律 / 禁 a-select 大数据量 / 样式统一 style.css
|
|
35
|
+
|
|
36
|
+
> 触及任一红线即为 L2 / L3,必须立 ../specs/YYYY-MM-DD-<主题>.md 写明如何满足,方可起草 plan。
|
|
37
|
+
|
|
38
|
+
## 验收标准(可测试)
|
|
39
|
+
<!-- 每条加稳定编号 A1..An(锚 coverageSince 2026-10-22 起,spec 确认门按编号查覆盖);增删用新号、不复用旧号。 -->
|
|
40
|
+
- [ ] A1 <逐条可测试;写不出可测试判据 = 还没想清楚>
|
|
41
|
+
|
|
42
|
+
> **闭环对账**:关单在 test 阶段(不依赖 deploy)。intent 置 done 前逐条勾验,每条勾选项后补证据——`- [x] <判据>(证据:<commit SHA / 测试用例名 / 冒烟脚本输出>)`。
|
|
43
|
+
> done 状态仍有未勾项会被 check-loop 拦截(2026-09-12 起新建 intent 为 hard-block,存量 intent 仅 warning 提示);勾选但缺「证据:」为 warning。
|
|
File without changes
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
---
|
|
2
|
+
状态: draft
|
|
3
|
+
级别: L1
|
|
4
|
+
日期: <YYYY-MM-DD 建档日>
|
|
5
|
+
模块: <词表之一,见 .agents/config/workflow-modules.txt>
|
|
6
|
+
---
|
|
7
|
+
# PLAN — <与入口文档同名主题>
|
|
8
|
+
<!-- 与 intents/ 或 incidents/ 下同名入口文档配对;L2/L3 必须先有 ../specs/ 同名 spec 确认通过;AI 起草、用户对话内确认后开工 -->
|
|
9
|
+
<!-- frontmatter 受限子集(2026-09-13):状态∈draft/approved/done/superseded/cancelled(严格枚举,附注写备注键);级别∈L1/L2/L3;正文不再写状态/级别行 -->
|
|
10
|
+
<!-- L1(2026-10-10):新单用 fill-plan.mjs --level L1,本文件即入口,不另立 intent。节:入口 / 改动方案 / 约束与风险 / 验证计划 / 验收标准。下面保留的「改动面 / 验证方式」是存量极简形态,新单不要再复制这两节标题。 -->
|
|
11
|
+
<!-- 模糊点纪律(2026-10-16):起草/修订遇无法自行决策的模糊点(多种解释/口径缺失/依赖外部事实)禁止脑补——在对应节原地插入 [NEEDS CLARIFICATION]: <一句话问题> 并保持 draft 向用户求澄清;澄清后删除标记、把决策落为正文。approved 前标记须清零(口径见 workflow/README.md 文档协议「模糊点显式阻断」)。 -->
|
|
12
|
+
|
|
13
|
+
对应入口:L1 = 本 plan。修复类另保留 ../incidents/YYYY-MM-DD-<主题>.md。L2/L3 = ../intents/YYYY-MM-DD-<主题>.md
|
|
14
|
+
对应 spec:../specs/YYYY-MM-DD-<主题>.md(仅 L2/L3)
|
|
15
|
+
|
|
16
|
+
## 改动面(L1 极简形态主节;L2/L3 可作任务拆解的汇总或删本节)
|
|
17
|
+
- <文件/组件>:<做什么;判据细节直接写进条目,如「L771 message.success 改『更新成功』」>
|
|
18
|
+
<!-- stages.md Build §2 确认的改动清单确认后回填本节落盘(对话留痕仅供当次)——改动面 + 任务勾选态 + git status = 会话重入三锚(2026-10-11 session-context) -->
|
|
19
|
+
|
|
20
|
+
## 任务拆解(L2/L3 必填;L1 仅多文件多步骤时用,单任务微改动删本节)
|
|
21
|
+
<!-- 任务即勾选态(2026-10-11 session-context):完成一项立刻勾选并回填留痕;压缩 / 新会话续作先读本表勾选态 + git status 重建进度,禁凭记忆补勾 -->
|
|
22
|
+
<!-- 依赖行(blocking edges,matt to-tickets 同构):显式声明阻塞关系后「依赖行所指任务已勾选」即可开工——无未决阻塞的任务集 = frontier,可并行派发(多 worktree / 委派「新开+合并范围」);纯顺序链依赖行退化为「任务 N-1」,零额外成本 -->
|
|
23
|
+
- [ ] 1. <任务>
|
|
24
|
+
- 判据:<怎样算完成;尽量对应一个测试或可复现操作>
|
|
25
|
+
- 依赖:无(可立即开工)/ 被任务 <N> 阻塞
|
|
26
|
+
- 风险:低 / 中 / 高(<原因>)
|
|
27
|
+
- 留痕:(勾选时回填 commit SHA / 测试名 / 实测输出)
|
|
28
|
+
- [ ] 2. <任务>
|
|
29
|
+
- 判据:…
|
|
30
|
+
- 依赖:…
|
|
31
|
+
- 风险:…
|
|
32
|
+
- 留痕:…
|
|
33
|
+
|
|
34
|
+
## 执行顺序(L2/L3 必填;L1 单文件微改动删本节)
|
|
35
|
+
<1 → 2 → 3;依赖已在上表「依赖」行显式化时本节只写一句「见任务拆解依赖行,frontier = 无未决阻塞任务」,纯顺序链写 1 → N 即可>
|
|
36
|
+
|
|
37
|
+
## 验证方式
|
|
38
|
+
- 构建:<项目构建命令>(+ <测试命令>)
|
|
39
|
+
- 前端:cd frontend && npm run build(vue-tsc)
|
|
40
|
+
- UI:.agents/commands/stages.md Test 章(涉及页面改动必走,headless Chrome 实测)
|
|
41
|
+
- L2 追加:<契约 / 规则面比对:编码结果抽样 / 接口契约断言 / 口径对账>
|
|
42
|
+
- L3 追加:<含 schema 变更:备份 + 回滚 SQL 就绪后执行;仅运行时 / 管线:回退上一 release tag + 配置开关预案>
|
|
43
|
+
|
|
44
|
+
## 确认与复核
|
|
45
|
+
> 确认 = 用户在对话内一句话通过;确认后本 plan 状态 `draft → approved` 并回填本节(确认环节的机器可见态),`done` 只在关单出现——禁从 `draft` 直跳 `done`(2026-09-22 papercut)。
|
|
46
|
+
- 确认结果:approved(YYYY-MM-DD 用户对话内确认);done(YYYY-MM-DD 关单,随入口文档置终态)
|
|
47
|
+
- 确认门记录:plan 草稿全文过目 + 改动清单确认(`stages.md` Build 两道门,逐次,不合并)
|
|
File without changes
|
|
File without changes
|
|
File without changes
|