@event4u/agent-config 7.4.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 +11 -1
- package/AGENTS.md +9 -9
- package/CHANGELOG.md +373 -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/review-changes.md +14 -7
- 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 +11 -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 +7 -8
- 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 +4 -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 +5 -7
- 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 +11 -10
- 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 +52 -42
- package/dist/agent-src/skills/adversarial-review/SKILL.md +1 -1
- 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/blade-ui/SKILL.md +4 -0
- 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 +5 -4
- 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 +5 -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-authoring/SKILL.md +1 -1
- 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 +45 -2
- package/dist/agent-src/skills/design-intelligence/references/design-languages.md +1 -1
- package/dist/agent-src/skills/design-review/SKILL.md +23 -11
- package/dist/agent-src/skills/design-system-capture/SKILL.md +41 -0
- package/dist/agent-src/skills/design-system-capture/reference/design-system-json.md +62 -0
- package/dist/agent-src/skills/design-tokens/SKILL.md +11 -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/existing-ui-audit/SKILL.md +6 -0
- package/dist/agent-src/skills/fe-design/SKILL.md +20 -0
- package/dist/agent-src/skills/flux/SKILL.md +4 -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/iconography/SKILL.md +1 -0
- package/dist/agent-src/skills/image-editing/evals/triggers.json +13 -13
- package/dist/agent-src/skills/judge-artifact-completeness/SKILL.md +136 -0
- package/dist/agent-src/skills/judge-artifact-completeness/calibration/fixtures.json +149 -0
- package/dist/agent-src/skills/judge-artifact-completeness/evals/triggers.json +17 -0
- package/dist/agent-src/skills/judge-artifact-completeness/rubrics/architecture-score.json +73 -0
- package/dist/agent-src/skills/judge-artifact-completeness/rubrics/pr-review-score.json +65 -0
- package/dist/agent-src/skills/judge-artifact-completeness/rubrics/roadmap-score.json +73 -0
- package/dist/agent-src/skills/judge-artifact-completeness/rubrics/ticket-quality-score.json +73 -0
- package/dist/agent-src/skills/judge-code-quality/SKILL.md +1 -0
- package/dist/agent-src/skills/judge-injection-defense/SKILL.md +99 -0
- package/dist/agent-src/skills/judge-injection-defense/calibration/fixtures.json +24 -0
- package/dist/agent-src/skills/judge-injection-defense/evals/triggers.json +17 -0
- package/dist/agent-src/skills/judge-injection-defense/fixtures/behavioral-fixtures.json +63 -0
- package/dist/agent-src/skills/judge-injection-defense/fixtures/coverage-report.md +53 -0
- package/dist/agent-src/skills/judge-injection-defense/fixtures/perturbation-taxonomy.json +110 -0
- package/dist/agent-src/skills/judge-synthesis/SKILL.md +134 -0
- package/dist/agent-src/skills/judge-synthesis/evals/triggers.json +17 -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/logo-generation/SKILL.md +1 -1
- package/dist/agent-src/skills/markitdown/SKILL.md +1 -1
- 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/react-shadcn-ui/SKILL.md +18 -0
- package/dist/agent-src/skills/react-shadcn-ui/reference/registry.md +59 -0
- package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +3 -1
- package/dist/agent-src/skills/refine-ticket/SKILL.md +5 -1
- package/dist/agent-src/skills/release-comms/SKILL.md +47 -46
- package/dist/agent-src/skills/roadmap-management/SKILL.md +25 -0
- package/dist/agent-src/skills/roadmap-writing/SKILL.md +33 -3
- package/dist/agent-src/skills/root-cause-frameworks/SKILL.md +0 -3
- package/dist/agent-src/skills/script-writing/SKILL.md +1 -1
- 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/sql-writing/SKILL.md +1 -1
- 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 +30 -1
- package/dist/agent-src/skills/tailwind-engineer/SKILL.md +4 -0
- package/dist/agent-src/skills/testing-anti-patterns/SKILL.md +1 -1
- package/dist/agent-src/skills/threat-modeling/SKILL.md +2 -2
- package/dist/agent-src/skills/token-optimizer/SKILL.md +1 -1
- package/dist/agent-src/skills/typography-system/SKILL.md +4 -3
- 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 +802 -258
- 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 +46 -28
- package/dist/discovery/trust-report.md +12 -11
- package/dist/discovery/workspaces.json +32 -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 +6 -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 +6 -6
- package/docs/benchmark.md +133 -2
- package/docs/benchmark.pinned.yml +31 -0
- package/docs/capability-matrix.md +1 -0
- package/docs/catalog.md +92 -74
- package/docs/command-flows.md +16 -4
- 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 +35 -0
- package/docs/guidelines/design-canon.md +62 -0
- 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 +71 -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 +208 -0
- package/src/scripts/design_slop_rules.ts +530 -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 +14 -3
- 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 +40 -17
- package/src/scripts/hooks/design_slop_hook.ts +181 -0
- 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_agent_security.ts +1 -0
- package/src/scripts/lint_agents_layout.ts +74 -15
- package/src/scripts/lint_bench_ab.ts +4 -1
- package/src/scripts/lint_confusables.ts +197 -0
- package/src/scripts/lint_design_slop.ts +245 -0
- 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
|
@@ -2,8 +2,7 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2b"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
|
|
6
|
-
description: "Delegable multi-part work + auto-orchestration enabled — decompose, tier-size each slice, dispatch to subagents instead of doing it all in-session"
|
|
5
|
+
description: "Delegable multi-part work + auto-orchestration on — decompose, tier-size, dispatch to subagents instead of in-session"
|
|
7
6
|
triggers:
|
|
8
7
|
- keyword: "delegate"
|
|
9
8
|
- keyword: "orchestrate"
|
|
@@ -12,15 +11,15 @@ triggers:
|
|
|
12
11
|
- phrase: "review these"
|
|
13
12
|
- phrase: "analyze the codebase"
|
|
14
13
|
- phrase: "for each"
|
|
14
|
+
- keyword: "analyse"
|
|
15
|
+
- keyword: "analyze"
|
|
15
16
|
load_context:
|
|
16
17
|
- "../contexts/execution/auto-orchestration-activation.md"
|
|
17
18
|
- "../contexts/execution/auto-dispatch-classification.md"
|
|
18
19
|
routes_to:
|
|
19
20
|
- "skill:subagent-orchestration"
|
|
20
|
-
workspaces:
|
|
21
|
-
|
|
22
|
-
packs:
|
|
23
|
-
- engineering-base
|
|
21
|
+
workspaces: [engineering]
|
|
22
|
+
packs: [engineering-base]
|
|
24
23
|
---
|
|
25
24
|
|
|
26
25
|
# Delegation Policy
|
|
@@ -68,6 +67,11 @@ primitive → run in-session (clean no-op).
|
|
|
68
67
|
[`verify-budget`](../contexts/execution/verify-budget.md); the cross-model
|
|
69
68
|
judge Iron Law and the N=3 budget ([`autonomous-execution`](autonomous-execution.md))
|
|
70
69
|
are never lifted.
|
|
70
|
+
5. **Respect the failure-type stop and the ordering gate** — two consecutive
|
|
71
|
+
verification-failed returns from one subagent type stop that type for the
|
|
72
|
+
session (an application of the N=3 budget, no new mechanism); an ordered
|
|
73
|
+
slice never dispatches before its declared parent's return is verified.
|
|
74
|
+
Both per [`subagent-steering`](../contexts/execution/subagent-steering.md).
|
|
71
75
|
|
|
72
76
|
## Scope — does NOT
|
|
73
77
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "A provided prototype
|
|
4
|
+
description: "A provided prototype/mockup/design system is the spec — build 1:1; never swap fonts, controls, or layout unconfirmed"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "prototype"
|
|
7
7
|
- keyword: "mockup"
|
|
@@ -17,10 +17,8 @@ applies_to_user_types:
|
|
|
17
17
|
- "creator"
|
|
18
18
|
- "developer"
|
|
19
19
|
- "maintainer"
|
|
20
|
-
workspaces:
|
|
21
|
-
|
|
22
|
-
packs:
|
|
23
|
-
- engineering-base
|
|
20
|
+
workspaces: [engineering]
|
|
21
|
+
packs: [frontend-design]
|
|
24
22
|
---
|
|
25
23
|
|
|
26
24
|
# Design Fidelity
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "3"
|
|
4
|
-
description: "Wiring DevContainers/Codespaces
|
|
4
|
+
description: "Wiring DevContainers/Codespaces (devcontainer.json, features, ports) — route to the devcontainer skill"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "devcontainer"
|
|
7
7
|
- keyword: "codespaces"
|
|
@@ -9,10 +9,8 @@ triggers:
|
|
|
9
9
|
- phrase: "devcontainer.json"
|
|
10
10
|
routes_to:
|
|
11
11
|
- "skill:devcontainer"
|
|
12
|
-
workspaces:
|
|
13
|
-
|
|
14
|
-
packs:
|
|
15
|
-
- meta
|
|
12
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
13
|
+
packs: [meta]
|
|
16
14
|
---
|
|
17
15
|
|
|
18
16
|
# Devcontainer Routing
|
|
@@ -20,4 +18,4 @@ packs:
|
|
|
20
18
|
**Iron Law.** Wiring the dev environment itself (DevContainers, Codespaces, `devcontainer.json`, VS Code features) → load the `devcontainer` skill, not `copilot-config` (which tunes the Copilot AI on top).
|
|
21
19
|
|
|
22
20
|
Body migrated to `skill:devcontainer`. Disambiguates the devcontainer ↔ copilot-config cluster head per [`adr-architectural-consensus-mechanism`](../docs/contracts/adr-architectural-consensus-mechanism.md).
|
|
23
|
-
Trigger-set above activates this routing
|
|
21
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -3,10 +3,8 @@ type: "always"
|
|
|
3
3
|
tier: "3"
|
|
4
4
|
description: "Always — direct, unembellished answers. No flattery, no invented facts (verify load-bearing claims, otherwise ask). Emojis only as functional markers. Brevity is the default."
|
|
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
|
# Direct Answers
|
|
@@ -22,7 +20,7 @@ ANSWER THE SUBSTANCE. SHIP THE TRUTH.
|
|
|
22
20
|
|
|
23
21
|
- No subjective judgment on user code unless evaluation was asked.
|
|
24
22
|
- "Good catch" / "you're right" only when literally true.
|
|
25
|
-
- Mistakes — one
|
|
23
|
+
- Mistakes — acknowledge in one sentence, switch behavior, no apology theatre.
|
|
26
24
|
|
|
27
25
|
## Iron Law 2 — No Invented Facts (severity-tiered)
|
|
28
26
|
|
|
@@ -34,7 +32,7 @@ WHEN VERIFICATION IS NOT WORTH THE COST → ASK.
|
|
|
34
32
|
|
|
35
33
|
Severity tiers (High = load-bearing · Medium = project-shape · Low = idioms), per-tier verification actions, and "just guess" override: [`asking-and-brevity-examples`](../docs/guidelines/agent-infra/asking-and-brevity-examples.md).
|
|
36
34
|
|
|
37
|
-
**Live-state facts — never from memory.** Git/PR
|
|
35
|
+
**Live-state facts — never from memory.** Git/PR merge/branch/sync/existence state is High-severity and decays silently (branch already merged, PR already closed, `main` already ahead). NEVER assert "merged / not merged / pending / still open / already in `main` / out of scope" — or any branch/sync/existence claim — from memory, a roadmap note, an earlier turn, or a recalled memory. Run the live check FIRST (`git log --first-parent origin/main`, `git branch -r --contains <ref>`, `gh pr view <n> --json state,mergedAt,baseRefName`); a state question is self-answering (per [`git-workflow`](../skills/git-workflow/SKILL.md)). Same for any external system that changes behind you (CI run, deploy, remote queue).
|
|
38
36
|
|
|
39
37
|
## Iron Law 3 — Brevity by Default
|
|
40
38
|
|
|
@@ -43,24 +41,22 @@ THE SHORTEST REPLY THAT FULLY ANSWERS THE QUESTION IS THE RIGHT REPLY.
|
|
|
43
41
|
LONG ANSWERS ARE A FAILURE MODE, NOT A SIGN OF EFFORT.
|
|
44
42
|
```
|
|
45
43
|
|
|
46
|
-
- Skip restating the question; skip "Let me…"
|
|
47
|
-
- Skip explaining tool use — the
|
|
48
|
-
-
|
|
49
|
-
- Multi-step → bullets
|
|
44
|
+
- Skip restating the question; skip "Let me…" announcements.
|
|
45
|
+
- Skip explaining tool use — the result speaks.
|
|
46
|
+
- Simple replies skip summary; **work replies** (multi-step change, roadmap/branch progress, created/updated PR) close with ONE end-summary, and a PR created this turn puts its raw URL as the **literal last line**.
|
|
47
|
+
- Multi-step → bullets; one-true-answer → one sentence.
|
|
50
48
|
|
|
51
|
-
Never overrides `user-interaction` (numbered options
|
|
49
|
+
Never overrides `user-interaction` (numbered options) or command steps. Reply-close detail → [`reply-close-mechanics`](../contexts/communication/rules-auto/reply-close-mechanics.md).
|
|
52
50
|
|
|
53
|
-
**Narration carve-out:**
|
|
51
|
+
**Narration carve-out:** only when both `personal.play_by_play` AND `verbosity.intent_announcements` are `true`.
|
|
54
52
|
|
|
55
53
|
## Emoji Scope — functional markers only
|
|
56
54
|
|
|
57
|
-
**Whitelist:** mode markers (`role-mode-adherence`); CLI status
|
|
58
|
-
**Blacklist:** opening flair (
|
|
55
|
+
**Whitelist:** mode markers (`role-mode-adherence`); CLI status `❌`/`✅`/`⚠️`; roadmap checkboxes `[x]`/`[~]`/`[-]`.
|
|
56
|
+
**Blacklist:** opening flair (✨🚀🎉💡🔥👍), empathy (❤️🤗😊), section dividers, reaction emojis. Unsure → blacklist.
|
|
59
57
|
|
|
60
58
|
## Failure modes & examples
|
|
61
59
|
|
|
62
|
-
|
|
63
|
-
Pattern Memory (wrong / right / why): [`direct-answers-demos`](../docs/guidelines/agent-infra/direct-answers-demos.md).
|
|
64
|
-
Outcome baseline: [`tests/golden/outcomes/direct_answers.json`](../../tests/golden/outcomes/direct_answers.json).
|
|
60
|
+
Triggers + corrections: [`asking-and-brevity-examples`](../docs/guidelines/agent-infra/asking-and-brevity-examples.md). Wrong/right/why: [`direct-answers-demos`](../docs/guidelines/agent-infra/direct-answers-demos.md). Baseline: [`tests/golden/outcomes/direct_answers.json`](../../tests/golden/outcomes/direct_answers.json).
|
|
65
61
|
|
|
66
62
|
Cross-rule index: [`frugality-charter`](../contexts/contracts/frugality-charter.md).
|
|
@@ -9,10 +9,8 @@ triggers:
|
|
|
9
9
|
- phrase: "inside the container"
|
|
10
10
|
routes_to:
|
|
11
11
|
- "skill:docker"
|
|
12
|
-
workspaces:
|
|
13
|
-
|
|
14
|
-
packs:
|
|
15
|
-
- engineering-base
|
|
12
|
+
workspaces: [engineering]
|
|
13
|
+
packs: [engineering-base]
|
|
16
14
|
---
|
|
17
15
|
|
|
18
16
|
# Docker Commands
|
|
@@ -20,4 +18,4 @@ packs:
|
|
|
20
18
|
**Iron Law.** Run PHP / artisan / composer / phpstan / rector / ecs / phpunit inside the project container, never on the host.
|
|
21
19
|
|
|
22
20
|
Body migrated to `skill:docker` (per P4 of `road-to-kernel-and-router.md`).
|
|
23
|
-
Trigger-set above activates this routing
|
|
21
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2b"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
description: "Adopting a new domain track (mobile, ML,
|
|
5
|
+
description: "Adopting a new domain track (mobile, ML, IoT…) — demand/owner/CI gates BEFORE harvest"
|
|
6
6
|
triggers:
|
|
7
7
|
- intent: "adopt new domain"
|
|
8
8
|
- intent: "harvest new domain track"
|
|
@@ -15,10 +15,8 @@ validator_ignore:
|
|
|
15
15
|
- type: "substring"
|
|
16
16
|
pattern: ".agent-src.uncondensed/"
|
|
17
17
|
reason: "Rule names the authoring tree as the gated-entry location for new domain plates."
|
|
18
|
-
workspaces:
|
|
19
|
-
|
|
20
|
-
packs:
|
|
21
|
-
- meta
|
|
18
|
+
workspaces: [agent-config-maintainer]
|
|
19
|
+
packs: [meta]
|
|
22
20
|
---
|
|
23
21
|
|
|
24
22
|
# Domain Adoption Policy
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Advisory content (legal, medical, financial, consulting) —
|
|
4
|
+
description: "Advisory content (legal, medical, financial, consulting) — matching 'not X advice' disclaimer; refuse diagnosis/dosage"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "legal brief"
|
|
7
7
|
- keyword: "contract redline"
|
|
@@ -37,10 +37,8 @@ applies_to_user_types:
|
|
|
37
37
|
- "founder"
|
|
38
38
|
- "consultant"
|
|
39
39
|
- "creator"
|
|
40
|
-
workspaces:
|
|
41
|
-
|
|
42
|
-
packs:
|
|
43
|
-
- meta
|
|
40
|
+
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
41
|
+
packs: [meta]
|
|
44
42
|
---
|
|
45
43
|
|
|
46
44
|
# Domain Safety — Advisory Disclaimer
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Drafts
|
|
4
|
+
description: "Drafts/logs/exports with real customer/candidate data — redact direct IDs, placeholders, flag quasi-ID re-identification"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "support macro"
|
|
7
7
|
- keyword: "ticket response"
|
|
@@ -40,10 +40,8 @@ routes_to:
|
|
|
40
40
|
- "skill:secrets-management"
|
|
41
41
|
applies_to_user_types:
|
|
42
42
|
- "all"
|
|
43
|
-
workspaces:
|
|
44
|
-
|
|
45
|
-
packs:
|
|
46
|
-
- meta
|
|
43
|
+
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
44
|
+
packs: [meta]
|
|
47
45
|
---
|
|
48
46
|
|
|
49
47
|
# Domain Safety — PII Redaction
|
|
@@ -93,9 +91,10 @@ EVER REACHES THE LOG STREAM. ALLOWLISTED STRUCTURED FIELDS ONLY.
|
|
|
93
91
|
Required patterns:
|
|
94
92
|
|
|
95
93
|
1. **Allowlisted structured fields only.** Log `user_id`, `tenant_id`, `request_id`, `event_type` — never `user` or `request` blobs.
|
|
96
|
-
2. **
|
|
97
|
-
3. **
|
|
98
|
-
4. **No
|
|
94
|
+
2. **PII-exclusion-by-construction (preferred over redaction).** Make the log/event **type physically incapable** of holding free-form content — struct of allowlisted scalars, no `payload`/`body`/`extra: any`. A type that cannot carry a phone number has no scrubber to fail; redaction (next) is the fallback when a content field is unavoidable.
|
|
95
|
+
3. **Logger-level redaction.** Configure the logger to scrub `email`, `phone`, `name`, `address`, `token`, `password`, `card_number`, `iban` keys recursively from any payload.
|
|
96
|
+
4. **No raw exception payloads.** Exceptions captured by Sentry / Bugsnag must scrub the request body via the SDK's `before_send` hook.
|
|
97
|
+
5. **No log-and-forget for auth flows.** Login / password-reset / token-mint logs never include the credential itself, only the actor + outcome.
|
|
99
98
|
|
|
100
99
|
Refuse to write `logger.info("User logged in: $request->all()")` or `Log::info($user)` — show allowlisted version instead. Tokens + API keys + webhook secrets follow the same rule under `skill:secrets-management`.
|
|
101
100
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Data retention
|
|
4
|
+
description: "Data retention — jurisdiction gap, longest floor, honor DSR/audit holds; never delete under inquiry"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "retention policy"
|
|
7
7
|
- keyword: "data retention"
|
|
@@ -25,10 +25,8 @@ applies_to_user_types:
|
|
|
25
25
|
- "ops"
|
|
26
26
|
- "support"
|
|
27
27
|
- "gtm"
|
|
28
|
-
workspaces:
|
|
29
|
-
|
|
30
|
-
packs:
|
|
31
|
-
- meta
|
|
28
|
+
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
29
|
+
packs: [meta]
|
|
32
30
|
---
|
|
33
31
|
|
|
34
32
|
# Domain Safety — Data Retention
|
|
@@ -8,10 +8,9 @@ triggers:
|
|
|
8
8
|
- keyword: "callers"
|
|
9
9
|
- keyword: "imports"
|
|
10
10
|
- keyword: "downstream"
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
packs:
|
|
14
|
-
- engineering-base
|
|
11
|
+
- phrase: "api changed"
|
|
12
|
+
workspaces: [engineering]
|
|
13
|
+
packs: [engineering-base]
|
|
15
14
|
---
|
|
16
15
|
|
|
17
16
|
# Downstream Changes
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "
|
|
4
|
+
description: "Production/infra/security/external-system output — blast radius + rollback; Hard-Floor never autonomous"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "production"
|
|
7
7
|
- keyword: "deploy"
|
|
@@ -24,10 +24,8 @@ triggers:
|
|
|
24
24
|
routes_to:
|
|
25
25
|
- "skill:launch-readiness"
|
|
26
26
|
- "skill:threat-modeling"
|
|
27
|
-
workspaces:
|
|
28
|
-
|
|
29
|
-
packs:
|
|
30
|
-
- engineering-base
|
|
27
|
+
workspaces: [engineering]
|
|
28
|
+
packs: [engineering-base]
|
|
31
29
|
---
|
|
32
30
|
|
|
33
31
|
# Engineering Safety Floor
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2b"
|
|
4
|
-
description: "User names external repo/file/URL
|
|
4
|
+
description: "User names an external repo/file/URL as reference — fetch the actual tree and inspect; never summarize from README"
|
|
5
5
|
alwaysApply: false
|
|
6
6
|
triggers:
|
|
7
7
|
- intent: "look at how X does it"
|
|
@@ -14,10 +14,8 @@ triggers:
|
|
|
14
14
|
- keyword: "github.com/"
|
|
15
15
|
- keyword: "source of truth"
|
|
16
16
|
- phrase: "reference repo"
|
|
17
|
-
workspaces:
|
|
18
|
-
|
|
19
|
-
packs:
|
|
20
|
-
- meta
|
|
17
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
18
|
+
packs: [meta]
|
|
21
19
|
---
|
|
22
20
|
|
|
23
21
|
# external-reference-deep-dive
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "1"
|
|
4
|
-
description: "Low-impact council fast-path
|
|
4
|
+
description: "Low-impact council fast-path — surface the transparency marker verbatim as the reply opener"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "low-impact council"
|
|
7
7
|
- keyword: "fast-path"
|
|
@@ -12,10 +12,8 @@ validator_ignore:
|
|
|
12
12
|
- type: "substring"
|
|
13
13
|
pattern: ".agent-src.uncondensed/"
|
|
14
14
|
reason: "Condenseor injects a back-pointer to the uncondensed source for full failure-modes detail."
|
|
15
|
-
workspaces:
|
|
16
|
-
|
|
17
|
-
packs:
|
|
18
|
-
- meta
|
|
15
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
16
|
+
packs: [meta]
|
|
19
17
|
---
|
|
20
18
|
|
|
21
19
|
# Fast-Path Marker Visibility
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Finance-pack output (runway, valuation, DCF,
|
|
4
|
+
description: "Finance-pack output (runway, valuation, DCF, scenarios, unit economics) — never a final invest/raise call; disclosure footer"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "runway"
|
|
7
7
|
- keyword: "burn"
|
|
@@ -29,11 +29,8 @@ routes_to:
|
|
|
29
29
|
- "skill:scenario-modeling"
|
|
30
30
|
- "skill:unit-economics-modeling"
|
|
31
31
|
- "skill:forecasting"
|
|
32
|
-
workspaces:
|
|
33
|
-
|
|
34
|
-
packs:
|
|
35
|
-
- finance-basic
|
|
36
|
-
- finance-advanced
|
|
32
|
+
workspaces: [finance]
|
|
33
|
+
packs: [finance-basic, finance-advanced]
|
|
37
34
|
trust:
|
|
38
35
|
level: advisory
|
|
39
36
|
human_review_required: true
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Editing a generic skill/rule/command —
|
|
4
|
+
description: "Editing a generic skill/rule/command — no single-stack mandates; carve-out pointers instead"
|
|
5
5
|
triggers:
|
|
6
6
|
- path_prefix: ".agent-src.uncondensed/skills/"
|
|
7
7
|
- path_prefix: ".agent-src.uncondensed/rules/"
|
|
@@ -28,10 +28,8 @@ validator_ignore:
|
|
|
28
28
|
- type: "substring"
|
|
29
29
|
pattern: "scripts/lint_framework_leakage"
|
|
30
30
|
reason: "Rule cites the enforcing linter script by name in body and enforcement section."
|
|
31
|
-
workspaces:
|
|
32
|
-
|
|
33
|
-
packs:
|
|
34
|
-
- meta
|
|
31
|
+
workspaces: [agent-config-maintainer]
|
|
32
|
+
packs: [meta]
|
|
35
33
|
---
|
|
36
34
|
|
|
37
35
|
# framework-neutrality-in-generic-skills
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
4
|
alwaysApply: false
|
|
5
|
-
description: "Git history
|
|
5
|
+
description: "Git history — no unasked rebase/squash/amend; never drop foreign commits; pushed rewrite → re-push same turn"
|
|
6
6
|
triggers:
|
|
7
7
|
- intent: "rebase the branch"
|
|
8
8
|
- intent: "squash commits"
|
|
@@ -26,10 +26,8 @@ triggers:
|
|
|
26
26
|
- phrase: "commits I did not create"
|
|
27
27
|
routes_to:
|
|
28
28
|
- "skill:git-workflow"
|
|
29
|
-
workspaces:
|
|
30
|
-
|
|
31
|
-
packs:
|
|
32
|
-
- engineering-base
|
|
29
|
+
workspaces: [engineering]
|
|
30
|
+
packs: [engineering-base]
|
|
33
31
|
---
|
|
34
32
|
|
|
35
33
|
# Git History Discipline
|
|
@@ -9,10 +9,8 @@ triggers:
|
|
|
9
9
|
- intent: "writing code"
|
|
10
10
|
- intent: "reviewing code"
|
|
11
11
|
- keyword: "convention"
|
|
12
|
-
workspaces:
|
|
13
|
-
|
|
14
|
-
packs:
|
|
15
|
-
- meta
|
|
12
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
13
|
+
packs: [meta]
|
|
16
14
|
---
|
|
17
15
|
|
|
18
16
|
# Guidelines
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "One icon system per project unless the brand
|
|
4
|
+
description: "One icon system per project unless the brand says otherwise — flag mixed icon sets (default-Lucide anti-pattern)"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "icon"
|
|
7
7
|
- keyword: "iconography"
|
|
@@ -13,10 +13,8 @@ applies_to_user_types:
|
|
|
13
13
|
- "creator"
|
|
14
14
|
- "developer"
|
|
15
15
|
- "maintainer"
|
|
16
|
-
workspaces:
|
|
17
|
-
|
|
18
|
-
packs:
|
|
19
|
-
- frontend-design
|
|
16
|
+
workspaces: [engineering]
|
|
17
|
+
packs: [frontend-design]
|
|
20
18
|
---
|
|
21
19
|
|
|
22
20
|
# Icon Consistency
|
|
@@ -49,5 +47,6 @@ Any of the trigger keywords appear in a UI-building context: new component, new
|
|
|
49
47
|
|
|
50
48
|
## See also
|
|
51
49
|
|
|
50
|
+
- [`design-canon.md`](../docs/guidelines/design-canon.md) § Icon systems — when a named design system is in play, prefer its icon set over a fresh Iconify pick.
|
|
52
51
|
- [`iconography`](../skills/iconography/SKILL.md) — full icon-system selection, audit, and migration workflow.
|
|
53
52
|
- [`ui-audit-gate`](ui-audit-gate.md) — broader UI consistency gate; runs before any new component lands.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "
|
|
4
|
+
description: "AI image rights gate — real-person likeness, trademarked marks, named artists' styles need explicit rights/consent"
|
|
5
5
|
triggers:
|
|
6
6
|
- keyword: "/image:"
|
|
7
7
|
- keyword: "image generation"
|
|
@@ -15,10 +15,8 @@ applies_to_user_types:
|
|
|
15
15
|
- "creator"
|
|
16
16
|
- "developer"
|
|
17
17
|
- "maintainer"
|
|
18
|
-
workspaces:
|
|
19
|
-
|
|
20
|
-
packs:
|
|
21
|
-
- meta
|
|
18
|
+
workspaces: [agent-config-maintainer, engineering, gtm]
|
|
19
|
+
packs: [ai-image]
|
|
22
20
|
---
|
|
23
21
|
|
|
24
22
|
# Image Likeness and Rights
|
|
@@ -1,21 +1,21 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2b"
|
|
4
|
-
description: "Before
|
|
4
|
+
description: "Before features or architectural changes — validate against existing code, challenge weak requirements"
|
|
5
5
|
alwaysApply: false
|
|
6
6
|
council_depth: deep
|
|
7
7
|
triggers:
|
|
8
8
|
- intent: "implement feature"
|
|
9
9
|
- intent: "architectural change"
|
|
10
10
|
- keyword: "refactor"
|
|
11
|
+
- keyword: "implement"
|
|
12
|
+
- keyword: "migration"
|
|
11
13
|
validator_ignore:
|
|
12
14
|
- type: "substring"
|
|
13
15
|
pattern: ".agent-src.uncondensed/"
|
|
14
16
|
reason: "Rule cites the authoring tree when describing where examples live."
|
|
15
|
-
workspaces:
|
|
16
|
-
|
|
17
|
-
packs:
|
|
18
|
-
- engineering-base
|
|
17
|
+
workspaces: [engineering]
|
|
18
|
+
packs: [engineering-base]
|
|
19
19
|
---
|
|
20
20
|
|
|
21
21
|
# Improve Before Implement
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2b"
|
|
4
|
-
description: "Before executing a complex plan
|
|
4
|
+
description: "Before executing a complex plan — ask 'am I solving the right problem?' and pause for confirmation"
|
|
5
5
|
alwaysApply: false
|
|
6
6
|
council_depth: deep
|
|
7
7
|
triggers:
|
|
@@ -13,10 +13,8 @@ triggers:
|
|
|
13
13
|
- keyword: "design"
|
|
14
14
|
- keyword: "architecture"
|
|
15
15
|
- keyword: "approach"
|
|
16
|
-
workspaces:
|
|
17
|
-
|
|
18
|
-
packs:
|
|
19
|
-
- meta
|
|
16
|
+
workspaces: [agent-config-maintainer, engineering]
|
|
17
|
+
packs: [meta]
|
|
20
18
|
---
|
|
21
19
|
|
|
22
20
|
# invite-challenge
|
|
@@ -7,10 +7,8 @@ validator_ignore:
|
|
|
7
7
|
- type: "substring"
|
|
8
8
|
pattern: ".agent-src.uncondensed/"
|
|
9
9
|
reason: "Rule scopes the .md-English mandate to the authoring tree."
|
|
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
|
# Language and Tone
|
|
@@ -27,31 +25,31 @@ NO "SWITCH MID-PARAGRAPH". NO "LAST 20 TURNS WERE ENGLISH".
|
|
|
27
25
|
NO "INTER-TOOL COMMENT IS JUST A NOTE" EXCEPTION.
|
|
28
26
|
```
|
|
29
27
|
|
|
30
|
-
Trigger = user's last **chat message
|
|
28
|
+
Trigger = user's last **chat message** — never turn count, open file, roadmap, ticket, codebase, tool output, prior reply, or just-edited files. Short German (`3`, `weiter`, `mach das`) after many English turns → reply in German.
|
|
31
29
|
|
|
32
30
|
## User-visible prose — every token mirrors
|
|
33
31
|
|
|
34
|
-
|
|
32
|
+
Mirrors: opening/closing line, **inter-tool commentary** (`Found it`, `Let me check`, `OK`, `Alright`, `Here's`, `So`), headings, table headers + cells, bullets, blockquotes, status lines, the `Recommendation:` / `Empfehlung:` label under numbered-options blocks ([`user-interaction`](user-interaction.md) Iron Law 1). Wrong label = violation.
|
|
35
33
|
|
|
36
|
-
Stays
|
|
34
|
+
Stays source-language: code blocks, command output, file contents, quoted tool output, frontmatter keys, file paths, identifiers, log lines.
|
|
37
35
|
|
|
38
36
|
## Pre-send gate — MANDATORY
|
|
39
37
|
|
|
40
|
-
1. **Detect** — language of
|
|
41
|
-
2. **Scan** — every user-visible token per catalog
|
|
42
|
-
3. **Rewrite** — wrong-language token → rewrite
|
|
43
|
-
4. **Confirm** — first sentence in target language; recommendation label matches; no wrong-language filler
|
|
38
|
+
1. **Detect** — language of last chat message. Mixed → dominant; tie → German.
|
|
39
|
+
2. **Scan** — every user-visible token per catalog.
|
|
40
|
+
3. **Rewrite** — one wrong-language token → rewrite whole reply.
|
|
41
|
+
4. **Confirm** — first sentence in target language; recommendation label matches; no wrong-language filler opener. Blocklist: [`language-and-tone-examples`](../docs/guidelines/agent-infra/language-and-tone-examples.md).
|
|
44
42
|
|
|
45
43
|
## Spelled out
|
|
46
44
|
|
|
47
45
|
- German → informal "Du" (never "Sie"); capitalized at sentence start, lowercase otherwise.
|
|
48
|
-
- Code blocks / command output / file contents / quoted tool output stay native;
|
|
46
|
+
- Code blocks / command output / file contents / quoted tool output stay native; surrounding prose mirrors.
|
|
49
47
|
- Numbered options — `.md` source English; rendered reply translated at runtime.
|
|
50
|
-
- Code comments
|
|
48
|
+
- Code comments English. `.md` files English (below). Translate existing German `.md` files when touched.
|
|
51
49
|
|
|
52
50
|
## Slip handling
|
|
53
51
|
|
|
54
|
-
Acknowledge **once
|
|
52
|
+
Acknowledge **once**, correct language ("Entschuldigung" / "Sorry"), switch in the same reply. No wrong-language re-explain; no "from now on" promise.
|
|
55
53
|
|
|
56
54
|
Examples + CLI spacing rules + wrong-vs-correct: [`language-and-tone-examples`](../docs/guidelines/agent-infra/language-and-tone-examples.md).
|
|
57
55
|
|
|
@@ -59,6 +57,6 @@ Examples + CLI spacing rules + wrong-vs-correct: [`language-and-tone-examples`](
|
|
|
59
57
|
|
|
60
58
|
All `.md` text under `src/`, `docs/`, `.augment/`, `dist/agent-src/`, `.agent-src.uncondensed/`, `agents/` — prose AND examples, **including generated output** (fix the generator's source strings, never hand-edit the generated page). Agent translates at runtime.
|
|
61
59
|
|
|
62
|
-
Genuinely-required German
|
|
60
|
+
Genuinely-required German → one of the two sanctioned escapes (labeled `DE: … · EN: …` anchor, or per-line `<!-- md-language-check: ignore -->` marker) — canonical mechanics in the guideline below.
|
|
63
61
|
|
|
64
62
|
Generated-output rule, escape mechanics, pre-save detection heuristic: [`language-and-tone-examples`](../docs/guidelines/agent-infra/language-and-tone-examples.md).
|
|
@@ -9,10 +9,8 @@ triggers:
|
|
|
9
9
|
- keyword: "FormRequest"
|
|
10
10
|
routes_to:
|
|
11
11
|
- "skill:laravel"
|
|
12
|
-
workspaces:
|
|
13
|
-
|
|
14
|
-
packs:
|
|
15
|
-
- laravel
|
|
12
|
+
workspaces: [engineering]
|
|
13
|
+
packs: [laravel]
|
|
16
14
|
trust:
|
|
17
15
|
level: professional
|
|
18
16
|
install:
|
|
@@ -25,4 +23,4 @@ install:
|
|
|
25
23
|
**Iron Law.** Laravel-flavoured PHP (Eloquent, Artisan, FormRequest, jobs, events, policies) → load the `laravel` skill, not `symfony-workflow` and not `php-coder`.
|
|
26
24
|
|
|
27
25
|
Body migrated to `skill:laravel`. Disambiguates the laravel ↔ symfony-workflow cluster head per [`adr-architectural-consensus-mechanism`](../docs/contracts/adr-architectural-consensus-mechanism.md).
|
|
28
|
-
Trigger-set above activates this routing
|
|
26
|
+
Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
|