@event4u/agent-config 9.8.0 → 9.9.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/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +278 -298
- package/CONTRIBUTING.md +23 -7
- package/MIGRATION.md +20 -0
- package/README.md +55 -9
- package/dist/agent-src/commands/agents/audit.md +1 -1
- package/dist/agent-src/commands/agents/optimize.md +2 -2
- package/dist/agent-src/commands/agents/user.md +1 -1
- package/dist/agent-src/commands/agents.md +1 -1
- package/dist/agent-src/commands/check-current-md.md +3 -3
- package/dist/agent-src/commands/fix/portability.md +2 -2
- package/dist/agent-src/commands/fix/pr-comments-loop.md +136 -0
- package/dist/agent-src/commands/fix/refs.md +2 -2
- package/dist/agent-src/commands/fix/route.md +4 -3
- package/dist/agent-src/commands/fix.md +9 -6
- package/dist/agent-src/commands/ghostwriter.md +1 -1
- package/dist/agent-src/commands/image.md +1 -1
- package/dist/agent-src/commands/optimize/augmentignore.md +1 -1
- package/dist/agent-src/commands/optimize/skills.md +2 -2
- package/dist/agent-src/commands/post-as.md +1 -1
- package/dist/agent-src/commands/research.md +1 -1
- package/dist/agent-src/commands/roadmap/ai-council.md +1 -1
- package/dist/agent-src/commands/security-audit-config.md +1 -1
- package/dist/agent-src/commands/team/delegate.md +4 -0
- package/dist/agent-src/commands/video.md +1 -1
- package/dist/agent-src/contexts/authority/kernel-rule-edits.md +1 -1
- package/dist/agent-src/contexts/contracts/emergency-triage-block.md +2 -2
- package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +48 -2
- package/dist/agent-src/contexts/execution/orchestration-telemetry.md +10 -0
- package/dist/agent-src/contexts/execution/subagent-modes-detail.md +109 -8
- package/dist/agent-src/contexts/execution/subagent-response-contract.md +20 -0
- package/dist/agent-src/contexts/execution/subagent-spawn-contract.md +53 -3
- package/dist/agent-src/rules/code-provenance.md +112 -0
- package/dist/agent-src/rules/external-code-graph-interop.md +4 -4
- package/dist/agent-src/rules/history-discipline.md +80 -0
- package/dist/agent-src/rules/no-roadmap-references.md +1 -1
- package/dist/agent-src/rules/php-coding.md +1 -0
- package/dist/agent-src/rules/reviewer-awareness.md +1 -0
- package/dist/agent-src/rules/roadmap-ci-steps-policy.md +1 -0
- package/dist/agent-src/rules/roadmap-progress-sync.md +7 -0
- package/dist/agent-src/rules/scale-discipline.md +92 -0
- package/dist/agent-src/rules/security-sensitive-stop.md +10 -0
- package/dist/agent-src/rules/session-canary.md +77 -0
- package/dist/agent-src/rules/token-optimizer-maintenance.md +1 -1
- package/dist/agent-src/rules/tool-safety.md +3 -1
- package/dist/agent-src/rules/untrusted-input-defense.md +10 -0
- package/dist/agent-src/skills/agent-security-review/SKILL.md +1 -1
- package/dist/agent-src/skills/code-intelligence/SKILL.md +17 -14
- package/dist/agent-src/skills/condense-memory/SKILL.md +1 -1
- package/dist/agent-src/skills/corpus-grounding/SKILL.md +0 -3
- package/dist/agent-src/skills/description-assist/SKILL.md +1 -1
- package/dist/agent-src/skills/design-review/SKILL.md +5 -6
- package/dist/agent-src/skills/design-tokens/SKILL.md +0 -1
- package/dist/agent-src/skills/history-design/SKILL.md +101 -0
- package/dist/agent-src/skills/history-design/evals/triggers.json +17 -0
- package/dist/agent-src/skills/humanizer/SKILL.md +3 -3
- package/dist/agent-src/skills/image-editing/SKILL.md +1 -1
- package/dist/agent-src/skills/image-generation/SKILL.md +2 -1
- package/dist/agent-src/skills/image-provider-routing/SKILL.md +2 -2
- package/dist/agent-src/skills/launch-readiness/SKILL.md +1 -1
- package/dist/agent-src/skills/license-compliance-audit/SKILL.md +161 -0
- package/dist/agent-src/skills/license-compliance-audit/evals/triggers.json +52 -0
- package/dist/agent-src/skills/license-compliance-borrow-check/SKILL.md +145 -0
- package/dist/agent-src/skills/license-compliance-borrow-check/evals/triggers.json +52 -0
- package/dist/agent-src/skills/license-compliance-credits/SKILL.md +97 -0
- package/dist/agent-src/skills/license-compliance-credits/evals/triggers.json +52 -0
- package/dist/agent-src/skills/md-language-check/SKILL.md +1 -1
- package/dist/agent-src/skills/override-management/SKILL.md +1 -1
- package/dist/agent-src/skills/prediction-pool-optimizer/SKILL.md +7 -7
- package/dist/agent-src/skills/project-analysis-core/SKILL.md +1 -1
- package/dist/agent-src/skills/prompt-engineering-image/SKILL.md +3 -2
- package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +2 -2
- package/dist/agent-src/skills/recursive-verification/SKILL.md +6 -0
- package/dist/agent-src/skills/refine-ticket/SKILL.md +3 -3
- package/dist/agent-src/skills/roadmap-writing/SKILL.md +4 -0
- package/dist/agent-src/skills/rtk-output-filtering/SKILL.md +31 -12
- package/dist/agent-src/skills/rule-refactor/SKILL.md +3 -3
- package/dist/agent-src/skills/schema-review/SKILL.md +92 -0
- package/dist/agent-src/skills/schema-review/evals/triggers.json +17 -0
- package/dist/agent-src/skills/secrets-management/SKILL.md +3 -4
- package/dist/agent-src/skills/security-audit/SKILL.md +1 -1
- package/dist/agent-src/skills/security-maturity-assessment/SKILL.md +1 -1
- package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +3 -3
- package/dist/agent-src/skills/skill-writing/SKILL.md +2 -2
- package/dist/agent-src/skills/source-discovery/SKILL.md +5 -5
- package/dist/agent-src/skills/subagent-orchestration/SKILL.md +45 -85
- package/dist/agent-src/skills/subagent-orchestration/prompts/README.md +5 -4
- package/dist/agent-src/skills/systematic-debugging/SKILL.md +2 -2
- package/dist/agent-src/skills/tailwind-engineer/SKILL.md +2 -3
- package/dist/agent-src/skills/token-optimizer/SKILL.md +4 -4
- package/dist/agent-src/skills/verify-repair-loop/SKILL.md +1 -1
- package/dist/agent-src/skills/worktree-lifecycle/SKILL.md +2 -3
- package/dist/agent-src/templates/AGENTS.md +1 -1
- package/dist/agent-src/templates/agents/.gitattributes.fragment +25 -6
- package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
- package/dist/agent-src/templates/command.md +3 -3
- package/dist/agent-src/templates/persona.md +2 -2
- package/dist/agent-src/templates/rule.md +2 -2
- package/dist/agent-src/templates/scripts/telemetry/engagement.ts +77 -0
- package/dist/agent-src/templates/scripts/telemetry_record.ts +33 -1
- package/dist/cli/commands/doctorShell.js +20 -0
- package/dist/cli/commands/doctorShell.js.map +1 -1
- package/dist/cli/commands/rtkDetect.js +58 -0
- package/dist/cli/commands/rtkDetect.js.map +1 -0
- package/dist/cli/firstRunNotice.js +70 -0
- package/dist/cli/firstRunNotice.js.map +1 -0
- package/dist/cli/main.js +35 -3
- package/dist/cli/main.js.map +1 -1
- package/dist/cli/registry.js +7 -1
- package/dist/cli/registry.js.map +1 -1
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +362 -78
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +6 -4
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +90 -8
- package/dist/discovery/trust-report.md +11 -11
- package/dist/discovery/workspaces.json +31 -7
- package/dist/hooks/dispatch.js +19475 -0
- package/dist/install/agentSwitchDetection.js +75 -0
- package/dist/install/agentSwitchDetection.js.map +1 -0
- package/dist/install/agentSwitchProfile.js +117 -0
- package/dist/install/agentSwitchProfile.js.map +1 -0
- package/dist/install/atomic.js +1 -1
- package/dist/install/detect.js +1 -1
- package/dist/install/install.mjs +775 -486
- package/dist/install/rtkDetection.js +213 -0
- package/dist/install/rtkDetection.js.map +1 -0
- package/dist/install/rule_scope.js +2 -1
- package/dist/install/rule_scope.js.map +1 -1
- package/dist/install/types.js +2 -2
- package/dist/install/wizard-plan.js +1 -1
- package/dist/install/wizardDismissals.js +58 -0
- package/dist/install/wizardDismissals.js.map +1 -0
- package/dist/mcp/awesome-mcp-servers.row.md +1 -1
- package/dist/mcp/mcp-cloudflare-catalogue.json +1 -1
- package/dist/mcp/registry-manifest.json +15 -4
- package/dist/mcp/server.json +20 -0
- package/dist/mcp/server.mjs +44292 -0
- package/dist/router.json +1 -1
- package/dist/scripts/condense.js +14 -7
- package/dist/scripts/condense.js.map +1 -1
- package/dist/server/app.js +4 -2
- package/dist/server/app.js.map +1 -1
- package/dist/server/io/sharedWriteCheck.js +101 -0
- package/dist/server/io/sharedWriteCheck.js.map +1 -0
- package/dist/server/routes/ping.js +14 -0
- package/dist/server/routes/ping.js.map +1 -1
- package/dist/server/routes/settings.js +21 -4
- package/dist/server/routes/settings.js.map +1 -1
- package/dist/server/routes/userMd.js +21 -4
- package/dist/server/routes/userMd.js.map +1 -1
- package/dist/server/routes/wizard.js +68 -25
- package/dist/server/routes/wizard.js.map +1 -1
- package/dist/server/schemas/settings.js +4 -2
- package/dist/server/schemas/settings.js.map +1 -1
- package/dist/ui/assets/index-BpSQt5vm.js +40 -0
- package/dist/ui/assets/index-BpSQt5vm.js.map +1 -0
- package/dist/ui/assets/index-jSfMW8_t.css +1 -0
- package/dist/ui/index.html +2 -2
- package/docs/MIGRATION.md +16 -0
- package/docs/guidelines/component-oriented-and-oop-development.md +4 -2
- package/package.json +21 -11
- package/src/agent-src/templates/AGENTS.md +1 -1
- package/src/agent-src/templates/scripts/telemetry/engagement.ts +77 -0
- package/src/agent-src/templates/scripts/telemetry_record.ts +33 -1
- package/src/config/agent-settings.template.yml +52 -14
- package/src/config/discovery/packs.yml +22 -0
- package/src/config/discovery/workspaces.yml +1 -1
- package/src/config/evaluator-budgets.json +47 -0
- package/src/config/hook-latency-budget.json +20 -0
- package/src/install/agentSwitchDetection.ts +90 -0
- package/src/install/agentSwitchProfile.ts +131 -0
- package/src/install/atomic.ts +1 -1
- package/src/install/detect.ts +1 -1
- package/src/install/rtkDetection.ts +274 -0
- package/src/install/rule_scope.ts +9 -2
- package/src/install/types.ts +2 -2
- package/src/install/wizard-plan.ts +1 -1
- package/src/install/wizardDismissals.ts +60 -0
- package/src/scripts/_cli/cmd_doctor.ts +62 -1
- package/src/scripts/_cli/cmd_memory_get.ts +197 -0
- package/src/scripts/_cli/cmd_refresh.ts +30 -0
- package/src/scripts/_dispatch.bash +81 -0
- package/src/scripts/_lib/auto_dispatch.corpus.test.ts +64 -1
- package/src/scripts/_lib/auto_dispatch.ts +76 -0
- package/src/scripts/_lib/detect_target_license.ts +714 -0
- package/src/scripts/_lib/fixtures/secret-detector/negatives.txt +5 -0
- package/src/scripts/_lib/fixtures/secret-detector/positives.txt +4 -0
- package/src/scripts/_lib/install_drift.ts +194 -0
- package/src/scripts/_lib/memory_fts_index.ts +390 -0
- package/src/scripts/_lib/orchestration_record.ts +91 -2
- package/src/scripts/_lib/persistence/adapter_raw_sql.ts +443 -0
- package/src/scripts/_lib/persistence/detect_audit_coverage.ts +423 -0
- package/src/scripts/_lib/persistence/detect_bounded_reads.ts +154 -0
- package/src/scripts/_lib/persistence/detect_index_parity.ts +576 -0
- package/src/scripts/_lib/persistence/detect_n1_eloquent.ts +226 -0
- package/src/scripts/_lib/persistence/detect_offload.ts +441 -0
- package/src/scripts/_lib/persistence/detect_prisma_growth.ts +74 -0
- package/src/scripts/_lib/persistence/offload_catalog.ts +73 -0
- package/src/scripts/_lib/persistence/types.ts +109 -0
- package/src/scripts/_lib/rtk_allowlist.ts +44 -0
- package/src/scripts/_lib/secret_detector.test.ts +5 -0
- package/src/scripts/_lib/secret_detector.ts +9 -0
- package/src/scripts/_lib/secret_detector_adversarial.test.ts +116 -0
- package/src/scripts/_lib/spawn_env.ts +7 -0
- package/src/scripts/_lib/sqlite_guard.ts +191 -0
- package/src/scripts/_lib/subagent_spawn.ts +53 -0
- package/src/scripts/_lib/worker_budget.ts +107 -0
- package/src/scripts/ai_council/blind_review.ts +0 -0
- package/src/scripts/ai_council/config.ts +12 -6
- package/src/scripts/ai_council/orchestrator.ts +73 -3
- package/src/scripts/ai_team/review_gate.ts +8 -10
- package/src/scripts/ai_team/team_dispatch.ts +48 -0
- package/src/scripts/audit_initial_context.ts +1 -1
- package/src/scripts/bench_cross_source_eval.ts +400 -0
- package/src/scripts/bench_honesty_score.ts +1093 -0
- package/src/scripts/bench_hook_latency.ts +218 -0
- package/src/scripts/build_mcp_catalog.ts +275 -0
- package/src/scripts/build_mcp_registry_manifest.ts +46 -0
- package/src/scripts/build_proof.ts +45 -0
- package/src/scripts/chat_history.ts +8 -5
- package/src/scripts/check_backstop_debt.ts +23 -13
- package/src/scripts/check_bundle_path_leakage.ts +343 -0
- package/src/scripts/check_evaluator_budgets.ts +99 -0
- package/src/scripts/check_knowledge_sharing.ts +12 -1
- package/src/scripts/check_no_external_sources.ts +2 -2
- package/src/scripts/check_source_pointer_freshness.ts +28 -3
- package/src/scripts/code_graph/build.ts +0 -0
- package/src/scripts/code_graph/cli.ts +181 -9
- package/src/scripts/code_graph/detect.ts +52 -0
- package/src/scripts/code_graph/intent.ts +45 -0
- package/src/scripts/code_graph/query.ts +143 -29
- package/src/scripts/code_graph/sqlite_store.ts +174 -0
- package/src/scripts/condense.ts +14 -6
- package/src/scripts/context_hygiene_hook.ts +8 -5
- package/src/scripts/council_cli.ts +126 -12
- package/src/scripts/detect_target_license.ts +203 -0
- package/src/scripts/evaluator_umbrella.sh +145 -0
- package/src/scripts/external_sources_denylist.json +5 -3
- package/src/scripts/first_run_gate_hook.ts +9 -5
- package/src/scripts/hermetic-install.sh +3 -3
- package/src/scripts/hook_manifest.yaml +55 -16
- package/src/scripts/hooks/block_kernel_rule_writes.ts +212 -0
- package/src/scripts/hooks/block_no_verify.ts +9 -9
- package/src/scripts/hooks/code_graph_nudge_hook.ts +11 -4
- package/src/scripts/hooks/concern_registry.ts +75 -0
- package/src/scripts/hooks/design_slop_hook.ts +8 -5
- package/src/scripts/hooks/dispatch_entry.ts +37 -0
- package/src/scripts/hooks/dispatch_hook.ts +176 -3
- package/src/scripts/hooks/hook_stdin.ts +42 -0
- package/src/scripts/hooks/rtk_wrap_hook.ts +26 -12
- package/src/scripts/hot_context_hook.ts +7 -6
- package/src/scripts/injection_scan_hook.ts +9 -1
- package/src/scripts/install +6 -6
- package/src/scripts/install-hooks.sh +4 -4
- package/src/scripts/install.sh +5 -4
- package/src/scripts/install.ts +264 -23
- package/src/scripts/learning_sidecar.ts +0 -0
- package/src/scripts/lint_budget_ownership.ts +89 -0
- package/src/scripts/lint_command_routing.ts +35 -5
- package/src/scripts/lint_command_verbs.ts +42 -9
- package/src/scripts/lint_consumer_internal_refs.ts +211 -0
- package/src/scripts/lint_discovery_vocabulary.ts +2 -0
- package/src/scripts/lint_documented_commands.ts +670 -0
- package/src/scripts/lint_framework_leakage.ts +17 -3
- package/src/scripts/lint_framework_leakage_allowlist.json +32 -0
- package/src/scripts/lint_governed_writes.ts +335 -0
- package/src/scripts/lint_hidden_unicode.ts +6 -0
- package/src/scripts/lint_mcp_registry_manifest.ts +26 -1
- package/src/scripts/lint_memory_tripwire.ts +186 -0
- package/src/scripts/lint_override_kernel_guard.ts +74 -26
- package/src/scripts/lint_persistence.ts +171 -0
- package/src/scripts/lint_pre_migration_refs.ts +106 -0
- package/src/scripts/lint_provenance.ts +547 -0
- package/src/scripts/lint_provenance_vocabulary.ts +437 -0
- package/src/scripts/lint_spawn_payload.ts +283 -0
- package/src/scripts/lint_store_boundary.ts +152 -0
- package/src/scripts/lint_versioned_cache.ts +7 -1
- package/src/scripts/mcp_server/__main__.ts +7 -2
- package/src/scripts/mcp_server/catalog.ts +23 -1
- package/src/scripts/mcp_server/consumer_tool_catalog.json +563 -193
- package/src/scripts/mcp_server/prompts.ts +6 -0
- package/src/scripts/mcp_server/tool_catalog_source.ts +332 -0
- package/src/scripts/mcp_server/tools.ts +56 -5
- package/src/scripts/mcp_telemetry_query.ts +2 -33
- package/src/scripts/mcp_telemetry_store.ts +64 -34
- package/src/scripts/memory_learn_hook.ts +126 -0
- package/src/scripts/memory_lookup.ts +0 -0
- package/src/scripts/memory_replay_24.ts +312 -0
- package/src/scripts/memory_report.ts +16 -3
- package/src/scripts/memory_signal.ts +48 -0
- package/src/scripts/memory_status.ts +6 -0
- package/src/scripts/minimal_safe_diff_hook.ts +8 -5
- package/src/scripts/onboarding_gate_hook.ts +8 -5
- package/src/scripts/orchestration_record.ts +16 -0
- package/src/scripts/pr_url_reminder_hook.ts +8 -1
- package/src/scripts/prepack-check.mjs +17 -0
- package/src/scripts/prepack_lifecycle_check.d.mts +8 -0
- package/src/scripts/prepack_lifecycle_check.mjs +82 -0
- package/src/scripts/profile_staleness_hook.ts +8 -7
- package/src/scripts/report_install_drift.ts +109 -0
- package/src/scripts/roadmap_progress_hook.ts +8 -5
- package/src/scripts/schemas/license-policy.schema.json +89 -0
- package/src/scripts/schemas/provenance-borrow.schema.json +46 -0
- package/src/scripts/schemas/rule.schema.json +10 -0
- package/src/scripts/self_review_gate.test.ts +173 -1
- package/src/scripts/self_review_gate.ts +155 -15
- package/src/scripts/session_canary_hook.ts +182 -0
- package/src/scripts/smoke_quickstart.ts +2 -2
- package/src/scripts/surface_probe_hook.ts +8 -7
- package/src/scripts/sync_gitattributes.ts +310 -0
- package/src/scripts/team_review_gate_hook.ts +13 -16
- package/src/scripts/verify_before_complete_hook.ts +8 -5
- package/src/scripts/wrapper_freshness_hook.ts +8 -7
- package/src/server/schemas/settings.ts +8 -2
- package/dist/ui/assets/index-BPFMZWUs.css +0 -1
- package/dist/ui/assets/index-CrmZ34Rg.js +0 -40
- package/dist/ui/assets/index-CrmZ34Rg.js.map +0 -1
- package/docs/CLAIMS.md +0 -286
- package/docs/DISTRIBUTION_CHECKLIST.md +0 -170
- package/docs/RELEASE_STORY_TEMPLATE.md +0 -37
- package/docs/SKILL_CENSUS.md +0 -352
- package/docs/adrs/cost/0001-hard-stop-hook.md +0 -114
- package/docs/adrs/cost/README.md +0 -9
- package/docs/adrs/memory/0001-consumer-side-snapshot.md +0 -119
- package/docs/adrs/memory/README.md +0 -10
- package/docs/adrs/router/0001-three-tier-routing.md +0 -119
- package/docs/adrs/router/README.md +0 -9
- package/docs/adrs/schema/0001-json-schema-frontmatter.md +0 -102
- package/docs/adrs/schema/README.md +0 -9
- package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +0 -99
- package/docs/adrs/smoke/README.md +0 -9
- package/docs/adrs/telegraph/0001-default-off-until-bench.md +0 -93
- package/docs/adrs/telegraph/README.md +0 -9
- package/docs/announcements/2026-05-non-dev-launch.md +0 -79
- package/docs/announcements/2026-07-honest-cost-sweep-launch.md +0 -84
- package/docs/anti-reskin-gate.md +0 -60
- package/docs/architecture/augment-projection.md +0 -70
- package/docs/architecture/claude-bundle.md +0 -77
- package/docs/architecture/current-onboard-baseline.md +0 -126
- package/docs/architecture/current-safety-behavior.md +0 -137
- package/docs/architecture/multi-tool-projection.md +0 -125
- package/docs/architecture/setup-vs-settings-shared-surface.md +0 -114
- package/docs/architecture/source-projection.md +0 -85
- package/docs/architecture.md +0 -390
- package/docs/archive/CHANGELOG-6.0.0-overview.md +0 -953
- package/docs/archive/CHANGELOG-7.0.0.md +0 -419
- package/docs/archive/CHANGELOG-pre-2.11.0.md +0 -141
- package/docs/archive/CHANGELOG-pre-2.15.0.md +0 -244
- package/docs/archive/CHANGELOG-pre-2.16.0.md +0 -48
- package/docs/archive/CHANGELOG-pre-2.17.0.md +0 -63
- package/docs/archive/CHANGELOG-pre-2.2.0.md +0 -2138
- package/docs/archive/CHANGELOG-pre-2.20.0.md +0 -159
- package/docs/archive/CHANGELOG-pre-2.25.0.md +0 -191
- package/docs/archive/CHANGELOG-pre-2.7.0.md +0 -185
- package/docs/archive/CHANGELOG-pre-3.0.0.md +0 -130
- package/docs/archive/CHANGELOG-pre-3.1.0.md +0 -167
- package/docs/archive/CHANGELOG-pre-3.2.0.md +0 -268
- package/docs/archive/CHANGELOG-pre-4.0.0.md +0 -80
- package/docs/archive/CHANGELOG-pre-4.5.0.md +0 -289
- package/docs/archive/CHANGELOG-pre-5.4.0.md +0 -260
- package/docs/archive/CHANGELOG-pre-5.9.0.md +0 -270
- package/docs/archive/CHANGELOG-pre-6.0.0.md +0 -473
- package/docs/archive/CHANGELOG-pre-7.0.0.md +0 -126
- package/docs/archive/CHANGELOG-pre-8.0.0.md +0 -301
- package/docs/archive/CHANGELOG-pre-8.1.0.md +0 -316
- package/docs/archive/CHANGELOG-pre-8.12.0.md +0 -304
- package/docs/archive/CHANGELOG-pre-8.9.0.md +0 -306
- package/docs/archive/CHANGELOG-pre-9.2.0.md +0 -276
- package/docs/artefact-census.md +0 -71
- package/docs/benchmark.md +0 -785
- package/docs/benchmark.pinned.yml +0 -31
- package/docs/benchmarks.md +0 -85
- package/docs/capability-matrix.md +0 -33
- package/docs/case-studies/_template.md +0 -60
- package/docs/case-studies/frontend-design-positioning.md +0 -86
- package/docs/catalog.md +0 -726
- package/docs/command-flows.md +0 -272
- package/docs/command-naming-audit.md +0 -60
- package/docs/comparison.yaml +0 -87
- package/docs/contracts/CHANGELOG-conventions.md +0 -149
- package/docs/contracts/STABILITY.md +0 -188
- package/docs/contracts/adoption-signal-floor.md +0 -127
- package/docs/contracts/adr-architectural-consensus-mechanism.md +0 -68
- package/docs/contracts/adr-chat-history-split.md +0 -140
- package/docs/contracts/adr-command-suggestion.md +0 -144
- package/docs/contracts/adr-forecast-construction-shape.md +0 -90
- package/docs/contracts/adr-gtm-context-spine.md +0 -116
- package/docs/contracts/adr-implement-ticket-runtime.md +0 -121
- package/docs/contracts/adr-install-user-type-axis.md +0 -107
- package/docs/contracts/adr-layout.md +0 -107
- package/docs/contracts/adr-level-6-productization.md +0 -145
- package/docs/contracts/adr-mcp-runtime.md +0 -128
- package/docs/contracts/adr-product-ui-track.md +0 -381
- package/docs/contracts/adr-prompt-driven-execution.md +0 -186
- package/docs/contracts/adr-settings-sync-engine.md +0 -128
- package/docs/contracts/adr-user-types-axis.md +0 -127
- package/docs/contracts/adr-wing4-context-spine.md +0 -126
- package/docs/contracts/agent-user-schema.md +0 -170
- package/docs/contracts/agents-layout.md +0 -148
- package/docs/contracts/agents-md-tech-stack.md +0 -75
- package/docs/contracts/ai-council-config.md +0 -829
- package/docs/contracts/ai-team-config.md +0 -224
- package/docs/contracts/analysis-memory-loop.md +0 -149
- package/docs/contracts/at-rest-encryption.md +0 -191
- package/docs/contracts/audit-log-v1.md +0 -150
- package/docs/contracts/auto-orchestration-v1.md +0 -70
- package/docs/contracts/benchmark-ab-contract.md +0 -106
- package/docs/contracts/benchmark-corpus-spec.md +0 -125
- package/docs/contracts/benchmark-report-schema.md +0 -113
- package/docs/contracts/branch-protection-policy.md +0 -139
- package/docs/contracts/brand-token-consumption.md +0 -74
- package/docs/contracts/capability-boundary.md +0 -69
- package/docs/contracts/capability-packs.md +0 -217
- package/docs/contracts/ci-cost-budget.md +0 -111
- package/docs/contracts/ci-green-floor.md +0 -141
- package/docs/contracts/command-category-governance.md +0 -84
- package/docs/contracts/command-clusters.md +0 -399
- package/docs/contracts/command-surface-tiers.md +0 -176
- package/docs/contracts/command-taxonomy.md +0 -137
- package/docs/contracts/condensation-default-kill-criterion.md +0 -116
- package/docs/contracts/config-presets.md +0 -144
- package/docs/contracts/conformance.md +0 -84
- package/docs/contracts/consumer-bridge.md +0 -73
- package/docs/contracts/context-paths.md +0 -101
- package/docs/contracts/context-spine.md +0 -179
- package/docs/contracts/cost-dashboard.md +0 -143
- package/docs/contracts/cost-enforcement.md +0 -134
- package/docs/contracts/cost-profile-defaults.md +0 -110
- package/docs/contracts/cost-summary-schema.md +0 -107
- package/docs/contracts/creative-pack-boundary.md +0 -63
- package/docs/contracts/cross-repo-retrieval.md +0 -64
- package/docs/contracts/cross-wing-handoff.md +0 -134
- package/docs/contracts/daily-workspace.md +0 -147
- package/docs/contracts/decision-engine-gates.md +0 -120
- package/docs/contracts/decision-trace-v1.md +0 -177
- package/docs/contracts/design-artifact-lifecycle.md +0 -93
- package/docs/contracts/design-artifact-verification.md +0 -153
- package/docs/contracts/discovery-manifest.md +0 -209
- package/docs/contracts/discovery-manifest.schema.json +0 -254
- package/docs/contracts/evidence-based-pruning.md +0 -102
- package/docs/contracts/explain-modes.md +0 -187
- package/docs/contracts/explain-trace.schema.json +0 -144
- package/docs/contracts/file-ownership-matrix.json +0 -13941
- package/docs/contracts/file-ownership-matrix.md +0 -135
- package/docs/contracts/frontmatter-contract.md +0 -140
- package/docs/contracts/ghostwriter-schema.md +0 -337
- package/docs/contracts/governance-enforcement-projection.md +0 -159
- package/docs/contracts/gui-wizard.md +0 -350
- package/docs/contracts/harness-expectations.md +0 -128
- package/docs/contracts/hook-architecture-v1.md +0 -325
- package/docs/contracts/host-agent-protocol.md +0 -110
- package/docs/contracts/implement-ticket-flow.md +0 -625
- package/docs/contracts/init-telemetry.md +0 -132
- package/docs/contracts/injected-block-authenticity-model.md +0 -66
- package/docs/contracts/install-layout.md +0 -249
- package/docs/contracts/install-scopes.md +0 -82
- package/docs/contracts/installed-tools-lockfile.md +0 -144
- package/docs/contracts/installer-agent-mode.md +0 -137
- package/docs/contracts/iron-law-overrides.txt +0 -26
- package/docs/contracts/kernel-membership.md +0 -339
- package/docs/contracts/linear-ai-rules-inclusion.md +0 -143
- package/docs/contracts/linear-ai-three-layers.md +0 -130
- package/docs/contracts/linter-structural-model.md +0 -181
- package/docs/contracts/load-context-budget-model.md +0 -259
- package/docs/contracts/load-context-schema.md +0 -220
- package/docs/contracts/local-analytics.md +0 -160
- package/docs/contracts/local-knowledge-ingestion.md +0 -96
- package/docs/contracts/local-server-api.md +0 -134
- package/docs/contracts/local-server-ports.md +0 -53
- package/docs/contracts/low-impact-corpus-format.md +0 -95
- package/docs/contracts/mcp-beta-criteria.md +0 -130
- package/docs/contracts/mcp-cloud-scope.md +0 -355
- package/docs/contracts/mcp-discovery-phase-notice.md +0 -60
- package/docs/contracts/mcp-phase-1-scope.md +0 -272
- package/docs/contracts/mcp-registry-manifest.schema.json +0 -129
- package/docs/contracts/mcp-tool-inventory.md +0 -64
- package/docs/contracts/mcp-tool-stub-envelope.md +0 -78
- package/docs/contracts/measurement-baseline.md +0 -103
- package/docs/contracts/memory-visibility-v1.md +0 -160
- package/docs/contracts/mental-models.md +0 -336
- package/docs/contracts/migrate-command.md +0 -233
- package/docs/contracts/multi-tool-projection-fidelity.md +0 -134
- package/docs/contracts/namespace.md +0 -125
- package/docs/contracts/no-runtime-boundary.md +0 -61
- package/docs/contracts/one-off-script-lifecycle.md +0 -110
- package/docs/contracts/orchestration-dsl-v1.md +0 -153
- package/docs/contracts/package-self-orientation.md +0 -163
- package/docs/contracts/pilot/agent-authority.md +0 -24
- package/docs/contracts/pilot/direct-answers.md +0 -70
- package/docs/contracts/pilot/language-and-tone.md +0 -63
- package/docs/contracts/plain-language-surface.md +0 -117
- package/docs/contracts/prelaunch-diagnostics.md +0 -151
- package/docs/contracts/profile-system.md +0 -167
- package/docs/contracts/reasoning-discipline-protocol.md +0 -83
- package/docs/contracts/release-pr-gating.md +0 -151
- package/docs/contracts/release-sizing.md +0 -107
- package/docs/contracts/release-trunk-sync.md +0 -105
- package/docs/contracts/review-lens-schema.md +0 -64
- package/docs/contracts/roadmap-complexity-standard.md +0 -138
- package/docs/contracts/role-experience.md +0 -125
- package/docs/contracts/router-blending.md +0 -71
- package/docs/contracts/rule-classification.md +0 -171
- package/docs/contracts/rule-interactions.md +0 -132
- package/docs/contracts/rule-interactions.yml +0 -260
- package/docs/contracts/rule-priority-hierarchy.md +0 -88
- package/docs/contracts/rule-router.md +0 -287
- package/docs/contracts/safety-model.md +0 -129
- package/docs/contracts/session-profile-overlay.md +0 -157
- package/docs/contracts/settings-api.md +0 -264
- package/docs/contracts/settings-gui-agent-mode.schema.json +0 -128
- package/docs/contracts/settings-sync-yaml-subset.md +0 -139
- package/docs/contracts/skill-bundled-assets.md +0 -62
- package/docs/contracts/skill-discovery.md +0 -80
- package/docs/contracts/skill-distribution-channels.md +0 -66
- package/docs/contracts/skill-domains.md +0 -144
- package/docs/contracts/skill-dry-run.md +0 -47
- package/docs/contracts/skill-family-map.yml +0 -915
- package/docs/contracts/smoke-contracts.md +0 -144
- package/docs/contracts/subagent-boundary.md +0 -74
- package/docs/contracts/surface-agent-contracts.md +0 -153
- package/docs/contracts/surface-matrix.md +0 -108
- package/docs/contracts/surface-tiers.md +0 -81
- package/docs/contracts/telegraph-telemetry.md +0 -83
- package/docs/contracts/ticket-bundle-format.md +0 -233
- package/docs/contracts/tier-3-contrib-plugin.md +0 -137
- package/docs/contracts/trust-and-safety.md +0 -144
- package/docs/contracts/ui-stack-extension.md +0 -237
- package/docs/contracts/ui-track-flow.md +0 -329
- package/docs/contracts/universal-skills.md +0 -91
- package/docs/contracts/user-type-schema.md +0 -146
- package/docs/contracts/value-dashboard-spec.md +0 -378
- package/docs/contracts/value-report-schema.md +0 -168
- package/docs/contracts/workflow-packs.md +0 -121
- package/docs/contracts/workspace-boundary.md +0 -84
- package/docs/contracts/workspace-documents.md +0 -144
- package/docs/contracts/write-engine.md +0 -182
- package/docs/cookbook.md +0 -152
- package/docs/customization.md +0 -696
- package/docs/decisions/ADR-001-kernel-swap-deferred.md +0 -109
- package/docs/decisions/ADR-002-kernel-bucket-overrides.md +0 -135
- package/docs/decisions/ADR-003-flat-cluster-subs-and-colon-syntax.md +0 -137
- package/docs/decisions/ADR-004-rule-governance-pruning.md +0 -240
- package/docs/decisions/ADR-005-subagent-worktrees.md +0 -120
- package/docs/decisions/ADR-006-skill-tools-python-pilot.md +0 -114
- package/docs/decisions/ADR-007-agent-discovery-scopes.md +0 -371
- package/docs/decisions/ADR-008-installed-tools-manifest.md +0 -160
- package/docs/decisions/ADR-009-event4u-namespace.md +0 -188
- package/docs/decisions/ADR-010-profile-pack-preset-boundary.md +0 -168
- package/docs/decisions/ADR-011-domain-pack-readiness.md +0 -213
- package/docs/decisions/ADR-012-typescript-cli-shell.md +0 -162
- package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +0 -342
- package/docs/decisions/ADR-014-gui-framework-choice.md +0 -136
- package/docs/decisions/ADR-015-discovery-manifest-contract.md +0 -146
- package/docs/decisions/ADR-016-installer-architecture.md +0 -191
- package/docs/decisions/ADR-017-monorepo-physical-layout.md +0 -261
- package/docs/decisions/ADR-018-trust-and-safety-layer.md +0 -159
- package/docs/decisions/ADR-019-router-json-dist-location.md +0 -124
- package/docs/decisions/ADR-020-global-only-consumer-scope.md +0 -213
- package/docs/decisions/ADR-021-deployment-shape.md +0 -153
- package/docs/decisions/ADR-022-daily-workspace-decomposition.md +0 -140
- package/docs/decisions/ADR-023-host-agent-protocol.md +0 -129
- package/docs/decisions/ADR-024-workspace-v0-feature-floor.md +0 -126
- package/docs/decisions/ADR-025-workspace-chrome.md +0 -119
- package/docs/decisions/ADR-026-explain-mode-translation.md +0 -117
- package/docs/decisions/ADR-027-changelog-machine-vs-manual.md +0 -129
- package/docs/decisions/ADR-028-root-layout.md +0 -147
- package/docs/decisions/ADR-029-multi-workspace-deferred.md +0 -122
- package/docs/decisions/ADR-030-claude-code-command-projection.md +0 -147
- package/docs/decisions/ADR-031-validation-severity-tiers-and-projection-roundtrip.md +0 -97
- package/docs/decisions/ADR-032-linked-projects-scope.md +0 -122
- package/docs/decisions/ADR-033-distribution-identity-npm-primary.md +0 -81
- package/docs/decisions/ADR-034-per-skill-model-recommendation-transport.md +0 -63
- package/docs/decisions/ADR-035-model-capability-tiers.md +0 -104
- package/docs/decisions/ADR-036-global-install-browser-wizard-handoff.md +0 -106
- package/docs/decisions/ADR-037-cost-profile-untangle.md +0 -117
- package/docs/decisions/ADR-038-canonical-settings-path.md +0 -96
- package/docs/decisions/ADR-039-claude-skills-untracked.md +0 -139
- package/docs/decisions/ADR-040-execution-model-projection-time-filtering.md +0 -244
- package/docs/decisions/ADR-041-controlled-command-verbs.md +0 -133
- package/docs/decisions/ADR-042-runtime-resolver-decision-gate.md +0 -113
- package/docs/decisions/ADR-043-monorepo-collapse-to-src-domains.md +0 -128
- package/docs/decisions/ADR-044-command-naming-scheme-hyphenated.md +0 -250
- package/docs/decisions/ADR-045-src-source-layout-and-profiles-as-views.md +0 -111
- package/docs/decisions/ADR-046-thin-command-principle.md +0 -93
- package/docs/decisions/ADR-047-framework-neutral-stack-adaptive-commands.md +0 -94
- package/docs/decisions/ADR-048-command-justification-rule.md +0 -106
- package/docs/decisions/ADR-049-configuration-trust-boundary.md +0 -132
- package/docs/decisions/ADR-050-workspace-vs-package-root-boundary.md +0 -121
- package/docs/decisions/ADR-051-uncondensed-source-container-relocation.md +0 -114
- package/docs/decisions/ADR-052-packages-removal-and-pack-home-migration.md +0 -86
- package/docs/decisions/ADR-053-agents-namespace-dual-role-resolution.md +0 -132
- package/docs/decisions/ADR-054-rule-adherence-decay-triggered-restate.md +0 -143
- package/docs/decisions/ADR-055-flow-layer-data-model.md +0 -235
- package/docs/decisions/ADR-056-unvalidated-video-adapters-disposition.md +0 -124
- package/docs/decisions/ADR-057-consolidation-evidence-gate-outcomes.md +0 -135
- package/docs/decisions/ADR-058-condensed-output-relocation-to-dist.md +0 -94
- package/docs/decisions/ADR-059-render-resume-filesystem-as-state.md +0 -161
- package/docs/decisions/ADR-060-comfyui-sandbox-model.md +0 -154
- package/docs/decisions/ADR-061-corpus-grounding-layer.md +0 -230
- package/docs/decisions/ADR-062-encrypt-at-rest-store-architecture.md +0 -121
- package/docs/decisions/ADR-063-append-jsonl-encryption-deferred.md +0 -83
- package/docs/decisions/ADR-064-append-jsonl-per-record-encryption.md +0 -113
- package/docs/decisions/ADR-065-tier3-inbox-handoff-v0.md +0 -86
- package/docs/decisions/ADR-066-skill-body-prerendering.md +0 -93
- package/docs/decisions/ADR-067-glama-registry-listing.md +0 -259
- package/docs/decisions/ADR-068-host-tier-detection.md +0 -90
- package/docs/decisions/ADR-069-prompt-renderer.md +0 -97
- package/docs/decisions/ADR-070-tier1-drive-loop.md +0 -94
- package/docs/decisions/ADR-071-launch-drive-integration.md +0 -95
- package/docs/decisions/ADR-072-codex-gemini-drive-configs.md +0 -90
- package/docs/decisions/ADR-073-drive-health-kill-switch.md +0 -81
- package/docs/decisions/ADR-074-drive-kill-switch-auto-recovery.md +0 -84
- package/docs/decisions/ADR-075-workspace-gui-drive.md +0 -83
- package/docs/decisions/ADR-076-workspace-multi-turn.md +0 -92
- package/docs/decisions/ADR-077-workspace-followup-gui.md +0 -70
- package/docs/decisions/ADR-078-drive-health-panel.md +0 -70
- package/docs/decisions/ADR-079-workspace-host-picker.md +0 -81
- package/docs/decisions/ADR-080-host-session-expired-410.md +0 -92
- package/docs/decisions/ADR-081-drive-health-reset-and-410-affordance.md +0 -71
- package/docs/decisions/ADR-082-410-one-click-relaunch.md +0 -58
- package/docs/decisions/ADR-083-session-thread-and-arbitrary-continuation.md +0 -85
- package/docs/decisions/ADR-084-drive-health-refresh-on-drive.md +0 -52
- package/docs/decisions/ADR-085-mcp-stdio-end-user-distribution-shape.md +0 -158
- package/docs/decisions/ADR-086-read-only-cross-agent-mcp-discovery-helper.md +0 -171
- package/docs/decisions/ADR-087-installer-e2e-test-strategy.md +0 -111
- package/docs/decisions/ADR-088-no-external-runtime-federation.md +0 -144
- package/docs/decisions/ADR-089-lean-local-plugin-install.md +0 -111
- package/docs/decisions/ADR-090-visibility-command-frontmatter-field.md +0 -95
- package/docs/decisions/ADR-091-split-meta-capability-packs.md +0 -113
- package/docs/decisions/ADR-092-defer-command-tier-alias-removal.md +0 -117
- package/docs/decisions/ADR-093-ai-council-config-user-global.md +0 -117
- package/docs/decisions/ADR-094-agent-memory-layer-removal.md +0 -94
- package/docs/decisions/ADR-095-workspace-boundary-contract.md +0 -108
- package/docs/decisions/ADR-096-analysis-workbench.md +0 -110
- package/docs/decisions/ADR-097-mission-recipe-privilege-boundary.md +0 -121
- package/docs/decisions/ADR-098-evidence-first-structure-discovery.md +0 -154
- package/docs/decisions/ADR-099-file-first-pattern-library.md +0 -87
- package/docs/decisions/ADR-100-global-knowledge-card-sharing.md +0 -140
- package/docs/decisions/ADR-101-ticket-bundle-emission.md +0 -109
- package/docs/decisions/ADR-102-ticket-handoff-paste-and-mcp.md +0 -72
- package/docs/decisions/ADR-103-global-knowledge-default-off-until-measured.md +0 -92
- package/docs/decisions/ADR-104-ai-council-config-global-only.md +0 -119
- package/docs/decisions/ADR-105-automatic-subagent-orchestration.md +0 -108
- package/docs/decisions/ADR-106-recursive-verification-benchmark-gate.md +0 -126
- package/docs/decisions/ADR-107-legal-domain-pack-adoption.md +0 -70
- package/docs/decisions/ADR-108-open-source-forever-no-commercial-tier.md +0 -46
- package/docs/decisions/ADR-109-subagent-v1-contract.md +0 -248
- package/docs/decisions/ADR-110-discipline-profile-resolution-locus.md +0 -112
- package/docs/decisions/ADR-111-canonical-glama-listing.md +0 -97
- package/docs/decisions/ADR-112-stdio-lite-stays-read-only.md +0 -92
- package/docs/decisions/ADR-113-ci-native-release-label-trigger.md +0 -209
- package/docs/decisions/ADR-114-commit-policy-iron-law-override.md +0 -85
- package/docs/decisions/ADR-115-command-cluster-consolidation-phase-4.md +0 -91
- package/docs/decisions/ADR-116-memory-tripwire-activation-path.md +0 -144
- package/docs/decisions/ADR-117-subagents-auto-default-on.md +0 -89
- package/docs/decisions/ADR-118-loop-engineering-boundaries.md +0 -162
- package/docs/decisions/ADR-119-global-knowledge-default-on.md +0 -104
- package/docs/decisions/ADR-120-council-chairman-mode.md +0 -70
- package/docs/decisions/ADR-121-knowledge-sensitivity-classes.md +0 -90
- package/docs/decisions/ADR-122-adversarial-verification-council.md +0 -166
- package/docs/decisions/ADR-123-runtime-security-scope-and-spawn-hardening.md +0 -142
- package/docs/decisions/ADR-124-embedded-engine-doctrine.md +0 -255
- package/docs/decisions/ADR-125-doc-screenshot-anonymization.md +0 -131
- package/docs/decisions/ADR-126-internet-reach-operator-tooling.md +0 -254
- package/docs/decisions/ADR-127-enforcement-claims-must-resolve.md +0 -150
- package/docs/decisions/ADR-128-executable-evidence-and-measured-escalation.md +0 -201
- package/docs/decisions/ADR-200-python-to-typescript-migration.md +0 -203
- package/docs/decisions/ADR-rule-kernel-and-router.md +0 -133
- package/docs/decisions/INDEX.md +0 -157
- package/docs/decisions/engine-reclassification-2026-07.md +0 -104
- package/docs/deploy/connector-setup.md +0 -129
- package/docs/deploy/env-vars.md +0 -70
- package/docs/deploy/policy-cookbook.md +0 -130
- package/docs/deploy/quickstart.md +0 -112
- package/docs/deploy/small-team-recipe.md +0 -148
- package/docs/deploy/team-deployment-posture.md +0 -111
- package/docs/design/adversarial-council-eval.md +0 -106
- package/docs/design/council-vs-solo-baseline.md +0 -92
- package/docs/design/cross-model-parity-eval.md +0 -82
- package/docs/design/length-neutral-judge-rerun.md +0 -92
- package/docs/design/utilization-window-criteria.md +0 -51
- package/docs/development.md +0 -230
- package/docs/distribution/awesome-list-submission.md +0 -46
- package/docs/distribution/consumer-matrix.md +0 -96
- package/docs/distribution/launch-story-draft.md +0 -58
- package/docs/distribution/mcp-submission-checklist.md +0 -95
- package/docs/distribution/public-install-smoke.md +0 -68
- package/docs/distribution/registries.md +0 -126
- package/docs/distribution/registry-submissions.md +0 -85
- package/docs/distribution/telemetry-privacy.md +0 -128
- package/docs/distribution/telemetry-schema.md +0 -174
- package/docs/distribution/topics-equivalents-decay-policy.md +0 -51
- package/docs/end-to-end-walkthroughs.md +0 -165
- package/docs/enforcement-by-host.md +0 -51
- package/docs/examples/agent-user.example.md +0 -22
- package/docs/experiences/agency.md +0 -49
- package/docs/experiences/content_creator.md +0 -49
- package/docs/experiences/developer.md +0 -49
- package/docs/experiences/finance.md +0 -50
- package/docs/experiences/founder.md +0 -49
- package/docs/experiences/ops.md +0 -49
- package/docs/featured-commands.md +0 -27
- package/docs/featured-skills.md +0 -95
- package/docs/flows.md +0 -67
- package/docs/getting-started-by-role.md +0 -190
- package/docs/getting-started-laravel.md +0 -72
- package/docs/getting-started-local-stdio.md +0 -77
- package/docs/getting-started.md +0 -254
- package/docs/github-topics.md +0 -93
- package/docs/governance-advantage.md +0 -72
- package/docs/governance.md +0 -96
- package/docs/guides/cross-repo-linked-projects.md +0 -93
- package/docs/guides/cross-repo-retrieval.md +0 -61
- package/docs/guides/frontend-design-corpus-refresh.md +0 -83
- package/docs/guides/gated-platform-reads.md +0 -221
- package/docs/guides/local-analytics.md +0 -125
- package/docs/guides/local-knowledge.md +0 -127
- package/docs/guides/skill-discovery.md +0 -71
- package/docs/guides/skill-preview.md +0 -71
- package/docs/hook-payload-capture.md +0 -221
- package/docs/install-friction-report.md +0 -66
- package/docs/installation.md +0 -959
- package/docs/maintainers/branch-protection.md +0 -105
- package/docs/maintainers/dev-mode.md +0 -106
- package/docs/maintainers/optional-media-deps.md +0 -50
- package/docs/maintainers/system-map.md +0 -85
- package/docs/mcp-registries.md +0 -94
- package/docs/mcp-server.md +0 -175
- package/docs/mcp.md +0 -147
- package/docs/media/proof-demo.cast +0 -14
- package/docs/media/proof-demo.gif +0 -0
- package/docs/migration/consumer-template-consumption-model.md +0 -145
- package/docs/migration/divergences/README.md +0 -55
- package/docs/migration/divergences/_template.md +0 -50
- package/docs/migration/divergences/bench-stats-float-precision.md +0 -72
- package/docs/migration/divergences/mcp-telemetry-node-sqlite.md +0 -61
- package/docs/migration/divergences/pack-mcp-content-gzip-body.md +0 -53
- package/docs/migration/divergences/src-scripts-build_cloud_bundle.md +0 -63
- package/docs/migration/divergences/src-scripts-check_memory.md +0 -91
- package/docs/migration/divergences/src-scripts-inventory_abstraction_budget.md +0 -65
- package/docs/migration/divergences/src-scripts-lint_marketplace.md +0 -57
- package/docs/migration/divergences/src-scripts-lint_mcp_registry_manifest.md +0 -70
- package/docs/migration/divergences/src-scripts-spotcheck_thin_root.md +0 -60
- package/docs/migration/divergences/src-scripts-validate_agent_settings.md +0 -58
- package/docs/migration/node-floor.md +0 -86
- package/docs/migration/v1-to-v2.md +0 -156
- package/docs/migration/yaml-roundtrip-spike.md +0 -163
- package/docs/migrations/commands-1.15.0.md +0 -117
- package/docs/parity/bench-external.json +0 -58
- package/docs/parity/bench.json +0 -41
- package/docs/parity/command-frontmatter.md +0 -60
- package/docs/parity/external-runtime.md +0 -46
- package/docs/personas.md +0 -178
- package/docs/positioning-evidence.md +0 -86
- package/docs/profiles.md +0 -108
- package/docs/proof.md +0 -252
- package/docs/quality.md +0 -98
- package/docs/readme-split-plan.md +0 -102
- package/docs/recruits/_template.md +0 -81
- package/docs/release-runbook.md +0 -141
- package/docs/role-experiences.md +0 -19
- package/docs/safety.md +0 -30
- package/docs/second-brain-scope.md +0 -116
- package/docs/self-review-gate.md +0 -65
- package/docs/setup/enterprise-and-offline.md +0 -201
- package/docs/setup/mcp-client-config.md +0 -358
- package/docs/setup/mcp-cloud-endpoints.md +0 -116
- package/docs/setup/mcp-cloud-registry-listing.md +0 -99
- package/docs/setup/mcp-cloud-setup.md +0 -183
- package/docs/setup/mcp-r2-bootstrap.md +0 -82
- package/docs/setup/mcp-server-docker.md +0 -101
- package/docs/setup/per-ide/aider.md +0 -48
- package/docs/setup/per-ide/antigravity.md +0 -68
- package/docs/setup/per-ide/augment.md +0 -89
- package/docs/setup/per-ide/claude-code.md +0 -97
- package/docs/setup/per-ide/claude-desktop.md +0 -207
- package/docs/setup/per-ide/cline.md +0 -43
- package/docs/setup/per-ide/codebuddy.md +0 -63
- package/docs/setup/per-ide/codex.md +0 -46
- package/docs/setup/per-ide/continue.md +0 -68
- package/docs/setup/per-ide/copilot.md +0 -80
- package/docs/setup/per-ide/cursor.md +0 -125
- package/docs/setup/per-ide/droid.md +0 -65
- package/docs/setup/per-ide/gemini-cli.md +0 -45
- package/docs/setup/per-ide/jetbrains.md +0 -76
- package/docs/setup/per-ide/kilocode.md +0 -66
- package/docs/setup/per-ide/kiro.md +0 -72
- package/docs/setup/per-ide/opencode.md +0 -62
- package/docs/setup/per-ide/qoder.md +0 -63
- package/docs/setup/per-ide/roocode.md +0 -68
- package/docs/setup/per-ide/trae.md +0 -63
- package/docs/setup/per-ide/warp.md +0 -63
- package/docs/setup/per-ide/windsurf.md +0 -109
- package/docs/setup/per-ide/zed.md +0 -73
- package/docs/showcase.md +0 -209
- package/docs/skill-duplication-findings.md +0 -91
- package/docs/skills-catalog.md +0 -265
- package/docs/skills-taxonomy.md +0 -90
- package/docs/spawn-site-policy.md +0 -72
- package/docs/succession.md +0 -80
- package/docs/threat-model.md +0 -30
- package/docs/troubleshooting.md +0 -155
- package/docs/ui-track-mental-model.md +0 -121
- package/docs/us-vs-the-category.md +0 -38
- package/docs/value.md +0 -86
- package/docs/walkthroughs/assets/workspace-role-grid.png +0 -0
- package/docs/walkthroughs/assets/workspace-session-started.png +0 -0
- package/docs/walkthroughs/assets/workspace-task-picker.png +0 -0
- package/docs/walkthroughs/daily-workspace-a11y.md +0 -87
- package/docs/walkthroughs/daily-workspace.md +0 -127
- package/docs/wedge/production-validator/README.md +0 -81
- package/docs/wedge/production-validator/first-run-check.sh +0 -42
- package/docs/wedge/production-validator/production-validator.md +0 -83
- package/docs/wizard.md +0 -173
- package/src/scripts/postinstall_gui.ts +0 -129
|
@@ -100,8 +100,8 @@ Do NOT use when:
|
|
|
100
100
|
[`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md)
|
|
101
101
|
before the polish step (Visual V1–V7, Layout L1–L8 are the React-component
|
|
102
102
|
slop tells); the objective quality floors (WCAG contrast, focus-visible,
|
|
103
|
-
reduced-motion) are
|
|
104
|
-
|
|
103
|
+
reduced-motion) are validated via `accessibility-auditor`'s checklist —
|
|
104
|
+
cite its verdict rather than eyeballing.
|
|
105
105
|
|
|
106
106
|
## Covered primitives
|
|
107
107
|
|
|
@@ -41,6 +41,12 @@ Land a verified result by running a depth-bounded
|
|
|
41
41
|
the only compute knob, every level budgeted, and the loop default-off
|
|
42
42
|
until a benchmark gate authorises it per host.
|
|
43
43
|
|
|
44
|
+
> **Disposition (2026-07-28, honest null — TERMINAL).** Recursive-verification
|
|
45
|
+
> benchmark resolved as published null (no measured lift over single-pass
|
|
46
|
+
> verification; see `docs/benchmark.md`). `verification.recursive` stays
|
|
47
|
+
> default-off bound to that null; removal at next major unless external
|
|
48
|
+
> evidence appears first. NOT sold as a quality-lift mechanism.
|
|
49
|
+
|
|
44
50
|
## The Iron Law
|
|
45
51
|
|
|
46
52
|
```
|
|
@@ -182,9 +182,9 @@ naming (e.g. `feat/` vs `fix/` vs `refactor/` prefix), and
|
|
|
182
182
|
risks instead of inventing terms.
|
|
183
183
|
|
|
184
184
|
The match lists and `require_count` thresholds are owned by
|
|
185
|
-
`detection-map.yml` — edit the map, not this skill
|
|
186
|
-
|
|
187
|
-
|
|
185
|
+
`detection-map.yml` — edit the map, not this skill (DE + EN fixtures,
|
|
186
|
+
repo-aware + graceful-degrade coverage are regression-locked in this
|
|
187
|
+
package's own test suite).
|
|
188
188
|
|
|
189
189
|
### 3. Orchestrate
|
|
190
190
|
|
|
@@ -301,6 +301,10 @@ to every roadmap you author.
|
|
|
301
301
|
behind the scope? `## Provenance` block with `ENC1:` link? inlined
|
|
302
302
|
council convergence? anti-dump acceptance criterion? (Internally
|
|
303
303
|
originated → these must be **absent**, not empty.)
|
|
304
|
+
8. *Inbox-sourced only:* roadmap consumed an `agents/tmp/` file as input →
|
|
305
|
+
file moved to `agents/tmp.old/<name>` in the SAME reply, Source line
|
|
306
|
+
pointing at the `tmp.old/` path? (Per `agents-layout § User Inbox
|
|
307
|
+
Workflow`. Move only the named input file(s); never sweep the inbox.)
|
|
304
308
|
|
|
305
309
|
## Do NOT
|
|
306
310
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
model_tier: medium
|
|
3
3
|
name: rtk-output-filtering
|
|
4
|
-
description: "Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer
|
|
4
|
+
description: "Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer, third-party Apache-2.0; upstream reports 60-90% token savings). Covers installation, configuration, and usage patterns."
|
|
5
5
|
domain: process
|
|
6
6
|
execution:
|
|
7
7
|
type: assisted
|
|
@@ -23,9 +23,17 @@ packs:
|
|
|
23
23
|
|
|
24
24
|
## What
|
|
25
25
|
|
|
26
|
-
High-performance CLI proxy that reduces LLM token consumption
|
|
27
|
-
|
|
26
|
+
High-performance CLI proxy that reduces LLM token consumption on common dev
|
|
27
|
+
commands through intelligent output filtering (whitespace, boilerplate,
|
|
28
28
|
comments, duplicate log messages). Single Rust binary, <10ms startup overhead.
|
|
29
|
+
**Third-party Apache-2.0 tool** (rtk-ai upstream — an external project, not part of this package).
|
|
30
|
+
|
|
31
|
+
**Savings, honestly stated:** upstream reports 60-90% (their estimate —
|
|
32
|
+
"actual savings vary"). agent-config's own scoped spot-measurement
|
|
33
|
+
(2026-07-28, one repo, one macOS machine, 8-command corpus) landed at
|
|
34
|
+
**33% overall, 0-57% per command** — verbose commands (`git status`,
|
|
35
|
+
`git log`, `ls -la`) save ~55%, already-compact output (`--oneline`,
|
|
36
|
+
`--stat`) passes through at ~0%. See `internal/bench/rtk-savings/RESULTS.md`.
|
|
29
37
|
|
|
30
38
|
**Docs:** https://www.mintlify.com/rtk-ai/rtk
|
|
31
39
|
**Repo:** https://github.com/rtk-ai/rtk
|
|
@@ -34,9 +42,9 @@ comments, duplicate log messages). Single Rust binary, <10ms startup overhead.
|
|
|
34
42
|
|
|
35
43
|
Wrap any CLI command with `rtk`:
|
|
36
44
|
```bash
|
|
37
|
-
rtk git status #
|
|
38
|
-
rtk git log # compact log output
|
|
39
|
-
rtk cargo test #
|
|
45
|
+
rtk git status # verbose status → compact (measured ~55% here)
|
|
46
|
+
rtk git log # compact log output (measured ~55% here)
|
|
47
|
+
rtk cargo test # upstream: only failures shown
|
|
40
48
|
rtk npm test # same for JS/TS
|
|
41
49
|
rtk docker compose ps # compact container status
|
|
42
50
|
```
|
|
@@ -70,12 +78,23 @@ outside onboarding, follow the Installation section below and set
|
|
|
70
78
|
|
|
71
79
|
## Installation (on-demand)
|
|
72
80
|
|
|
73
|
-
Invoked
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
1.
|
|
77
|
-
|
|
78
|
-
|
|
81
|
+
Invoked when rtk is not on `PATH` and the user explicitly asks to install
|
|
82
|
+
it. Never fire unsolicited.
|
|
83
|
+
|
|
84
|
+
1. Offer the verified per-OS install path (same map as
|
|
85
|
+
`src/install/rtkDetection.ts` / `docs/contracts/rtk-detection.md`):
|
|
86
|
+
- macOS → `brew install rtk` (official homebrew-core formula)
|
|
87
|
+
- Linux → `curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | sh`
|
|
88
|
+
(installs to `~/.local/bin`)
|
|
89
|
+
- Windows → `winget install rtk-ai.rtk` (plus the documented ripgrep
|
|
90
|
+
dependency: `winget install BurntSushi.ripgrep.MSVC`); winget-less
|
|
91
|
+
images use the upstream `rtk-x86_64-pc-windows-msvc.zip` release.
|
|
92
|
+
**NEVER `cargo install rtk`** — the bare crates.io `rtk` crate is the
|
|
93
|
+
unrelated Rust Type Kit, not Rust Token Killer.
|
|
94
|
+
2. Run the installer only on explicit confirmation. On success:
|
|
95
|
+
1. `rtk gain` to verify IDENTITY (the savings dashboard prints "RTK
|
|
96
|
+
Token Savings" only on Rust Token Killer — `rtk --version` cannot
|
|
97
|
+
distinguish the two same-name tools).
|
|
79
98
|
2. `rtk init --global` to enable auto-rewrite hooks.
|
|
80
99
|
3. Apply **Post-Install Setup** below (telemetry, tee, audit logging).
|
|
81
100
|
4. Generate project-local filters (see Post-Install Setup).
|
|
@@ -80,13 +80,13 @@ For each approved verdict:
|
|
|
80
80
|
|
|
81
81
|
* **merge** → rewrite the surviving rule to cover both domains;
|
|
82
82
|
delete the absorbed one; update any `routes_to:` references.
|
|
83
|
-
* **delete** → remove the file from
|
|
83
|
+
* **delete** → remove the file from `src/rules/`
|
|
84
84
|
and the corresponding `dist/agent-src/rules/` projection.
|
|
85
85
|
* **move-to-context** → extract the body into
|
|
86
|
-
|
|
86
|
+
`src/agent-src/contexts/<area>/<name>.md`, replace the
|
|
87
87
|
rule body with the obligation + a `load_context:` pointer.
|
|
88
88
|
* **promote-to-skill** → create
|
|
89
|
-
|
|
89
|
+
`src/skills/<name>/SKILL.md`, replace the rule
|
|
90
90
|
with an auto-trigger stub that routes to it (or delete the rule
|
|
91
91
|
entirely if the skill's own trigger suffices).
|
|
92
92
|
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
---
|
|
2
|
+
model_tier: medium
|
|
3
|
+
name: schema-review
|
|
4
|
+
description: "Use when reviewing a migration diff or schema change for scale hazards — indexes, unsafe migrations, unbounded growth, N+1. Triggers on 'review this migration', 'will this scale'."
|
|
5
|
+
domain: engineering
|
|
6
|
+
workspaces:
|
|
7
|
+
- engineering
|
|
8
|
+
packs:
|
|
9
|
+
- scale-discipline
|
|
10
|
+
trust:
|
|
11
|
+
level: professional
|
|
12
|
+
install:
|
|
13
|
+
default: false
|
|
14
|
+
removable: true
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# schema-review
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
|
|
21
|
+
- A migration diff, new migration file, or schema change is under review
|
|
22
|
+
and the question is scale-shaped: indexes, reversibility, growth,
|
|
23
|
+
query patterns against the new columns.
|
|
24
|
+
- The user asks "will this scale", "review this migration", "check the
|
|
25
|
+
schema", or a PR touches `migrations/`, `schema.prisma`, or raw `.sql`
|
|
26
|
+
migration files.
|
|
27
|
+
- NOT for runtime performance analysis of live traffic (no APM here —
|
|
28
|
+
route to `performance-analysis`) and NOT for authoring a new migration
|
|
29
|
+
from scratch (route to `laravel-migration` or the stack-native tool,
|
|
30
|
+
then come back with the diff).
|
|
31
|
+
|
|
32
|
+
## Procedure
|
|
33
|
+
|
|
34
|
+
1. **Detect the stack surface** in the diff: Laravel migrations
|
|
35
|
+
(`database/migrations/*.php`), Prisma (`schema.prisma` +
|
|
36
|
+
`prisma/migrations/**/migration.sql`), raw SQL (`*.sql`). One diff can
|
|
37
|
+
carry several.
|
|
38
|
+
2. **Run the deterministic linter** on the touched files plus the query
|
|
39
|
+
surface that references the changed tables:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npx tsx node_modules/@event4u/agent-config/src/scripts/lint_persistence.ts -- --dir <path> [--stack eloquent|prisma|raw-sql] --format json
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
The linter emits `gate` findings (pattern-detected: F1 N+1, F2
|
|
46
|
+
index-parity, F3 unbounded reads, F6 migration-safety, F7
|
|
47
|
+
growth-budget, F8 audit-coverage, F9 sync-in-handler, F11 non-durable
|
|
48
|
+
async) and `advice` findings (heuristics — never treat as blockers).
|
|
49
|
+
3. **Walk the gap table** — for every `gate` finding decide: fix, or
|
|
50
|
+
waiver with a reason (`// no-index: <reason>`, `// sync-required:
|
|
51
|
+
<reason>`, `-- no-retention: <reason>`, …). An empty waiver reason is
|
|
52
|
+
itself a finding.
|
|
53
|
+
4. **Check the R-A6/R-A7 invariants by hand** where the linter is blind:
|
|
54
|
+
reversibility of data transformations, retention policy for any new
|
|
55
|
+
append-only table (the `-- retention: <policy>` line), backfill plan
|
|
56
|
+
for new NOT NULL columns on large tables.
|
|
57
|
+
5. **Report waiver density neutrally** — count waivers per rule; state
|
|
58
|
+
both readings (informed exceptions vs rule misfit) and let the human
|
|
59
|
+
decide. Density alone is never a verdict.
|
|
60
|
+
|
|
61
|
+
## Output
|
|
62
|
+
|
|
63
|
+
The review MUST contain:
|
|
64
|
+
|
|
65
|
+
1. **Gap table** — one row per finding: `rule · file:line · finding ·
|
|
66
|
+
proposed action (fix | waiver | accepted)`, gate findings first,
|
|
67
|
+
advice findings clearly marked as advice.
|
|
68
|
+
2. **Waiver-density line** — `N waivers across M findings` with the
|
|
69
|
+
two-reading note (informed exceptions vs rule misfit).
|
|
70
|
+
3. A one-line verdict: ready / needs fixes / needs human schema decision
|
|
71
|
+
— never a bare "looks good" without the table.
|
|
72
|
+
|
|
73
|
+
## Gotcha
|
|
74
|
+
|
|
75
|
+
- The linter proves **pattern presence**, not instance-level correctness
|
|
76
|
+
— a flagged `Http::` call in a controller may be legitimately sync
|
|
77
|
+
(then it gets a `// sync-required:` waiver with a reason), and a clean
|
|
78
|
+
run does not prove the schema scales. Say what was checked, not more.
|
|
79
|
+
- Prisma's `@relation` fields are indexed implicitly on some connectors
|
|
80
|
+
and not on others — when the linter reports a missing FK index on a
|
|
81
|
+
Prisma model, verify the connector before calling it a defect.
|
|
82
|
+
|
|
83
|
+
## Do NOT
|
|
84
|
+
|
|
85
|
+
- Do NOT gate a review on `advice`-tier findings (F4 denormalization,
|
|
86
|
+
F10 event-decoupling heuristics) — they are review inputs, not
|
|
87
|
+
blockers.
|
|
88
|
+
- Do NOT strip or rewrite existing waivers — surface stale-looking ones
|
|
89
|
+
and ask.
|
|
90
|
+
- Do NOT invent index recommendations for columns the query surface
|
|
91
|
+
never filters or orders by — index parity cuts both ways; unused
|
|
92
|
+
indexes cost write throughput.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"skill": "schema-review",
|
|
3
|
+
"last_eval": "2026-07-27",
|
|
4
|
+
"description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers DE+EN phrasings for reviewing a migration/schema diff for scale hazards. Should-not-trigger covers near-miss neighbours: authoring a migration (laravel-migration), live-traffic performance (performance-analysis), audit-tier selection (history-design), generic code review.",
|
|
5
|
+
"queries": [
|
|
6
|
+
{ "q": "review this migration for missing indexes before I merge", "trigger": true },
|
|
7
|
+
{ "q": "will this schema change scale to 100k rows?", "trigger": true },
|
|
8
|
+
{ "q": "prüfe meine Migration auf Skalierungsprobleme", "trigger": true },
|
|
9
|
+
{ "q": "check the new schema.prisma diff for unsafe changes", "trigger": true },
|
|
10
|
+
{ "q": "does this ALTER TABLE need CONCURRENTLY and a default?", "trigger": true },
|
|
11
|
+
{ "q": "create a migration that adds a status column to orders", "trigger": false },
|
|
12
|
+
{ "q": "the dashboard endpoint is slow in production, profile it", "trigger": false },
|
|
13
|
+
{ "q": "which audit log mechanism should we use for tenants?", "trigger": false },
|
|
14
|
+
{ "q": "review my pull request for code quality", "trigger": false },
|
|
15
|
+
{ "q": "wie lege ich einen Index in MySQL an?", "trigger": false }
|
|
16
|
+
]
|
|
17
|
+
}
|
|
@@ -104,14 +104,13 @@ Telemetry / APM → strip from request/response captures; allowlist headers.
|
|
|
104
104
|
The scanning gates (Step 4) are the CI/pre-commit nets. The **earliest** gate is
|
|
105
105
|
the agent itself: before it writes a credential into a tracked file or stages a
|
|
106
106
|
commit, the [`secret-vcs-guard`](../../rules/secret-vcs-guard.md) rule runs the
|
|
107
|
-
`secret_detector` library
|
|
107
|
+
`secret_detector` library and, on a hit,
|
|
108
108
|
STOPS → shows the match (`file:line` · kind · masked · why) → asks via numbered
|
|
109
109
|
options → offers the tiered alternative below. It never silently commits and
|
|
110
110
|
never silently strips. VCS-agnostic: the same detector runs against the diff for
|
|
111
111
|
git, SVN, and Mercurial (SVN/hg native hooks are server-side, a stronger but
|
|
112
|
-
later net). The deterministic CI backstop is `check_secret_leak`
|
|
113
|
-
|
|
114
|
-
defense.
|
|
112
|
+
later net). The deterministic CI backstop is `check_secret_leak` — the agent
|
|
113
|
+
gate is one layer, not the whole defense.
|
|
115
114
|
|
|
116
115
|
**False positives — audited allowlist, never a global mute.** Suppress a
|
|
117
116
|
confirmed non-secret with an inline `# secret-allow` marker on the line, or a
|
|
@@ -148,7 +148,7 @@ After findings, add **Rejected candidates** section: one line per look-dangerous
|
|
|
148
148
|
## Gotcha
|
|
149
149
|
|
|
150
150
|
- Don't report theoretical vulnerabilities without a concrete attack vector — false positives erode trust.
|
|
151
|
-
- The model tends to flag framework-handled security as issues (e.g., Laravel's CSRF is already handled).
|
|
151
|
+
- The model tends to flag framework-handled security as issues (e.g., Laravel's CSRF or Rails' `protect_from_forgery` is already handled).
|
|
152
152
|
- Always check if a finding is already mitigated by middleware or configuration before reporting it.
|
|
153
153
|
|
|
154
154
|
## Do NOT
|
|
@@ -55,7 +55,7 @@ Do NOT use when:
|
|
|
55
55
|
|
|
56
56
|
1. **Scope** — name the module/paths under assessment; list entry points (routes, jobs, commands, webhooks). Scorecard without stated scope is not reproducible.
|
|
57
57
|
2. **Assess each category** — inspect the code the category names. Every rating cites evidence:
|
|
58
|
-
- Positive evidence: `file:line` of the control (`app/Http/Requests/…:12`).
|
|
58
|
+
- Positive evidence: `file:line` of the control (`app/Http/Requests/…:12`, `src/guards/auth.guard.ts:12`).
|
|
59
59
|
- Absence evidence: the searches run that came back empty (name the grep patterns) — "not found" beats "probably missing".
|
|
60
60
|
- Multi-tenant N/A: single-tenant systems rate category 8 `N/A`; drops out of the roll-up.
|
|
61
61
|
3. **Roll up deterministically** — overall rating is computed, not vibed:
|
|
@@ -115,8 +115,8 @@ Decide what to create:
|
|
|
115
115
|
> the exact wording is recoverable, and verify against it rather than trusting
|
|
116
116
|
> the summary.
|
|
117
117
|
|
|
118
|
-
- **New rule** → create in
|
|
119
|
-
- **New skill** → use `skill-writing` skill, create in
|
|
118
|
+
- **New rule** → create in `src/rules/`, follow rule conventions
|
|
119
|
+
- **New skill** → use `skill-writing` skill, create in `src/skills/`
|
|
120
120
|
- **Update existing** → use `skill-management` skill
|
|
121
121
|
|
|
122
122
|
After creation:
|
|
@@ -175,7 +175,7 @@ Ask the user:
|
|
|
175
175
|
- Do NOT skip the promotion gate — it prevents skill/rule bloat
|
|
176
176
|
- Do NOT create both a rule AND a skill for the same learning
|
|
177
177
|
- Do NOT auto-push without user permission
|
|
178
|
-
- Do NOT create project-specific content in
|
|
178
|
+
- Do NOT create project-specific content in `src/`
|
|
179
179
|
- Do NOT run this pipeline for trivial learnings
|
|
180
180
|
|
|
181
181
|
## References
|
|
@@ -189,7 +189,7 @@ approval-gated propose / pick loop with at most two rounds.
|
|
|
189
189
|
### 1c. Propose a trigger-eval stub (new skills only)
|
|
190
190
|
|
|
191
191
|
When creating a new skill, propose a stub
|
|
192
|
-
|
|
192
|
+
`src/skills/{name}/evals/triggers.json` before writing
|
|
193
193
|
the body. Draw the queries from Phase A of the drafting protocol (the
|
|
194
194
|
user's "should trigger" and "must not trigger" answers).
|
|
195
195
|
|
|
@@ -531,7 +531,7 @@ content).
|
|
|
531
531
|
|
|
532
532
|
## Do NOT
|
|
533
533
|
|
|
534
|
-
* Write documentation-style, pointer-only, or too-broad skills ("Laravel skill")
|
|
534
|
+
* Write documentation-style, pointer-only, or too-broad skills ("Laravel skill", "Django skill")
|
|
535
535
|
* Skip Procedure or use vague validation
|
|
536
536
|
* Exceed size limits (see `docs/guidelines/agent-infra/size-and-scope.md`)
|
|
537
537
|
* Duplicate rules
|
|
@@ -38,9 +38,9 @@ discover the real source → Evidence Report (Verified / Assumed / Gaps) →
|
|
|
38
38
|
Scaffold the report cheaply so it never gets skipped:
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
41
|
+
npx tsx node_modules/@event4u/agent-config/src/scripts/evidence_report.ts git-state # fail-fast: abort if a rebase/merge/cherry-pick is in progress
|
|
42
|
+
npx tsx node_modules/@event4u/agent-config/src/scripts/evidence_report.ts init --task "<task>" # writes the gitignored session report
|
|
43
|
+
npx tsx node_modules/@event4u/agent-config/src/scripts/evidence_report.ts add --bucket verified --claim "users.email is unique" --source "db/schema/users.sql:23"
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
**Provenance on every item** (`observed_at` / `source` / `version`). Within a
|
|
@@ -175,10 +175,10 @@ the per-session Evidence Report above. Append to the knowledge intake —
|
|
|
175
175
|
never write a tracked page mid-task:
|
|
176
176
|
|
|
177
177
|
```bash
|
|
178
|
-
|
|
178
|
+
npx tsx node_modules/@event4u/agent-config/src/scripts/emit_knowledge_event.ts --type api_shape_learned \
|
|
179
179
|
--endpoint "<path>" --method "<verb>" --request-schema '<json>' --response-schema '<json>'
|
|
180
180
|
|
|
181
|
-
|
|
181
|
+
npx tsx node_modules/@event4u/agent-config/src/scripts/emit_knowledge_event.ts --type convention_detected \
|
|
182
182
|
--pattern "<pattern>" --evidence "file:line" --sample-size <N> --scope project
|
|
183
183
|
```
|
|
184
184
|
|
|
@@ -111,6 +111,15 @@ Rules:
|
|
|
111
111
|
or `none`) so the gate's value is measurable inside the ADR-117
|
|
112
112
|
prove-or-drop window.
|
|
113
113
|
|
|
114
|
+
## Severity-conditioned team composition — conditions pattern
|
|
115
|
+
|
|
116
|
+
Incident-style severity tiers (Critical / High / Medium / Low) refine
|
|
117
|
+
composition and activation **within** the form the static gate already
|
|
118
|
+
picked — severity never overrides the form gate, the Iron Law, or any
|
|
119
|
+
safety floor. Guidance, not a new object class (persona-catalog
|
|
120
|
+
disposition). Severity→composition table + escalation rule →
|
|
121
|
+
[`subagent-modes-detail` § Severity-conditioned team composition](../../agent-src/contexts/execution/subagent-modes-detail.md).
|
|
122
|
+
|
|
114
123
|
## The nine modes
|
|
115
124
|
|
|
116
125
|
Each mode has a decision row: when to use, when not, and the expected
|
|
@@ -124,42 +133,23 @@ glossary) lives in
|
|
|
124
133
|
[`subagent-topologies`](../../agent-src/contexts/execution/subagent-topologies.md) —
|
|
125
134
|
pull it for capacity planning; it is metadata, not runtime-enforced.
|
|
126
135
|
|
|
136
|
+
Per-mode decision rows (when to use / when not / model pairing) and the
|
|
137
|
+
mode-2 stage-routing contract live in
|
|
138
|
+
[`subagent-modes-detail` § Modes 1–6](../../agent-src/contexts/execution/subagent-modes-detail.md) —
|
|
139
|
+
pull them at dispatch time.
|
|
140
|
+
|
|
127
141
|
### 1. do-and-judge
|
|
128
142
|
|
|
129
143
|
Implementer produces a diff; judge reviews; loop applies, revises, or
|
|
130
144
|
hands off. Hard ceiling: **two revision cycles**, then stop and hand
|
|
131
145
|
back to the user.
|
|
132
146
|
|
|
133
|
-
| When to use | When not | Model pairing |
|
|
134
|
-
|---|---|---|
|
|
135
|
-
| Single-change task with non-trivial risk | Tiny fix, or spike/exploration | implementer = session; judge = one tier up |
|
|
136
|
-
|
|
137
147
|
### 2. do-and-judge-two-stage
|
|
138
148
|
|
|
139
|
-
Implementer produces a diff; **two judges run sequentially** —
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
to stage two if stage one returns `DONE` or `DONE_WITH_CONCERNS`. A
|
|
144
|
-
stage-one `BLOCKED` shortcuts the loop — there is no point quality-
|
|
145
|
-
reviewing a diff that does not satisfy the spec.
|
|
146
|
-
|
|
147
|
-
| When to use | When not | Model pairing |
|
|
148
|
-
|---|---|---|
|
|
149
|
-
| Spec is contested or AC are detailed; diff size makes one judge prone to missing one axis (correctness vs craft) | Spec is one sentence, or the diff is one line (collapse to mode 1) | implementer = session; spec-judge = one tier up; quality-judge = same tier as spec-judge, fresh context |
|
|
150
|
-
|
|
151
|
-
**Why two stages, not one judge with both rubrics:** combining the
|
|
152
|
-
rubrics in one prompt reliably regresses one of them — the judge "spends
|
|
153
|
-
attention" on whichever rubric appears last. Splitting the prompts
|
|
154
|
-
forces each judge to commit fully to its rubric.
|
|
155
|
-
|
|
156
|
-
**Stage-routing rule:**
|
|
157
|
-
- Stage-1 returns `DONE` → run stage-2.
|
|
158
|
-
- Stage-1 returns `DONE_WITH_CONCERNS` → run stage-2; concerns carry
|
|
159
|
-
forward to the final envelope.
|
|
160
|
-
- Stage-1 returns `NEEDS_CONTEXT` → pause; stage-2 does not run.
|
|
161
|
-
- Stage-1 returns `BLOCKED` → final verdict is `BLOCKED`; stage-2
|
|
162
|
-
does not run (saves cost).
|
|
149
|
+
Implementer produces a diff; **two judges run sequentially** — spec
|
|
150
|
+
compliance first, code quality second. Stage-one `BLOCKED` shortcuts the
|
|
151
|
+
loop (no point quality-reviewing a diff that misses the spec). Stage
|
|
152
|
+
routing + why-two-stages rationale → modes-detail § Mode 2.
|
|
163
153
|
|
|
164
154
|
### 3. do-in-steps
|
|
165
155
|
|
|
@@ -167,40 +157,24 @@ Plan is split into N steps; judge runs **between** steps. A step that
|
|
|
167
157
|
fails judgment is revised before the next step starts. Used for
|
|
168
158
|
multi-file changes where a mid-plan mistake would cascade.
|
|
169
159
|
|
|
170
|
-
| When to use | When not | Model pairing |
|
|
171
|
-
|---|---|---|
|
|
172
|
-
| Multi-step plan with ordered dependencies | Single-step change, or when steps are independent (use `do-in-parallel`) | implementer = session; judge = one tier up |
|
|
173
|
-
|
|
174
160
|
### 4. do-in-parallel
|
|
175
161
|
|
|
176
162
|
Independent slices run concurrently. No judge per slice — judge runs
|
|
177
163
|
once on the aggregated result. Parallelism capped by
|
|
178
164
|
`subagents.max_parallel` in `.agent-settings.yml`.
|
|
179
165
|
|
|
180
|
-
| When to use | When not | Model pairing |
|
|
181
|
-
|---|---|---|
|
|
182
|
-
| Independent slices (different files, non-overlapping) | Any slice touches shared state | implementer = session; judge = one tier up, run once |
|
|
183
|
-
|
|
184
166
|
### 5. do-competitively
|
|
185
167
|
|
|
186
168
|
Multiple implementers produce candidate diffs for the **same** slice.
|
|
187
169
|
Judge picks the winner and rejects the losers. Expensive — use only
|
|
188
170
|
when the solution space is genuinely broad.
|
|
189
171
|
|
|
190
|
-
| When to use | When not | Model pairing |
|
|
191
|
-
|---|---|---|
|
|
192
|
-
| Broad solution space (algorithm choice, API shape) | Well-defined problem with one good answer | implementers = same tier (≥2 instances); judge = one tier up |
|
|
193
|
-
|
|
194
172
|
### 6. judge-with-debate
|
|
195
173
|
|
|
196
174
|
Two judges each produce a verdict; a meta-judge reconciles
|
|
197
175
|
disagreements. Used for high-stakes changes (security, data
|
|
198
176
|
migration, public API) where a single judge is too easy to fool.
|
|
199
177
|
|
|
200
|
-
| When to use | When not | Model pairing |
|
|
201
|
-
|---|---|---|
|
|
202
|
-
| Security, data integrity, public API change | Routine internal refactor | judges = same tier (2x); meta-judge = one tier up |
|
|
203
|
-
|
|
204
178
|
Mode 6 = **go/no-go** (strict-er verdict wins); for defect-FINDING coverage (the
|
|
205
179
|
*union* of what diverse models catch) use Mode 9.
|
|
206
180
|
|
|
@@ -238,34 +212,25 @@ opt-in high-risk changes only; registered claim + high-risk tier need
|
|
|
238
212
|
cross-*vendor* skeptics. Invariants, skeptic prompt, reconciliation, prove-or-drop
|
|
239
213
|
gate → [`subagent-modes-detail`](../../agent-src/contexts/execution/subagent-modes-detail.md) § Mode 9
|
|
240
214
|
+ [`prompts/adversarial-verification-council.md`](prompts/adversarial-verification-council.md)
|
|
215
|
+
|
|
216
|
+
> **Disposition (2026-07-28, honest null).** Adversarial-council
|
|
217
|
+
> finding-coverage benchmark resolved as published null (`docs/benchmark.md`)
|
|
218
|
+
> — mode NOT sold as defect-detection capability. Stays default-off bound to
|
|
219
|
+
> that null; removal at next major unless external evidence (consumer-filed
|
|
220
|
+
> case where the panel surfaced a real defect the single verifier missed)
|
|
221
|
+
> appears first. Remaining honest value: perspective diversity + decision
|
|
222
|
+
> documentation, nothing more.
|
|
241
223
|
(ADR-122).
|
|
242
224
|
|
|
243
225
|
## Status taxonomy — every subagent return uses one envelope
|
|
244
226
|
|
|
245
227
|
Every implementer or judge return must conform to
|
|
246
|
-
[`schemas/subagent-status.json`](schemas/subagent-status.json).
|
|
247
|
-
statuses
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
| `DONE_WITH_CONCERNS` | Work shipped but caller must act on concerns. | `evidence[]`, `concerns[]` |
|
|
253
|
-
| `NEEDS_CONTEXT` | Paused; caller can unblock by answering. | `blocking_question` |
|
|
254
|
-
| `BLOCKED` | No path forward exists. | `blocking_reason` |
|
|
255
|
-
|
|
256
|
-
**Why a fixed taxonomy:** orchestrators (`/do-and-judge`, `/do-in-steps`)
|
|
257
|
-
route on status. Free-form "kind of done" returns force the orchestrator
|
|
258
|
-
to interpret prose, which silently regresses the two-revision ceiling and
|
|
259
|
-
the judge-rejected-do-not-apply rule. The schema makes routing mechanical.
|
|
260
|
-
|
|
261
|
-
**Tests:** `tests/test_subagent_status_schema.py` exercises all four
|
|
262
|
-
statuses plus rejection cases (missing required keys, unknown status,
|
|
263
|
-
extra fields, conditional-key violations).
|
|
264
|
-
|
|
265
|
-
**Distinguishing `NEEDS_CONTEXT` from `BLOCKED`:** `NEEDS_CONTEXT` means
|
|
266
|
-
*"you, the caller, can fix this by telling me X"*. `BLOCKED` means
|
|
267
|
-
*"no input from you unblocks this — escalate or rescope"*. If a subagent
|
|
268
|
-
is unsure, it picks `BLOCKED` and the caller can downgrade.
|
|
228
|
+
[`schemas/subagent-status.json`](schemas/subagent-status.json). Exactly
|
|
229
|
+
four statuses — `DONE` · `DONE_WITH_CONCERNS` · `NEEDS_CONTEXT` ·
|
|
230
|
+
`BLOCKED` — no free-form alternatives; orchestrators route on status
|
|
231
|
+
mechanically. Meaning/required-keys table, why-fixed rationale, and the
|
|
232
|
+
`NEEDS_CONTEXT`-vs-`BLOCKED` distinction →
|
|
233
|
+
[`subagent-modes-detail` § Status taxonomy](../../agent-src/contexts/execution/subagent-modes-detail.md).
|
|
269
234
|
|
|
270
235
|
## Dispatch prompts — externalized
|
|
271
236
|
|
|
@@ -273,9 +238,12 @@ Each mode's literal dispatch template lives under
|
|
|
273
238
|
[`prompts/{mode}.md`](prompts/README.md). The orchestrator loads the
|
|
274
239
|
matching prompt at dispatch time and substitutes `{{placeholders}}`.
|
|
275
240
|
Edits to a prompt do not bloat this skill against the 400-line sunset
|
|
276
|
-
trigger
|
|
277
|
-
|
|
278
|
-
|
|
241
|
+
trigger. Eight prompt files cover modes 1–7 and 9 (the standalone judge
|
|
242
|
+
reuses [`prompts/do-and-judge.md`](prompts/do-and-judge.md); mode 8's
|
|
243
|
+
live-app rubric lives in
|
|
244
|
+
[`subagent-modes-detail` § Mode 8](../../agent-src/contexts/execution/subagent-modes-detail.md));
|
|
245
|
+
each prompt cites all four taxonomy statuses — see
|
|
246
|
+
[`prompts/README.md`](prompts/README.md).
|
|
279
247
|
|
|
280
248
|
## Procedure
|
|
281
249
|
|
|
@@ -339,21 +307,13 @@ the judge verdict.
|
|
|
339
307
|
|
|
340
308
|
### 6. Emit telemetry
|
|
341
309
|
|
|
342
|
-
After every auto-dispatched run, write one
|
|
343
|
-
`
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
Minimal emit (fill what is observable; `token_delta_provenance: "estimated"` if
|
|
350
|
-
host usage metadata is unavailable):
|
|
351
|
-
|
|
352
|
-
```json
|
|
353
|
-
{"schema_version":1,"id":"<ulid>","ts":"<iso>","work_id":"<work_id>","phase":"implement","outcome":"success","confidence_band":"high","risk_class":"low","input_kind":"orchestration","type":"phase","orchestration":{"task_size_estimate":<int>,"spawn_count":<int>,"tiers":[...],"token_delta":<int>,"token_delta_provenance":"estimated","wall_clock_ms":<int>,"outcome":"DONE","verify_mode":"deterministic"}}
|
|
354
|
-
```
|
|
355
|
-
|
|
356
|
-
Skip emit when `subagents.enabled: false` or `spawn_count == 0` (in-session run).
|
|
310
|
+
After every auto-dispatched run, write one audit-log-v1 line
|
|
311
|
+
(`input_kind: "orchestration"`) via the `orchestration_record` recorder —
|
|
312
|
+
never hand-author the JSON. Line shape, field semantics, recorder
|
|
313
|
+
invocation, and `token_delta` sourcing priority →
|
|
314
|
+
[`orchestration-telemetry` § Emit procedure](../../agent-src/contexts/execution/orchestration-telemetry.md).
|
|
315
|
+
Skip emit when `subagents.enabled: false` or `spawn_count == 0`
|
|
316
|
+
(in-session run).
|
|
357
317
|
|
|
358
318
|
## Gotcha
|
|
359
319
|
|
|
@@ -21,7 +21,7 @@ skill above the 400-line sunset trigger.
|
|
|
21
21
|
Every prompt cites the status taxonomy in
|
|
22
22
|
[`../schemas/subagent-status.json`](../schemas/subagent-status.json) and
|
|
23
23
|
ends with the **return-envelope** instruction so the subagent's reply
|
|
24
|
-
validates against
|
|
24
|
+
validates against that schema.
|
|
25
25
|
|
|
26
26
|
## Prompt-cache discipline
|
|
27
27
|
|
|
@@ -47,6 +47,7 @@ dispatch. Verify a cohort is actually reading, not re-writing, by checking
|
|
|
47
47
|
|
|
48
48
|
## Loading
|
|
49
49
|
|
|
50
|
-
`
|
|
51
|
-
|
|
52
|
-
|
|
50
|
+
Every dispatchable mode named in `SKILL.md` § *The nine modes* maps to a
|
|
51
|
+
prompt file in the table above (mode 8 is gated/experimental — its
|
|
52
|
+
live-app rubric lives in the `subagent-modes-detail` context, not here);
|
|
53
|
+
each prompt mentions all four status enum values.
|
|
@@ -275,7 +275,7 @@ knowledge intake — never rewrite the page mid-task (see
|
|
|
275
275
|
[`knowledge-pages`](../../templates/contexts/knowledge-pages.md)):
|
|
276
276
|
|
|
277
277
|
```bash
|
|
278
|
-
|
|
278
|
+
npx tsx node_modules/@event4u/agent-config/src/scripts/emit_knowledge_event.ts \
|
|
279
279
|
--type mistake_made \
|
|
280
280
|
--error-category "<one or two words>" \
|
|
281
281
|
--context-source "<agents/knowledge/... path, or 'null' if no page was followed>" \
|
|
@@ -292,7 +292,7 @@ right now (observed ≠ documented, not a one-off) → hybrid immediate-fix
|
|
|
292
292
|
case instead — surface the correction, ask before continuing (see
|
|
293
293
|
[`knowledge-pages`](../../templates/contexts/knowledge-pages.md) §
|
|
294
294
|
Contested entries). Approved → isolated fix commit. Declined →
|
|
295
|
-
|
|
295
|
+
`npx tsx node_modules/@event4u/agent-config/src/scripts/append_contested.ts` on that page, then still
|
|
296
296
|
emit the `context_stale` event above for the consolidation pass.
|
|
297
297
|
|
|
298
298
|
## Gotchas
|
|
@@ -134,9 +134,8 @@ Risks: <arbitrary values, !important, dark-mode gaps>
|
|
|
134
134
|
[`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md)
|
|
135
135
|
(C1 gradients, T7 fonts, L1/L2 layout, V1 side-stripe). Pull the catalog
|
|
136
136
|
for the full list; the objective subset (contrast, font-size floor,
|
|
137
|
-
reduced-motion) is
|
|
138
|
-
|
|
139
|
-
consumer projects.
|
|
137
|
+
reduced-motion) is validated via `accessibility-auditor`'s checklist —
|
|
138
|
+
cite its verdict rather than eyeballing.
|
|
140
139
|
- **Anti-AI-slop: gradients.** Unless audit-pinned or brief-explicit,
|
|
141
140
|
avoid the default purple-to-blue / cyan-to-pink gradients on white —
|
|
142
141
|
they read as auto-generated (catalog C1/C2). Reach for a single accent
|