@event4u/agent-config 7.5.0 → 8.1.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 +8 -1
- package/AGENTS.md +9 -9
- package/CHANGELOG.md +317 -260
- package/README.md +35 -5
- package/dist/agent-src/commands/analytics/prune.md +1 -1
- package/dist/agent-src/commands/analytics/show.md +1 -1
- package/dist/agent-src/commands/analyze/decision.md +2 -2
- package/dist/agent-src/commands/analyze/incident.md +2 -2
- package/dist/agent-src/commands/analyze/near-miss.md +2 -2
- package/dist/agent-src/commands/analyze/postmortem.md +2 -2
- package/dist/agent-src/commands/analyze/premortem.md +2 -2
- package/dist/agent-src/commands/cost-report.md +25 -0
- package/dist/agent-src/commands/evals/analyze.json +30 -0
- package/dist/agent-src/commands/evals/mission-upgrade.json +30 -0
- package/dist/agent-src/commands/implement-ticket.md +1 -1
- package/dist/agent-src/commands/knowledge/forget.md +1 -1
- package/dist/agent-src/commands/knowledge/ingest.md +1 -1
- package/dist/agent-src/commands/knowledge/list.md +1 -1
- package/dist/agent-src/commands/memory/load.md +12 -11
- package/dist/agent-src/commands/memory/promote.md +30 -0
- package/dist/agent-src/commands/memory/propose.md +16 -2
- package/dist/agent-src/commands/mission/upgrade.md +1 -1
- package/dist/agent-src/commands/module/explore.md +11 -7
- package/dist/agent-src/commands/optimize-project.md +243 -0
- package/dist/agent-src/commands/optimize.md +5 -0
- package/dist/agent-src/commands/pr/create.md +37 -8
- package/dist/agent-src/commands/prediction-pool.md +2 -2
- package/dist/agent-src/commands/profile/activate.md +3 -3
- package/dist/agent-src/commands/profile/deactivate.md +2 -2
- package/dist/agent-src/commands/profile/show.md +3 -3
- package/dist/agent-src/commands/research/deep.md +5 -0
- package/dist/agent-src/commands/research/report.md +2 -1
- package/dist/agent-src/commands/roadmap/create.md +88 -10
- package/dist/agent-src/commands/roadmap/materialize.md +1 -1
- package/dist/agent-src/commands/roadmap/process-full.md +15 -2
- package/dist/agent-src/commands/roadmap/process-phase.md +18 -6
- package/dist/agent-src/commands/roadmap/process-step.md +4 -0
- package/dist/agent-src/commands/roadmap.md +1 -1
- package/dist/agent-src/commands/security-audit-config.md +1 -1
- package/dist/agent-src/commands/sync-agent-settings.md +1 -1
- package/dist/agent-src/commands/sync-gitignore/fix.md +42 -6
- package/dist/agent-src/commands/team-knowledge/bootstrap.md +106 -0
- package/dist/agent-src/commands/team-knowledge/consolidate.md +105 -0
- package/dist/agent-src/commands/team-knowledge.md +64 -0
- package/dist/agent-src/contexts/authority/commit-mechanics.md +8 -0
- package/dist/agent-src/contexts/authority/destructive-mechanics.md +11 -0
- package/dist/agent-src/contexts/authority/scope-mechanics.md +25 -0
- package/dist/agent-src/contexts/communication/rules-auto/reply-close-mechanics.md +43 -0
- package/dist/agent-src/contexts/contracts/agents-md-anatomy.md +1 -1
- package/dist/agent-src/contexts/contracts/artifact-engagement-flow.md +2 -2
- package/dist/agent-src/contexts/contracts/frugality-charter.md +1 -0
- package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +14 -4
- package/dist/agent-src/contexts/execution/autonomy-mechanics.md +11 -0
- package/dist/agent-src/contexts/execution/orchestration-telemetry.md +32 -8
- package/dist/agent-src/contexts/execution/roadmap-execution-contract.md +107 -0
- package/dist/agent-src/contexts/execution/roadmap-process-loop.md +71 -15
- package/dist/agent-src/contexts/execution/subagent-steering.md +41 -1
- package/dist/agent-src/contexts/override-system.md +1 -1
- package/dist/agent-src/personas/brand-strategist.md +0 -1
- package/dist/agent-src/personas/data-integrity.md +66 -0
- package/dist/agent-src/personas/design-director.md +0 -1
- package/dist/agent-src/personas/performance-engineer.md +66 -0
- package/dist/agent-src/personas/production-validator.md +73 -0
- package/dist/agent-src/rules/agent-authority.md +3 -4
- package/dist/agent-src/rules/analysis-skill-routing.md +3 -5
- package/dist/agent-src/rules/architecture.md +2 -4
- package/dist/agent-src/rules/artifact-drafting-protocol.md +35 -6
- package/dist/agent-src/rules/artifact-engagement-recording.md +2 -4
- package/dist/agent-src/rules/ask-when-uncertain.md +10 -14
- package/dist/agent-src/rules/augment-edit-discipline.md +3 -5
- package/dist/agent-src/rules/autonomous-execution.md +3 -5
- package/dist/agent-src/rules/brand-consistency.md +3 -5
- package/dist/agent-src/rules/brand-source-of-truth.md +3 -5
- package/dist/agent-src/rules/cli-output-handling.md +4 -6
- package/dist/agent-src/rules/command-suggestion-policy.md +3 -5
- package/dist/agent-src/rules/commit-conventions.md +3 -5
- package/dist/agent-src/rules/commit-policy.md +18 -10
- package/dist/agent-src/rules/content-quoting-floor.md +88 -0
- package/dist/agent-src/rules/context-hygiene.md +3 -5
- package/dist/agent-src/rules/copilot-routing.md +4 -6
- package/dist/agent-src/rules/decision-revisit-gate.md +120 -0
- package/dist/agent-src/rules/delegation-policy.md +10 -6
- package/dist/agent-src/rules/design-fidelity.md +3 -5
- package/dist/agent-src/rules/devcontainer-routing.md +4 -6
- package/dist/agent-src/rules/direct-answers.md +13 -17
- package/dist/agent-src/rules/docker-commands.md +3 -5
- package/dist/agent-src/rules/domain-adoption-policy.md +3 -5
- package/dist/agent-src/rules/domain-safety-disclaimer.md +3 -5
- package/dist/agent-src/rules/domain-safety-pii.md +3 -5
- package/dist/agent-src/rules/domain-safety-retention.md +3 -5
- package/dist/agent-src/rules/downstream-changes.md +3 -4
- package/dist/agent-src/rules/engineering-safety-floor.md +3 -5
- package/dist/agent-src/rules/external-reference-deep-dive.md +3 -5
- package/dist/agent-src/rules/fast-path-marker-visibility.md +3 -5
- package/dist/agent-src/rules/finance-safety-floor.md +3 -6
- package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +3 -5
- package/dist/agent-src/rules/git-history-discipline.md +3 -5
- package/dist/agent-src/rules/guidelines.md +2 -4
- package/dist/agent-src/rules/icon-consistency.md +3 -5
- package/dist/agent-src/rules/image-likeness-and-rights.md +3 -5
- package/dist/agent-src/rules/improve-before-implement.md +5 -5
- package/dist/agent-src/rules/invite-challenge.md +3 -5
- package/dist/agent-src/rules/language-and-tone.md +13 -15
- package/dist/agent-src/rules/laravel-routing.md +3 -5
- package/dist/agent-src/rules/laravel-translations.md +3 -5
- package/dist/agent-src/rules/legal-safety-floor.md +3 -5
- package/dist/agent-src/rules/lethal-trifecta-guard.md +3 -5
- package/dist/agent-src/rules/linked-projects-onboarding-gate.md +4 -7
- package/dist/agent-src/rules/low-impact-corpus-privacy-floor.md +3 -5
- package/dist/agent-src/rules/markdown-safe-codeblocks.md +2 -4
- package/dist/agent-src/rules/media-governance-routing.md +3 -5
- package/dist/agent-src/rules/media-sync-ground-truth.md +3 -5
- package/dist/agent-src/rules/minimal-safe-diff.md +5 -5
- package/dist/agent-src/rules/missing-tool-handling.md +3 -5
- package/dist/agent-src/rules/model-recommendation.md +4 -6
- package/dist/agent-src/rules/no-attribution-footers.md +3 -5
- package/dist/agent-src/rules/no-cheap-questions.md +5 -8
- package/dist/agent-src/rules/no-decorative-emojis-in-git-surfaces.md +3 -6
- package/dist/agent-src/rules/no-pr-progress-comments.md +3 -6
- package/dist/agent-src/rules/no-roadmap-references.md +3 -5
- package/dist/agent-src/rules/non-destructive-by-default.md +11 -13
- package/dist/agent-src/rules/notes-first-reasoning.md +3 -5
- package/dist/agent-src/rules/onboarding-gate.md +4 -6
- package/dist/agent-src/rules/output-discipline.md +3 -5
- package/dist/agent-src/rules/package-ci-checks.md +3 -5
- package/dist/agent-src/rules/persona-governance.md +2 -4
- package/dist/agent-src/rules/php-coding.md +3 -5
- package/dist/agent-src/rules/preservation-guard.md +2 -4
- package/dist/agent-src/rules/provider-lifecycle-discipline.md +3 -5
- package/dist/agent-src/rules/reviewer-awareness.md +5 -6
- package/dist/agent-src/rules/roadmap-ci-steps-policy.md +3 -5
- package/dist/agent-src/rules/roadmap-progress-sync.md +5 -5
- package/dist/agent-src/rules/role-mode-adherence.md +2 -4
- package/dist/agent-src/rules/rule-type-governance.md +3 -5
- package/dist/agent-src/rules/runtime-safety.md +2 -4
- package/dist/agent-src/rules/scope-control.md +10 -11
- package/dist/agent-src/rules/security-sensitive-stop.md +4 -5
- package/dist/agent-src/rules/size-enforcement.md +2 -4
- package/dist/agent-src/rules/skill-improvement-trigger.md +3 -5
- package/dist/agent-src/rules/skill-quality.md +3 -5
- package/dist/agent-src/rules/slash-command-routing-policy.md +3 -5
- package/dist/agent-src/rules/source-confidentiality.md +3 -5
- package/dist/agent-src/rules/source-discovery-gate.md +3 -5
- package/dist/agent-src/rules/source-of-truth.md +3 -5
- package/dist/agent-src/rules/strategy-safety-floor.md +3 -5
- package/dist/agent-src/rules/symfony-routing.md +4 -6
- package/dist/agent-src/rules/telegraph-speak.md +4 -5
- package/dist/agent-src/rules/think-before-action.md +7 -4
- package/dist/agent-src/rules/token-budget-discipline.md +29 -5
- package/dist/agent-src/rules/token-efficiency.md +3 -5
- package/dist/agent-src/rules/token-optimizer-maintenance.md +3 -5
- package/dist/agent-src/rules/tool-safety.md +2 -4
- package/dist/agent-src/rules/ui-audit-gate.md +3 -6
- package/dist/agent-src/rules/untrusted-input-defense.md +3 -5
- package/dist/agent-src/rules/upstream-proposal.md +4 -6
- package/dist/agent-src/rules/user-interaction.md +7 -5
- package/dist/agent-src/rules/user-interrupt-priority.md +17 -8
- package/dist/agent-src/rules/verify-before-complete.md +12 -22
- package/dist/agent-src/scripts/archive_completed_roadmaps.ts +3 -3
- package/dist/agent-src/scripts/update_roadmap_progress.ts +197 -7
- package/dist/agent-src/skills/adr-create/SKILL.md +48 -42
- package/dist/agent-src/skills/agent-docs-writing/SKILL.md +18 -0
- package/dist/agent-src/skills/agent-security-review/SKILL.md +1 -1
- package/dist/agent-src/skills/ai-council/SKILL.md +14 -1
- package/dist/agent-src/skills/blameless-post-mortem/SKILL.md +0 -3
- package/dist/agent-src/skills/brand/SKILL.md +1 -1
- package/dist/agent-src/skills/brand-identity/SKILL.md +3 -3
- package/dist/agent-src/skills/brand-strategy/SKILL.md +1 -1
- package/dist/agent-src/skills/brand-to-tokens/SKILL.md +3 -3
- package/dist/agent-src/skills/canvas-design/SKILL.md +6 -0
- package/dist/agent-src/skills/check-refs/SKILL.md +7 -4
- package/dist/agent-src/skills/code-review/SKILL.md +1 -0
- package/dist/agent-src/skills/complexity-first-planning/SKILL.md +6 -5
- package/dist/agent-src/skills/condense-memory/SKILL.md +11 -11
- package/dist/agent-src/skills/context-document/SKILL.md +17 -0
- package/dist/agent-src/skills/corpus-grounding/SKILL.md +3 -3
- package/dist/agent-src/skills/decision-record/SKILL.md +6 -0
- package/dist/agent-src/skills/decision-review/SKILL.md +5 -3
- package/dist/agent-src/skills/deep-reading-analyst/SKILL.md +6 -1
- package/dist/agent-src/skills/design-intelligence/SKILL.md +5 -2
- package/dist/agent-src/skills/design-intelligence/references/design-languages.md +1 -1
- package/dist/agent-src/skills/design-tokens/SKILL.md +10 -4
- package/dist/agent-src/skills/design-variations/SKILL.md +127 -0
- package/dist/agent-src/skills/design-variations/evals/triggers.json +17 -0
- package/dist/agent-src/skills/emit-tickets/SKILL.md +4 -4
- package/dist/agent-src/skills/fe-design/SKILL.md +20 -0
- package/dist/agent-src/skills/html-deck/SKILL.md +123 -0
- package/dist/agent-src/skills/html-deck/evals/triggers.json +17 -0
- package/dist/agent-src/skills/html-deck/templates/deck-shell.html +77 -0
- package/dist/agent-src/skills/judge-code-quality/SKILL.md +1 -0
- package/dist/agent-src/skills/laravel/SKILL.md +0 -1
- package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md +46 -0
- package/dist/agent-src/skills/lint-skills/SKILL.md +6 -6
- package/dist/agent-src/skills/md-language-check/SKILL.md +3 -3
- package/dist/agent-src/skills/memory-consolidation/SKILL.md +66 -1
- package/dist/agent-src/skills/migration-architect/SKILL.md +1 -0
- package/dist/agent-src/skills/module-detect-on-the-fly/SKILL.md +2 -2
- package/dist/agent-src/skills/performance-analysis/SKILL.md +2 -0
- package/dist/agent-src/skills/prediction-pool-optimizer/SKILL.md +4 -4
- package/dist/agent-src/skills/premortem/SKILL.md +0 -3
- package/dist/agent-src/skills/project-analysis-core/SKILL.md +16 -0
- package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +3 -1
- package/dist/agent-src/skills/release-comms/SKILL.md +46 -45
- package/dist/agent-src/skills/roadmap-management/SKILL.md +21 -0
- package/dist/agent-src/skills/roadmap-writing/SKILL.md +32 -2
- package/dist/agent-src/skills/root-cause-frameworks/SKILL.md +0 -3
- package/dist/agent-src/skills/security-audit/SKILL.md +1 -0
- package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +4 -0
- package/dist/agent-src/skills/source-discovery/SKILL.md +22 -3
- package/dist/agent-src/skills/subagent-orchestration/SKILL.md +33 -14
- package/dist/agent-src/skills/subagent-orchestration/prompts/README.md +11 -0
- package/dist/agent-src/skills/subagent-orchestration/prompts/do-in-steps.md +8 -0
- package/dist/agent-src/skills/systematic-debugging/SKILL.md +29 -0
- package/dist/agent-src/skills/threat-modeling/SKILL.md +2 -2
- package/dist/agent-src/skills/typography-system/SKILL.md +2 -2
- package/dist/agent-src/skills/verify-completion-evidence/SKILL.md +2 -0
- package/dist/agent-src/skills/wireframe/SKILL.md +118 -0
- package/dist/agent-src/skills/wireframe/evals/triggers.json +17 -0
- package/dist/agent-src/templates/agent-settings.md +22 -1
- package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
- package/dist/agent-src/templates/command.md +2 -2
- package/dist/agent-src/templates/contexts/knowledge-pages.md +116 -0
- package/dist/agent-src/templates/hooks/pre-commit-frontmatter +1 -1
- package/dist/agent-src/templates/roadmaps.md +70 -2
- package/dist/agent-src/templates/rule.md +1 -1
- package/dist/agent-src/templates/scripts/README.md +3 -3
- package/dist/agent-src/templates/scripts/work_engine/_lib/agent_settings.ts +109 -0
- package/dist/agent-src/templates/tickets.md +8 -8
- package/dist/cli/commands/recordTriggerEval.test.js +1 -1
- package/dist/cli/commands/recordTriggerEval.test.js.map +1 -1
- package/dist/cli/initRouting.js +4 -2
- package/dist/cli/initRouting.js.map +1 -1
- package/dist/cli/registry.js +1 -0
- package/dist/cli/registry.js.map +1 -1
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +718 -240
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +8 -8
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +43 -28
- package/dist/discovery/trust-report.md +12 -11
- package/dist/discovery/workspaces.json +29 -18
- package/dist/install/preflight.js +173 -0
- package/dist/install/preflight.js.map +1 -0
- package/dist/mcp/registry-manifest.json +4 -4
- package/dist/router.json +1 -1
- package/dist/server/routes/settings.js +4 -0
- package/dist/server/routes/settings.js.map +1 -1
- package/dist/server/schemas/settings.js +3 -1
- package/dist/server/schemas/settings.js.map +1 -1
- package/docs/CLAIMS.md +108 -0
- package/docs/MIGRATION.md +3 -3
- package/docs/architecture.md +5 -5
- package/docs/archive/CHANGELOG-pre-8.0.0.md +301 -0
- package/docs/benchmark.md +133 -2
- package/docs/benchmark.pinned.yml +31 -0
- package/docs/capability-matrix.md +1 -0
- package/docs/catalog.md +70 -60
- package/docs/command-flows.md +15 -3
- package/docs/comparison.yaml +35 -0
- package/docs/contracts/agents-layout.md +148 -0
- package/docs/contracts/brand-token-consumption.md +5 -0
- package/docs/contracts/capability-boundary.md +5 -0
- package/docs/contracts/command-category-governance.md +5 -0
- package/docs/contracts/command-clusters.md +1 -0
- package/docs/contracts/command-surface-tiers.md +1 -1
- package/docs/contracts/conformance.md +84 -0
- package/docs/contracts/creative-pack-boundary.md +5 -0
- package/docs/contracts/discovery-manifest.schema.json +5 -4
- package/docs/contracts/file-ownership-matrix.json +4605 -985
- package/docs/contracts/governance-enforcement-projection.md +5 -0
- package/docs/contracts/gui-wizard.md +1 -1
- package/docs/contracts/hook-architecture-v1.md +2 -2
- package/docs/contracts/implement-ticket-flow.md +1 -1
- package/docs/contracts/kernel-membership.md +13 -0
- package/docs/contracts/mcp-tool-inventory.md +23 -23
- package/docs/contracts/no-runtime-boundary.md +6 -1
- package/docs/contracts/review-lens-schema.md +5 -0
- package/docs/contracts/rule-router.md +102 -8
- package/docs/contracts/skill-bundled-assets.md +1 -1
- package/docs/contracts/skill-dry-run.md +1 -1
- package/docs/contracts/subagent-boundary.md +5 -0
- package/docs/contracts/ticket-bundle-format.md +9 -4
- package/docs/contracts/tier-3-contrib-plugin.md +2 -2
- package/docs/contracts/write-engine.md +3 -0
- package/docs/customization.md +87 -15
- package/docs/decisions/ADR-107-legal-domain-pack-adoption.md +1 -1
- package/docs/decisions/ADR-109-subagent-v1-contract.md +246 -0
- package/docs/decisions/ADR-110-discipline-profile-resolution-locus.md +105 -0
- package/docs/decisions/INDEX.md +2 -0
- package/docs/distribution/awesome-list-submission.md +46 -0
- package/docs/distribution/launch-story-draft.md +58 -0
- package/docs/end-to-end-walkthroughs.md +2 -2
- package/docs/getting-started.md +2 -2
- package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +24 -0
- package/docs/guidelines/agent-infra/corpus-grounding-authoring.md +1 -1
- package/docs/guidelines/agent-infra/linked-projects-onboarding-gate.md +2 -2
- package/docs/guidelines/agent-infra/missing-tool-handling.md +3 -3
- package/docs/guidelines/agent-infra/verify-before-complete-demos.md +2 -2
- package/docs/guidelines/augment-portability-patterns.md +1 -1
- package/docs/guidelines/code-clarity.md +19 -0
- package/docs/guidelines/design-antipatterns-triggers.json +2 -1
- package/docs/guidelines/design-antipatterns.md +10 -1
- package/docs/guidelines/design-modes.md +6 -0
- package/docs/guidelines/php/general.md +9 -1
- package/docs/guidelines/php/php-coding-patterns.md +7 -0
- package/docs/guides/cross-repo-retrieval.md +1 -1
- package/docs/guides/frontend-design-corpus-refresh.md +2 -2
- package/docs/guides/local-analytics.md +4 -4
- package/docs/guides/skill-discovery.md +1 -1
- package/docs/guides/skill-preview.md +1 -1
- package/docs/hook-payload-capture.md +6 -6
- package/docs/install-friction-report.md +66 -0
- package/docs/installation.md +1 -1
- package/docs/maintainers/optional-media-deps.md +50 -0
- package/docs/mcp-server.md +11 -12
- package/docs/media/proof-demo.cast +14 -0
- package/docs/media/proof-demo.gif +0 -0
- package/docs/migration/consumer-template-consumption-model.md +1 -1
- package/docs/migration/divergences/bench-stats-float-precision.md +1 -1
- package/docs/migration/node-floor.md +1 -1
- package/docs/migration/yaml-roundtrip-spike.md +1 -1
- package/docs/personas.md +16 -5
- package/docs/positioning-evidence.md +86 -0
- package/docs/proof.md +86 -0
- package/docs/skills-catalog.md +1 -1
- package/docs/troubleshooting.md +8 -8
- package/docs/wedge/production-validator/README.md +57 -0
- package/docs/wedge/production-validator/production-validator.md +56 -0
- package/docs/wizard.md +2 -2
- package/package.json +1 -1
- package/src/config/agent-settings.template.yml +59 -4
- package/src/config/agents-paths.yml +254 -0
- package/src/config/budgets.yml +16 -0
- package/src/config/discovery/packs.yml +1 -0
- package/src/config/discovery/unassigned-artefacts.yml +2 -0
- package/src/config/gitignore-block.txt +25 -0
- package/src/config/host-capabilities.yml +31 -0
- package/src/config/profiles/balanced.ini +4 -0
- package/src/config/profiles/full.ini +4 -0
- package/src/config/profiles/minimal.ini +4 -0
- package/src/scripts/_cli/cmd_conformance.ts +716 -0
- package/src/scripts/_cli/cmd_doctor.ts +23 -2
- package/src/scripts/_cli/cmd_fleet.ts +401 -0
- package/src/scripts/_cli/cmd_preflight.ts +159 -0
- package/src/scripts/_dispatch.bash +10 -0
- package/src/scripts/_lib/knowledge_events.ts +193 -0
- package/src/scripts/_lib/subagent_steering.ts +115 -3
- package/src/scripts/_lib/text_similarity.ts +75 -0
- package/src/scripts/ai-video/test-pipeline.sh +1 -1
- package/src/scripts/ai_council/clients.ts +19 -3
- package/src/scripts/append_contested.ts +112 -0
- package/src/scripts/audit_auto_rules.ts +11 -1
- package/src/scripts/audit_mcp_tools.ts +25 -11
- package/src/scripts/bench_ab_v2_run.ts +527 -40
- package/src/scripts/bench_ab_v2_stats.ts +6 -0
- package/src/scripts/bench_matrix.ts +266 -0
- package/src/scripts/bootstrap_knowledge.ts +267 -0
- package/src/scripts/build_discovery_manifest.ts +42 -2
- package/src/scripts/build_proof.ts +214 -0
- package/src/scripts/check_always_budget.ts +3 -0
- package/src/scripts/check_augment_description_cap.ts +2 -2
- package/src/scripts/check_claims.ts +270 -0
- package/src/scripts/check_comparison.ts +79 -0
- package/src/scripts/check_generated_artefact_headers.ts +109 -0
- package/src/scripts/check_generator_output_coverage.ts +142 -0
- package/src/scripts/check_gitignore_freshness.ts +127 -0
- package/src/scripts/check_knowledge_pages.ts +210 -0
- package/src/scripts/check_knowledge_sharing.ts +162 -0
- package/src/scripts/check_media_deps.ts +91 -0
- package/src/scripts/check_memory_contradiction.ts +280 -0
- package/src/scripts/check_memory_similarity.ts +134 -0
- package/src/scripts/check_quality_regression.ts +56 -10
- package/src/scripts/check_references.ts +3 -1
- package/src/scripts/check_release_pr_shape.ts +4 -0
- package/src/scripts/check_site_links.ts +135 -0
- package/src/scripts/check_skill_gaps.ts +99 -0
- package/src/scripts/check_token_quality_golden.ts +197 -11
- package/src/scripts/check_tracked_but_ignored.ts +67 -0
- package/src/scripts/cluster_near_miss_patterns.ts +0 -0
- package/src/scripts/compile_router.ts +30 -3
- package/src/scripts/condense.ts +350 -14
- package/src/scripts/consolidate_knowledge_events.ts +192 -0
- package/src/scripts/degrade_to_pointer.ts +136 -0
- package/src/scripts/design_slop_rules.test.ts +15 -0
- package/src/scripts/design_slop_rules.ts +28 -0
- package/src/scripts/emit_knowledge_event.ts +158 -0
- package/src/scripts/export_replay_corpus.ts +187 -0
- package/src/scripts/external_sources_denylist.json +7 -2
- package/src/scripts/fold_intake.ts +281 -0
- package/src/scripts/generate_capability_matrix.ts +9 -1
- package/src/scripts/generate_knowledge_index.ts +222 -0
- package/src/scripts/hook_manifest.yaml +26 -14
- package/src/scripts/hooks/dispatch_hook.ts +18 -0
- package/src/scripts/hot_context_hook.ts +372 -0
- package/src/scripts/install +47 -0
- package/src/scripts/install-hooks.sh +17 -0
- package/src/scripts/inventory_meta_layers.ts +11 -0
- package/src/scripts/janitor.ts +258 -0
- package/src/scripts/lint_agents_layout.ts +74 -15
- package/src/scripts/lint_bench_ab.ts +4 -1
- package/src/scripts/lint_featured_skills.ts +0 -0
- package/src/scripts/lint_framework_leakage_allowlist.json +26 -3
- package/src/scripts/lint_knowledge_scale.ts +250 -0
- package/src/scripts/lint_legal_pack.ts +67 -0
- package/src/scripts/lint_persona_governance.ts +8 -3
- package/src/scripts/lint_regression.ts +15 -0
- package/src/scripts/lint_roadmap_blockers.ts +202 -0
- package/src/scripts/lint_roadmap_complexity.ts +81 -2
- package/src/scripts/lint_subagent_determinism.ts +125 -0
- package/src/scripts/measure_augment_budget.ts +46 -6
- package/src/scripts/measure_patterns.ts +4 -3
- package/src/scripts/measure_skill_reduction.ts +6 -6
- package/src/scripts/migration_status.ts +6 -2
- package/src/scripts/mine_missing_guardrails.ts +189 -0
- package/src/scripts/parity/phase_gate.ts +1 -1
- package/src/scripts/parity/replay.ts +21 -0
- package/src/scripts/project_thin_rules.ts +120 -16
- package/src/scripts/release.ts +39 -1
- package/src/scripts/render_benchmark_composite.ts +378 -0
- package/src/scripts/roadmap_progress_hook.ts +101 -43
- package/src/scripts/schemas/skill.schema.json +27 -0
- package/src/scripts/schemas/subagent.schema.json +106 -0
- package/src/scripts/skill_linter.ts +1 -0
- package/src/scripts/smoke/kernel.sh +5 -4
- package/src/scripts/surface-tiers.yml +1 -0
- package/src/scripts/sync_gitignore.ts +4 -0
- package/src/scripts/update_skill_candidates.ts +172 -0
- package/src/scripts/validate_frontmatter.ts +1 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Legal-pack output (contract/NDA/DPA review, triage) — never a final legal call;
|
|
4
|
+
description: "Legal-pack output (contract/NDA/DPA review, triage) — never a final legal call; attorney-review line; EU/DE-only"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "NDA"
|
|
7
7
|
- keyword: "DPA"
|
|
@@ -23,10 +23,8 @@ routes_to:
|
|
|
23
23
|
- "skill:nda-triage"
|
|
24
24
|
- "skill:dpa-review"
|
|
25
25
|
- "skill:legal-intake-triage"
|
|
26
|
-
workspaces:
|
|
27
|
-
|
|
28
|
-
packs:
|
|
29
|
-
- legal-review-prep
|
|
26
|
+
workspaces: [legal-review-prep]
|
|
27
|
+
packs: [legal-review-prep]
|
|
30
28
|
trust:
|
|
31
29
|
level: advisory
|
|
32
30
|
human_review_required: true
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
description: "
|
|
5
|
+
description: "Skill/command/tool mixing private-data access + untrusted content + external comms — break one leg before shipping"
|
|
6
6
|
triggers:
|
|
7
7
|
- path_prefix: "src/skills/"
|
|
8
8
|
- path_prefix: "src/agent-src/commands/"
|
|
@@ -12,10 +12,8 @@ triggers:
|
|
|
12
12
|
- keyword: "data exfil"
|
|
13
13
|
- phrase: "fetch and send"
|
|
14
14
|
- phrase: "read the file and post"
|
|
15
|
-
workspaces:
|
|
16
|
-
|
|
17
|
-
packs:
|
|
18
|
-
- engineering-base
|
|
15
|
+
workspaces: [engineering]
|
|
16
|
+
packs: [engineering-base]
|
|
19
17
|
---
|
|
20
18
|
|
|
21
19
|
# Lethal-Trifecta Guard
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2b"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
description: "IDE-attached sibling repo detected — prompt once to opt
|
|
5
|
+
description: "IDE-attached sibling repo detected — prompt once to opt into cross-repo awareness, persist local-only"
|
|
6
6
|
triggers:
|
|
7
7
|
- intent: "work across two projects"
|
|
8
8
|
- intent: "sibling repository"
|
|
@@ -17,11 +17,8 @@ validator_ignore:
|
|
|
17
17
|
reason: "Rule names the detector module as the runtime detection entrypoint."
|
|
18
18
|
routes_to:
|
|
19
19
|
- "guideline:agent-infra/linked-projects-onboarding-gate"
|
|
20
|
-
workspaces:
|
|
21
|
-
|
|
22
|
-
- engineering
|
|
23
|
-
packs:
|
|
24
|
-
- engineering-base
|
|
20
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
21
|
+
packs: [engineering-base]
|
|
25
22
|
lifecycle: experimental
|
|
26
23
|
trust:
|
|
27
24
|
level: experimental
|
|
@@ -35,4 +32,4 @@ install:
|
|
|
35
32
|
**Iron Law.** When the IDE has attached a sibling repository to this project and the sibling is not yet recorded in `linked_projects`, prompt the developer **once** to opt it into scope, persist the choice local-only, and thereafter proactively flag cross-repo impact — never bulk-include the sibling's files.
|
|
36
33
|
|
|
37
34
|
Body migrated to `guideline:agent-infra/linked-projects-onboarding-gate` (per the P4 pattern of `road-to-kernel-and-router.md`) — detection command, opt-in flow, persistence shape, behavioral directive, kill-switch. See also the cross-repo guide (`docs/guides/cross-repo-linked-projects.md`) and ADR-032.
|
|
38
|
-
Trigger-set above activates this routing
|
|
35
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -1,16 +1,14 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "1"
|
|
4
|
-
description: "Writing/
|
|
4
|
+
description: "Writing/upstreaming low-impact-decisions corpus entries — non-bypassable privacy floor"
|
|
5
5
|
triggers:
|
|
6
6
|
- path_prefix: "agents/decisions/low-impact-decisions"
|
|
7
7
|
- keyword: "low-impact-decisions"
|
|
8
8
|
- keyword: "low-impact corpus"
|
|
9
9
|
- keyword: "learn-low-impact"
|
|
10
|
-
workspaces:
|
|
11
|
-
|
|
12
|
-
packs:
|
|
13
|
-
- meta
|
|
10
|
+
workspaces: [agent-config-maintainer]
|
|
11
|
+
packs: [meta]
|
|
14
12
|
---
|
|
15
13
|
|
|
16
14
|
# Low-Impact Corpus — Privacy Floor
|
|
@@ -7,10 +7,8 @@ triggers:
|
|
|
7
7
|
- intent: "markdown with code blocks"
|
|
8
8
|
- keyword: "triple backticks"
|
|
9
9
|
- file_pattern: "*.md"
|
|
10
|
-
workspaces:
|
|
11
|
-
|
|
12
|
-
packs:
|
|
13
|
-
- meta
|
|
10
|
+
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
11
|
+
packs: [meta]
|
|
14
12
|
---
|
|
15
13
|
|
|
16
14
|
# Markdown Safe Codeblocks
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Generating AI video/image/voice — surface project-local media policies (likeness, style,
|
|
4
|
+
description: "Generating AI video/image/voice — surface the project-local media policies (likeness, style, voice-cloning, disclosure)"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "/video:"
|
|
7
7
|
- keyword: "/image:"
|
|
@@ -26,10 +26,8 @@ validator_ignore:
|
|
|
26
26
|
- type: "substring"
|
|
27
27
|
pattern: ".agent-src.uncondensed/"
|
|
28
28
|
reason: "Rule contrasts project-local placement with the .agent-src.uncondensed/rules/ alternative — mentioning the path is the argument."
|
|
29
|
-
workspaces:
|
|
30
|
-
|
|
31
|
-
packs:
|
|
32
|
-
- meta
|
|
29
|
+
workspaces: [agent-config-maintainer, engineering, gtm]
|
|
30
|
+
packs: [ai-image, ai-video]
|
|
33
31
|
---
|
|
34
32
|
|
|
35
33
|
# Media Governance Routing
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Audio-synced video
|
|
4
|
+
description: "Audio-synced video — timing + singer come from the transcribed real audio; sign-off before paid renders"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "lip-sync"
|
|
7
7
|
- keyword: "lip sync"
|
|
@@ -14,10 +14,8 @@ triggers:
|
|
|
14
14
|
- phrase: "sing the"
|
|
15
15
|
- phrase: "mit den lippen"
|
|
16
16
|
- phrase: "lippen passend"
|
|
17
|
-
workspaces:
|
|
18
|
-
|
|
19
|
-
packs:
|
|
20
|
-
- meta
|
|
17
|
+
workspaces: [agent-config-maintainer, engineering, gtm]
|
|
18
|
+
packs: [ai-video]
|
|
21
19
|
---
|
|
22
20
|
|
|
23
21
|
# Media Sync — Ground Truth Is the Audio
|
|
@@ -2,15 +2,15 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
description: "Writing or reviewing a diff — smallest change that solves the problem; no drive-by edits
|
|
5
|
+
description: "Writing or reviewing a diff — smallest change that solves the problem; no drive-by edits or reformatting"
|
|
6
6
|
triggers:
|
|
7
7
|
- intent: "writing a diff"
|
|
8
8
|
- intent: "reviewing a diff"
|
|
9
9
|
- keyword: "drive-by"
|
|
10
|
-
|
|
11
|
-
-
|
|
12
|
-
|
|
13
|
-
|
|
10
|
+
- keyword: "rewrite"
|
|
11
|
+
- keyword: "fix"
|
|
12
|
+
workspaces: [engineering]
|
|
13
|
+
packs: [engineering-base]
|
|
14
14
|
---
|
|
15
15
|
|
|
16
16
|
# Minimal Safe Diff
|
|
@@ -8,10 +8,8 @@ triggers:
|
|
|
8
8
|
- intent: "install tool"
|
|
9
9
|
routes_to:
|
|
10
10
|
- "guideline:agent-infra/missing-tool-handling"
|
|
11
|
-
workspaces:
|
|
12
|
-
|
|
13
|
-
packs:
|
|
14
|
-
- meta
|
|
11
|
+
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
12
|
+
packs: [meta]
|
|
15
13
|
---
|
|
16
14
|
|
|
17
15
|
# Missing Tool Handling
|
|
@@ -19,4 +17,4 @@ packs:
|
|
|
19
17
|
**Iron Law.** A CLI tool the task genuinely needs is not installed (`command not found`, `which X` empty) → STOP and ask with numbered options; never install silently, never silently substitute a brittle workaround.
|
|
20
18
|
|
|
21
19
|
Body migrated to `guideline:agent-infra/missing-tool-handling` (per the P4 pattern of `road-to-kernel-and-router.md`).
|
|
22
|
-
Trigger-set above activates this routing
|
|
20
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "
|
|
4
|
+
description: "Task start, type switch, or skill/command with a model_tier — switch or suggest the right capability tier"
|
|
5
5
|
triggers:
|
|
6
6
|
- phrase: "switch task"
|
|
7
7
|
- phrase: "new task"
|
|
@@ -11,10 +11,8 @@ load_context:
|
|
|
11
11
|
- ../contexts/model-recommendations.md
|
|
12
12
|
routes_to:
|
|
13
13
|
- "guideline:agent-infra/model-recommendation"
|
|
14
|
-
workspaces:
|
|
15
|
-
|
|
16
|
-
packs:
|
|
17
|
-
- meta
|
|
14
|
+
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
15
|
+
packs: [meta]
|
|
18
16
|
---
|
|
19
17
|
|
|
20
18
|
# Model Recommendation
|
|
@@ -22,4 +20,4 @@ packs:
|
|
|
22
20
|
**Iron Law.** When a skill or command carries a `model_tier` (a vendor-neutral capability band), route the turn to **that agent's best model in that band** — automatically where the surface supports a per-turn override, as a single suggestion where it does not. Never recommend another vendor's model. Never double-ask, never front-load the question.
|
|
23
21
|
|
|
24
22
|
Body migrated to `guideline:agent-infra/model-recommendation` (per the P4 pattern of `road-to-kernel-and-router.md`); task→tier heuristics stay in `contexts/model-recommendations.md` (loaded via `load_context`).
|
|
25
|
-
Trigger-set above activates this routing
|
|
23
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -2,16 +2,14 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "3"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
description: "
|
|
5
|
+
description: "PR/issue/comment/commit bodies — no 'Generated with' / 'Co-authored by' / 'opened by' attribution footers"
|
|
6
6
|
triggers:
|
|
7
7
|
- intent: "PR body"
|
|
8
8
|
- intent: "commit message"
|
|
9
9
|
- intent: "Jira comment"
|
|
10
10
|
- keyword: "co-authored"
|
|
11
|
-
workspaces:
|
|
12
|
-
|
|
13
|
-
packs:
|
|
14
|
-
- meta
|
|
11
|
+
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
12
|
+
packs: [meta]
|
|
15
13
|
---
|
|
16
14
|
|
|
17
15
|
# No Attribution Footers
|
|
@@ -3,15 +3,13 @@ type: "always"
|
|
|
3
3
|
tier: "3"
|
|
4
4
|
description: "No cheap questions — never ask what context answers, never offer Iron-Law-violating options, never stage no-trade-off choices; mode-independent (off / auto / on)"
|
|
5
5
|
alwaysApply: true
|
|
6
|
-
workspaces:
|
|
7
|
-
|
|
8
|
-
packs:
|
|
9
|
-
- meta
|
|
6
|
+
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
7
|
+
packs: [meta]
|
|
10
8
|
---
|
|
11
9
|
|
|
12
10
|
# No Cheap Questions
|
|
13
11
|
|
|
14
|
-
Cheap = context answers it, option breaches an Iron Law, choices differ only in sequencing
|
|
12
|
+
Cheap = context answers it, an option breaches an Iron Law, choices differ only in sequencing/format, or one option dominates. Mode-independent; autonomy never lifts the floor.
|
|
15
13
|
|
|
16
14
|
## The Iron Laws
|
|
17
15
|
|
|
@@ -69,7 +67,6 @@ Silent, before any numbered-options block. Any "yes" → don't ask:
|
|
|
69
67
|
11. Cleanup of gitignored / auto-pruned / TTL-managed artefact? Self-managing — state inline, never offer.
|
|
70
68
|
12. Numbered option contains a commit-message body, "message preview", or "Vorschlag falls Du committen willst"? Disguised commit ask — `commit-policy` violation, drop it.
|
|
71
69
|
13. Commit authorized + asking "one commit or multiple?", "how should I split?", "which chunk first?"? Forbidden — `commit-policy § Always split into logical chunks`. Pick the split, state inline, execute.
|
|
70
|
+
14. Artifact just landed (roadmap / ADR / plan / pitch / ticket) + offering "ready to start Phase 1?", "begin execution?", or a `/roadmap:process-*` menu? Forbidden — `scope-control § Authoring vs. implementation` + `scope-mechanics § Post-artifact hard stop`. Authoring verbs never inherit execution authorization. Emit the hand-back line, stop the turn.
|
|
72
71
|
|
|
73
|
-
Pick dominant path, state
|
|
74
|
-
|
|
75
|
-
In doubt → ask. This rule narrows asking, never widens silence. When asking IS allowed: [`cheap-question-mechanics`](../contexts/execution/cheap-question-mechanics.md).
|
|
72
|
+
Pick the dominant path, state the assumption inline, hand back. Genuine ambiguity → [`ask-when-uncertain`](ask-when-uncertain.md). In doubt → ask: this rule narrows asking, never widens silence. When asking IS allowed: [`cheap-question-mechanics`](../contexts/execution/cheap-question-mechanics.md).
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "3"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
description: "
|
|
5
|
+
description: "PR/issue/commit titles and comments — no decorative emojis; bodies only with an in-artifact legend"
|
|
6
6
|
triggers:
|
|
7
7
|
- intent: "PR title"
|
|
8
8
|
- intent: "PR body"
|
|
@@ -11,11 +11,8 @@ triggers:
|
|
|
11
11
|
- intent: "post PR comment"
|
|
12
12
|
- keyword: "gh pr create"
|
|
13
13
|
- keyword: "git commit"
|
|
14
|
-
workspaces:
|
|
15
|
-
|
|
16
|
-
- engineering
|
|
17
|
-
packs:
|
|
18
|
-
- meta
|
|
14
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
15
|
+
packs: [meta]
|
|
19
16
|
---
|
|
20
17
|
|
|
21
18
|
# No Decorative Emojis in Git Surfaces
|
|
@@ -2,18 +2,15 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
description: "
|
|
5
|
+
description: "PR comments — no unsolicited progress/status/CI narration unless personal.pr_progress_comments is true"
|
|
6
6
|
triggers:
|
|
7
7
|
- intent: "post PR comment"
|
|
8
8
|
- intent: "PR status update"
|
|
9
9
|
- intent: "CI fix progress"
|
|
10
10
|
- keyword: "gh pr comment"
|
|
11
11
|
- keyword: "PullRequestComment"
|
|
12
|
-
workspaces:
|
|
13
|
-
|
|
14
|
-
- engineering
|
|
15
|
-
packs:
|
|
16
|
-
- meta
|
|
12
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
13
|
+
packs: [meta]
|
|
17
14
|
---
|
|
18
15
|
|
|
19
16
|
# No Unsolicited PR Progress Comments
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "mechanical-already"
|
|
4
|
-
description: "Linking transient files (agents/roadmaps/, agents/runtime/council
|
|
4
|
+
description: "Linking transient files (agents/roadmaps/, agents/runtime/council/) from stable artifacts — both expire; promote findings"
|
|
5
5
|
alwaysApply: false
|
|
6
6
|
triggers:
|
|
7
7
|
- path_prefix: "agents/roadmaps/"
|
|
@@ -16,10 +16,8 @@ validator_ignore:
|
|
|
16
16
|
- type: "substring"
|
|
17
17
|
pattern: ".agent-src.uncondensed/"
|
|
18
18
|
reason: "Rule contrasts the authoring tree with transient layers."
|
|
19
|
-
workspaces:
|
|
20
|
-
|
|
21
|
-
packs:
|
|
22
|
-
- meta
|
|
19
|
+
workspaces: [agent-config-maintainer]
|
|
20
|
+
packs: [meta]
|
|
23
21
|
---
|
|
24
22
|
|
|
25
23
|
# No Transient References from Stable Artifacts
|
|
@@ -5,15 +5,13 @@ description: "Hard Floor: agent asks before prod-trunk commits/merges, deploys,
|
|
|
5
5
|
alwaysApply: true
|
|
6
6
|
load_context:
|
|
7
7
|
- ../contexts/authority/destructive-mechanics.md
|
|
8
|
-
workspaces:
|
|
9
|
-
|
|
10
|
-
packs:
|
|
11
|
-
- engineering-base
|
|
8
|
+
workspaces: [engineering]
|
|
9
|
+
packs: [engineering-base]
|
|
12
10
|
---
|
|
13
11
|
|
|
14
12
|
# Non-Destructive by Default
|
|
15
13
|
|
|
16
|
-
Universal safety floor — every mode, every
|
|
14
|
+
Universal safety floor — every mode, every turn. Autonomy, "just keep going", roadmap authorizations, standing permissions narrow other rules — **none lift this one**.
|
|
17
15
|
|
|
18
16
|
## The Iron Law
|
|
19
17
|
|
|
@@ -28,30 +26,30 @@ Triggers below require explicit user confirmation **on this turn** — not from
|
|
|
28
26
|
| Trigger | Examples |
|
|
29
27
|
|---|---|
|
|
30
28
|
| **Production-branch merge** | `main`, `master`, `prod`, `production`, `release/*`, or any project-marked deployment trunk |
|
|
31
|
-
| **Commit on a production branch** | any `git commit` while `HEAD` is on a prod trunk
|
|
29
|
+
| **Commit on a production branch** | any `git commit` while `HEAD` is on a prod trunk. **Verify branch before every commit** — `main` is opt-in only, never inferred from a prior turn or a merged PR that left HEAD on `main` |
|
|
32
30
|
| **Deploy / release** | prod `terraform apply` / `kubectl apply`, deploy scripts, release commands, CI-deploying tag pushes |
|
|
33
31
|
| **Push to remote** | any `git push` (also covered by [`scope-control`](scope-control.md), restated so the floor never weakens) |
|
|
34
32
|
| **Production data / infra** | prod DB writes / migrations, prod config, secrets rotation, IAM / role / policy, DNS, anything in a `prod`-scoped path or pipeline |
|
|
35
|
-
| **Whimsical / unscoped bulk deletion** | `rm -rf <dir>`, `git rm -r`, glob
|
|
36
|
-
| **Commit containing bulk deletions or infra changes** | diff removes a directory, deletes ≥5 unrelated files, or touches Terraform
|
|
33
|
+
| **Whimsical / unscoped bulk deletion** | `rm -rf <dir>`, `git rm -r`, glob deletes, `DROP TABLE`, `TRUNCATE`, `git reset --hard` past unpushed work — when **not required** by the task (task-aligned WIP deletions allowed, below) |
|
|
34
|
+
| **Commit containing bulk deletions or infra changes** | diff removes a directory, deletes ≥5 unrelated files, or touches Terraform/Pulumi/k8s/Ansible/cloud-config — surface the diff + confirm even when [`commit-policy`](commit-policy.md) authorizes |
|
|
37
35
|
|
|
38
|
-
Standing "just keep going" + next step crosses the floor → STOP, surface
|
|
36
|
+
Standing "just keep going" + next step crosses the floor → STOP, surface it (one numbered-options block per [`user-interaction`](user-interaction.md)), wait.
|
|
39
37
|
|
|
40
38
|
## Not in scope — deterministic regeneration
|
|
41
39
|
|
|
42
|
-
Output regenerated from a tracked source (condensation, code-gen,
|
|
40
|
+
Output regenerated from a tracked source (condensation, code-gen, formatters, lock-files) is reversible — **not destructive** ([`autonomous-execution`](autonomous-execution.md)). Per-file diff approval is theater.
|
|
43
41
|
|
|
44
42
|
## Bulk deletions during WIP — allowed if task-connected
|
|
45
43
|
|
|
46
|
-
Deletions inside an **active, user-stated task** are allowed in the working tree
|
|
44
|
+
Deletions inside an **active, user-stated task** are allowed in the working tree — the Hard Floor moves to the **commit** (row 6). Whimsical / drive-by / unnamed-scope deletions still trip the floor on the edit. Allowed/forbidden lists: [`destructive-mechanics`](../contexts/authority/destructive-mechanics.md).
|
|
47
45
|
|
|
48
46
|
## Failure modes
|
|
49
47
|
|
|
50
|
-
|
|
48
|
+
Catalog (autonomy-as-cover, roadmap-as-authorization, refusing-named-deletions, commit-without-diff-surface): [`destructive-mechanics`](../contexts/authority/destructive-mechanics.md).
|
|
51
49
|
|
|
52
50
|
## Cloud Behavior
|
|
53
51
|
|
|
54
|
-
|
|
52
|
+
Applies on every surface — web, Skills API, any cloud agent. No "cloud override".
|
|
55
53
|
|
|
56
54
|
## See also
|
|
57
55
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2b"
|
|
4
|
-
description: "Reasoning-heavy work
|
|
4
|
+
description: "Reasoning-heavy work — hypotheses/predictions/decisions go to session notes; the response carries conclusions + evidence"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "debug"
|
|
7
7
|
- keyword: "investigate"
|
|
@@ -13,10 +13,8 @@ load_context:
|
|
|
13
13
|
- ../contexts/execution/rdp-gate.md
|
|
14
14
|
routes_to:
|
|
15
15
|
- "skill:memory-consolidation"
|
|
16
|
-
workspaces:
|
|
17
|
-
|
|
18
|
-
packs:
|
|
19
|
-
- meta
|
|
16
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
17
|
+
packs: [meta]
|
|
20
18
|
---
|
|
21
19
|
|
|
22
20
|
# Notes-First Reasoning
|
|
@@ -1,15 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "1"
|
|
4
|
-
description: "First turn
|
|
4
|
+
description: "First turn with onboarding.onboarded false — instruct dev to run `agent-config setup` first"
|
|
5
5
|
triggers:
|
|
6
6
|
- phrase: "first turn"
|
|
7
7
|
- keyword: "onboarding"
|
|
8
8
|
- path_prefix: ".agent-settings.yml"
|
|
9
|
-
workspaces:
|
|
10
|
-
|
|
11
|
-
packs:
|
|
12
|
-
- meta
|
|
9
|
+
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
10
|
+
packs: [meta]
|
|
13
11
|
---
|
|
14
12
|
|
|
15
13
|
# Onboarding Gate
|
|
@@ -20,4 +18,4 @@ packs:
|
|
|
20
18
|
|
|
21
19
|
Cloud surfaces without settings file stay inert: rule does not fire when `.agent-settings.yml` absent → headless / read-only contexts (Cloudflare MCP, doc preview, CI) never see prompt.
|
|
22
20
|
|
|
23
|
-
Trigger-set above activates routing
|
|
21
|
+
Trigger-set above activates routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -1,17 +1,15 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "
|
|
4
|
+
description: "No placeholder prose in generated code/UI — no truncation shorthands; on budget overflow emit a clean PAUSED breakpoint"
|
|
5
5
|
triggers:
|
|
6
6
|
- intent: "generating code or multi-section output"
|
|
7
7
|
- keyword: "// rest of component"
|
|
8
8
|
- keyword: "for brevity"
|
|
9
9
|
- keyword: "rest follows the same pattern"
|
|
10
10
|
- phrase: "similar pattern"
|
|
11
|
-
workspaces:
|
|
12
|
-
|
|
13
|
-
packs:
|
|
14
|
-
- engineering-base
|
|
11
|
+
workspaces: [engineering]
|
|
12
|
+
packs: [engineering-base]
|
|
15
13
|
---
|
|
16
14
|
|
|
17
15
|
# Output Discipline
|
|
@@ -8,10 +8,8 @@ triggers:
|
|
|
8
8
|
- phrase: "before pr"
|
|
9
9
|
routes_to:
|
|
10
10
|
- "skill:lint-skills"
|
|
11
|
-
workspaces:
|
|
12
|
-
|
|
13
|
-
packs:
|
|
14
|
-
- meta
|
|
11
|
+
workspaces: [agent-config-maintainer]
|
|
12
|
+
packs: [meta]
|
|
15
13
|
---
|
|
16
14
|
|
|
17
15
|
# Package Ci Checks
|
|
@@ -19,4 +17,4 @@ packs:
|
|
|
19
17
|
**Iron Law.** Run `task ci` locally and confirm green before pushing or opening a PR in this package.
|
|
20
18
|
|
|
21
19
|
Body migrated to `skill:lint-skills` (per P4 of `road-to-kernel-and-router.md`).
|
|
22
|
-
Trigger-set above activates this routing
|
|
20
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -23,10 +23,8 @@ validator_ignore:
|
|
|
23
23
|
- type: "substring"
|
|
24
24
|
pattern: ".agent-src.uncondensed/"
|
|
25
25
|
reason: "Rule documents the persona authoring tree (.agent-src.uncondensed/personas/) as the deprecation-path operand."
|
|
26
|
-
workspaces:
|
|
27
|
-
|
|
28
|
-
packs:
|
|
29
|
-
- meta
|
|
26
|
+
workspaces: [agent-config-maintainer]
|
|
27
|
+
packs: [meta]
|
|
30
28
|
---
|
|
31
29
|
|
|
32
30
|
# Persona Governance
|
|
@@ -8,10 +8,8 @@ triggers:
|
|
|
8
8
|
- keyword: "ecs"
|
|
9
9
|
routes_to:
|
|
10
10
|
- "guideline:php/php-coding-patterns"
|
|
11
|
-
workspaces:
|
|
12
|
-
|
|
13
|
-
packs:
|
|
14
|
-
- php
|
|
11
|
+
workspaces: [engineering]
|
|
12
|
+
packs: [php]
|
|
15
13
|
trust:
|
|
16
14
|
level: professional
|
|
17
15
|
install:
|
|
@@ -24,4 +22,4 @@ install:
|
|
|
24
22
|
**Iron Law.** PHP: strict types, named comparisons, early returns, Eloquent conventions — full pattern library in the guideline.
|
|
25
23
|
|
|
26
24
|
Body migrated to `guideline:php/php-coding-patterns` (per P4 of `road-to-kernel-and-router.md`).
|
|
27
|
-
Trigger-set above activates this routing
|
|
25
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -12,10 +12,8 @@ validator_ignore:
|
|
|
12
12
|
- type: "substring"
|
|
13
13
|
pattern: ".agent-src.uncondensed/"
|
|
14
14
|
reason: "Rule references the authoring tree as the operand of condensation/preservation."
|
|
15
|
-
workspaces:
|
|
16
|
-
|
|
17
|
-
packs:
|
|
18
|
-
- meta
|
|
15
|
+
workspaces: [agent-config-maintainer]
|
|
16
|
+
packs: [meta]
|
|
19
17
|
---
|
|
20
18
|
|
|
21
19
|
# Preservation Guard
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Editing an AI video/image/audio adapter — declare lifecycle tier
|
|
4
|
+
description: "Editing an AI video/image/audio adapter — declare lifecycle tier; never default to non-stable"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "/video:"
|
|
7
7
|
- keyword: "/image:"
|
|
@@ -23,10 +23,8 @@ applies_to_user_types:
|
|
|
23
23
|
- "creator"
|
|
24
24
|
- "developer"
|
|
25
25
|
- "maintainer"
|
|
26
|
-
workspaces:
|
|
27
|
-
|
|
28
|
-
packs:
|
|
29
|
-
- meta
|
|
26
|
+
workspaces: [agent-config-maintainer, engineering, gtm]
|
|
27
|
+
packs: [ai-image, ai-video]
|
|
30
28
|
---
|
|
31
29
|
|
|
32
30
|
# Provider Lifecycle Discipline
|
|
@@ -1,18 +1,17 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "
|
|
4
|
+
description: "Reviewer suggestions / risk hotspots — anchor in paths/risk + ownership-map; medium/high needs primary + secondary"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "reviewer"
|
|
7
7
|
- phrase: "suggest reviewers"
|
|
8
8
|
- phrase: "risk hotspot"
|
|
9
9
|
- phrase: "ownership map"
|
|
10
|
+
- phrase: "review this pr"
|
|
10
11
|
routes_to:
|
|
11
12
|
- "skill:review-routing"
|
|
12
|
-
workspaces:
|
|
13
|
-
|
|
14
|
-
packs:
|
|
15
|
-
- meta
|
|
13
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
14
|
+
packs: [meta]
|
|
16
15
|
---
|
|
17
16
|
|
|
18
17
|
# Reviewer Awareness
|
|
@@ -22,7 +21,7 @@ packs:
|
|
|
22
21
|
**Iron Law (routing / risk).** Consult ownership-map and historical-bug-patterns before suggesting reviewers or claiming a change is safe.
|
|
23
22
|
|
|
24
23
|
Body migrated to `skill:review-routing` (per P4 of `road-to-kernel-and-router.md`).
|
|
25
|
-
Trigger-set above activates this routing
|
|
24
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
26
25
|
|
|
27
26
|
Consolidates the former review-routing-awareness rule per the
|
|
28
27
|
package's adr-auto-rule-consolidation decision.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "
|
|
4
|
+
description: "Roadmap authoring/execution — no full-pipeline CI steps when quality.local_auto_run is false; skip inline"
|
|
5
5
|
triggers:
|
|
6
6
|
- path_prefix: "agents/roadmaps/"
|
|
7
7
|
- path_prefix: "{module_root}/" # resolved via modules.root_paths; Laravel shape: app/Modules/
|
|
@@ -24,10 +24,8 @@ validator_ignore:
|
|
|
24
24
|
- type: "substring"
|
|
25
25
|
pattern: ".agent-settings.yml"
|
|
26
26
|
reason: "Rule reads quality.local_auto_run from .agent-settings.yml; naming the file is the contract."
|
|
27
|
-
workspaces:
|
|
28
|
-
|
|
29
|
-
packs:
|
|
30
|
-
- meta
|
|
27
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
28
|
+
packs: [meta]
|
|
31
29
|
---
|
|
32
30
|
|
|
33
31
|
# Roadmap CI-Steps Policy
|