@event4u/agent-config 7.5.0 → 8.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +8 -1
- package/AGENTS.md +9 -9
- package/CHANGELOG.md +325 -0
- 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 +8 -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/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: "
|
|
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
|
|
@@ -9,10 +9,8 @@ triggers:
|
|
|
9
9
|
- command: "/roadmap:process-full"
|
|
10
10
|
routes_to:
|
|
11
11
|
- "guideline:agent-infra/roadmap-progress-mechanics"
|
|
12
|
-
workspaces:
|
|
13
|
-
|
|
14
|
-
packs:
|
|
15
|
-
- meta
|
|
12
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
13
|
+
packs: [meta]
|
|
16
14
|
---
|
|
17
15
|
|
|
18
16
|
# Roadmap Progress Sync
|
|
@@ -54,6 +52,8 @@ The `command:` triggers in this rule's frontmatter ensure it loads the moment on
|
|
|
54
52
|
|
|
55
53
|
**Dashboard regen cadence — opt-in batching.** The checkbox flip is non-batchable. The **subprocess regen** (`./agent-config roadmap:progress`) is batchable per `roadmap.dashboard_regen_cadence` in `.agent-settings.yml` (`per_step` default · `every_5_steps` · `phase_boundary`). Run end, phase boundary, and any file-shape touch (rename / phase add / archive — Iron Law 1) always force an immediate regen regardless of cadence.
|
|
56
54
|
|
|
55
|
+
**Blockers follow same cadence as checkboxes.** Clearing a `## Blockers` entry (per [`templates/roadmaps.md` rule 20](../templates/roadmaps.md)) flips its `Status: resolved`, regenerates dashboard in same reply — Iron Law 1's "same response" obligation applies to blocker resolution exactly as it applies to a checkbox flip.
|
|
56
|
+
|
|
57
57
|
## Iron Law 3 — no silent archive with unresolved deferred items
|
|
58
58
|
|
|
59
59
|
```
|
|
@@ -138,4 +138,4 @@ Before sending any reply that landed roadmap work:
|
|
|
138
138
|
Any "no" at step 2 → reply is incomplete. Do not send. A skipped step 3 regen is fine when cadence permits — checkbox truth lives in the markdown file. Skipping the deferred-resolution gate at step 4 is **never** acceptable; it is the canonical "lost-information" failure mode this rule exists to prevent.
|
|
139
139
|
|
|
140
140
|
Long-form mechanics (failure-mode catalog, Copilot fallback, `[~]` vs `[ ]` semantics, hook + CI defence-in-depth) live in `guideline:agent-infra/roadmap-progress-mechanics`.
|
|
141
|
-
Trigger-set above activates this routing
|
|
141
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -7,10 +7,8 @@ triggers:
|
|
|
7
7
|
- keyword: "active_role"
|
|
8
8
|
- keyword: "role-mode"
|
|
9
9
|
- intent: "mode marker"
|
|
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
|
# Role Mode Adherence
|
|
@@ -6,10 +6,8 @@ triggers:
|
|
|
6
6
|
- path_prefix: ".agent-src.uncondensed/rules/"
|
|
7
7
|
routes_to:
|
|
8
8
|
- "guideline:agent-infra/rule-type-governance"
|
|
9
|
-
workspaces:
|
|
10
|
-
|
|
11
|
-
packs:
|
|
12
|
-
- meta
|
|
9
|
+
workspaces: [agent-config-maintainer]
|
|
10
|
+
packs: [meta]
|
|
13
11
|
---
|
|
14
12
|
|
|
15
13
|
# Rule Type Governance
|
|
@@ -17,4 +15,4 @@ packs:
|
|
|
17
15
|
**Iron Law.** Choose `always` vs `auto` per the governance table; over-broad `always` rules degrade the kernel budget.
|
|
18
16
|
|
|
19
17
|
Body migrated to `guideline:agent-infra/rule-type-governance` (per P4 of `road-to-kernel-and-router.md`).
|
|
20
|
-
Trigger-set above activates this routing
|
|
18
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -6,10 +6,8 @@ alwaysApply: true
|
|
|
6
6
|
load_context:
|
|
7
7
|
- ../contexts/authority/scope-mechanics.md
|
|
8
8
|
- ../contexts/authority/kernel-rule-edits.md
|
|
9
|
-
workspaces:
|
|
10
|
-
|
|
11
|
-
packs:
|
|
12
|
-
- engineering-base
|
|
9
|
+
workspaces: [engineering]
|
|
10
|
+
packs: [engineering-base]
|
|
13
11
|
---
|
|
14
12
|
|
|
15
13
|
# Scope Control
|
|
@@ -33,30 +31,31 @@ The user decides the git shape. Never improvise. Commit specifics: canonical [`c
|
|
|
33
31
|
- NEVER push a tag or create a release without permission.
|
|
34
32
|
- NEVER pin versions, release targets, deprecation dates, or git tags in roadmaps / plans / tickets — they plan **work**, not releases. Detail: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
|
|
35
33
|
- Task seems to need a separate branch / PR → STOP and **brief before asking** ([`scope-mechanics`](../contexts/authority/scope-mechanics.md)).
|
|
36
|
-
- BEFORE the first commit on related work, **inventory** existing branches
|
|
34
|
+
- BEFORE the first commit on related work, **inventory** existing branches + open PRs; plausible other base → STOP, ask with numbered options. Commands + 4-option template: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
|
|
37
35
|
|
|
38
|
-
"Explicit permission" = said **this turn or in
|
|
36
|
+
"Explicit permission" = said **this turn or in an unrevoked standing instruction**. Permission for one operation never carries to another.
|
|
39
37
|
|
|
40
38
|
## Authoring vs. implementation
|
|
41
39
|
|
|
42
40
|
```
|
|
43
41
|
"CREATE / DRAFT" AUTHORIZES THE ARTIFACT, NOT ITS EXECUTION.
|
|
44
42
|
NEW TASK NEVER INHERITS PRIOR AUTONOMY.
|
|
43
|
+
ARTIFACT SAVED → HARD STOP. NEVER AUTO-OFFER EXECUTION.
|
|
45
44
|
```
|
|
46
45
|
|
|
47
|
-
`create / draft / write / erstelle …` → artifact only. Execution verbs flip scope; mixed → ask. Detail: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
|
|
46
|
+
`create / draft / write / erstelle …` → artifact only. Execution verbs flip scope; mixed → ask. The moment the artifact lands (roadmap, ADR, plan, pitch, ticket), the turn ends — never auto-offer execution; execution needs an explicit execution verb (`implement`, `build`, `start`, `arbeite ab`) on a later turn. Detail + anti-patterns: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
|
|
48
47
|
|
|
49
48
|
## Production, infrastructure, bulk-destructive — Hard Floor
|
|
50
49
|
|
|
51
|
-
A subset is **never** autonomous
|
|
50
|
+
A subset is **never** autonomous. Canonical: [`non-destructive-by-default`](non-destructive-by-default.md); triggers + this-turn-only clarification: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
|
|
52
51
|
|
|
53
52
|
## Kernel-rule edits — slow-rollout guarantee
|
|
54
53
|
|
|
55
|
-
Own PR, ≥ 24 h between merges
|
|
54
|
+
Own PR, ≥ 24 h between merges; autonomous mandate does not lift (soak guarantee). CI/labels/scope: [`kernel-rule-edits`](../contexts/authority/kernel-rule-edits.md).
|
|
56
55
|
|
|
57
56
|
## Decline = silence — no re-asking on the same task
|
|
58
57
|
|
|
59
|
-
After the user **declines** a proposal (branch switch, PR
|
|
58
|
+
After the user **declines** a proposal (branch switch, PR, tag/release, worktree, version pinning), do **not** raise it again on the same task — decline stands until reopened. Timing: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
|
|
60
59
|
|
|
61
60
|
## Fenced step — user-set review gates
|
|
62
61
|
|
|
@@ -65,4 +64,4 @@ USER FENCED OFF EXECUTION → DELIVER + HAND BACK.
|
|
|
65
64
|
NO "READY TO IMPLEMENT?" / "PHASE 1?" RE-ASK.
|
|
66
65
|
```
|
|
67
66
|
|
|
68
|
-
Fence (*"plan only"*, *"review first"*,
|
|
67
|
+
Fence (*"plan only"*, *"review first"*, DE equivalents) stands until reopened. Follow-ups cover the deliverable, not its execution. Failure modes + bypass: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
|
|
@@ -2,21 +2,20 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
description: "Security-sensitive paths
|
|
5
|
+
description: "Security-sensitive paths (auth, billing, tenants, secrets, uploads, webhooks) — threat-model BEFORE editing"
|
|
6
6
|
triggers:
|
|
7
7
|
- keyword: "auth"
|
|
8
8
|
- keyword: "billing"
|
|
9
9
|
- keyword: "tenant"
|
|
10
10
|
- keyword: "secret"
|
|
11
11
|
- keyword: "webhook"
|
|
12
|
+
- keyword: "password"
|
|
12
13
|
validator_ignore:
|
|
13
14
|
- type: "substring"
|
|
14
15
|
pattern: "../../docs/"
|
|
15
16
|
reason: "See-also routes to docs/threat-model.md — the canonical attack-surface doc lives there by design."
|
|
16
|
-
workspaces:
|
|
17
|
-
|
|
18
|
-
packs:
|
|
19
|
-
- engineering-base
|
|
17
|
+
workspaces: [engineering]
|
|
18
|
+
packs: [engineering-base]
|
|
20
19
|
---
|
|
21
20
|
|
|
22
21
|
# Security-Sensitive Stop Rule
|
|
@@ -8,10 +8,8 @@ triggers:
|
|
|
8
8
|
- keyword: "pipeline"
|
|
9
9
|
routes_to:
|
|
10
10
|
- "skill:skill-improvement-pipeline"
|
|
11
|
-
workspaces:
|
|
12
|
-
|
|
13
|
-
packs:
|
|
14
|
-
- meta
|
|
11
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
12
|
+
packs: [meta]
|
|
15
13
|
---
|
|
16
14
|
|
|
17
15
|
# Skill Improvement Trigger
|
|
@@ -19,4 +17,4 @@ packs:
|
|
|
19
17
|
**Iron Law.** After a meaningful task, trigger the post-task learning capture if `pipelines.skill_improvement` is enabled.
|
|
20
18
|
|
|
21
19
|
Body migrated to `skill:skill-improvement-pipeline` (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).
|