@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
|
@@ -1,18 +1,15 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: root-cause-frameworks
|
|
3
3
|
description: "Use when tracing the root cause of a resolved incident or recurring bug — 5-whys chain, fishbone categorisation, contributing-factors split — even if the user says 'why does this keep breaking?'."
|
|
4
|
-
source: package
|
|
5
4
|
domain: quality
|
|
6
5
|
model_tier: high
|
|
7
6
|
workspaces:
|
|
8
7
|
- engineering
|
|
9
8
|
packs:
|
|
10
9
|
- analysis-workbench
|
|
11
|
-
lifecycle: active
|
|
12
10
|
trust:
|
|
13
11
|
level: professional
|
|
14
12
|
confidence: medium
|
|
15
|
-
human_review_required: false
|
|
16
13
|
install:
|
|
17
14
|
default: false
|
|
18
15
|
removable: true
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
model_tier: medium
|
|
3
3
|
name: script-writing
|
|
4
|
-
description: "Use when adding or editing any script under `scripts/` — `--quiet
|
|
4
|
+
description: "Use when adding or editing any script under `scripts/` — `--quiet`, `_lib/script_output`, silent Taskfile wiring, Iron-Law carve-outs; fires on 'add a check script for X'."
|
|
5
5
|
domain: process
|
|
6
6
|
workspaces:
|
|
7
7
|
- agent-config-maintainer
|
|
@@ -116,6 +116,10 @@ After creation:
|
|
|
116
116
|
2. Copy to `.augment/`
|
|
117
117
|
3. Mark hash: `./scripts-run src/scripts/condense --mark-done "{relative_path}"`
|
|
118
118
|
4. Regenerate tools: `./scripts-run src/scripts/condense --generate-tools`
|
|
119
|
+
5. **If from a knowledge page** (`agents/knowledge/procedures/skill-candidates.md`
|
|
120
|
+
or any `agents/knowledge/` page) — degrade the source to a pointer;
|
|
121
|
+
promotion isn't complete otherwise (double-maintenance risk):
|
|
122
|
+
`./scripts-run src/scripts/degrade_to_pointer --source "<knowledge-path>[#<anchor>]" --artifact "{relative_path}" --date "<YYYY-MM-DD>"`
|
|
119
123
|
|
|
120
124
|
### Step 5: Decide scope
|
|
121
125
|
|
|
@@ -38,9 +38,9 @@ discover the real source → Evidence Report (Verified / Assumed / Gaps) →
|
|
|
38
38
|
Scaffold the report cheaply so it never gets skipped:
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
41
|
+
./scripts-run src/scripts/evidence_report git-state # fail-fast: abort if a rebase/merge/cherry-pick is in progress
|
|
42
|
+
./scripts-run src/scripts/evidence_report init --task "<task>" # writes the gitignored session report
|
|
43
|
+
./scripts-run src/scripts/evidence_report add --bucket verified --claim "users.email is unique" --source "db/schema/users.sql:23"
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
**Provenance on every item** (`observed_at` / `source` / `version`). Within a
|
|
@@ -165,6 +165,25 @@ signal, never silently commit); trust and commit are always human-gated. Full mo
|
|
|
165
165
|
the three classes + memory tiers:
|
|
166
166
|
[`project-intelligence`](../../agent-src/contexts/execution/project-intelligence.md).
|
|
167
167
|
|
|
168
|
+
## Knowledge capture (`api_shape_learned` / `convention_detected` events)
|
|
169
|
+
|
|
170
|
+
A confirmed API/GraphQL shape (§B) or an observed coding convention with
|
|
171
|
+
≥ 2 supporting locations is worth persisting for the team, distinct
|
|
172
|
+
from the per-session Evidence Report above. Append to the knowledge
|
|
173
|
+
intake — never write a tracked page mid-task:
|
|
174
|
+
|
|
175
|
+
```bash
|
|
176
|
+
./scripts-run src/scripts/emit_knowledge_event --type api_shape_learned \
|
|
177
|
+
--endpoint "<path>" --method "<verb>" --request-schema '<json>' --response-schema '<json>'
|
|
178
|
+
|
|
179
|
+
./scripts-run src/scripts/emit_knowledge_event --type convention_detected \
|
|
180
|
+
--pattern "<pattern>" --evidence "file:line" --sample-size <N> --scope project
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
`/team-knowledge consolidate` turns accumulated events into
|
|
184
|
+
`agents/knowledge/concepts/` pages as a reviewed batch — see
|
|
185
|
+
[`knowledge-pages`](../../templates/contexts/knowledge-pages.md).
|
|
186
|
+
|
|
168
187
|
## Gotchas
|
|
169
188
|
|
|
170
189
|
- A card's positive structure is **never** "Verified" on the card alone — it is
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
model_tier: medium
|
|
3
3
|
name: sql-writing
|
|
4
|
-
description: "Use when writing raw SQL — MariaDB/MySQL syntax, parameterization, raw migrations, seeders with `DB::statement
|
|
4
|
+
description: "Use when writing raw SQL — MariaDB/MySQL syntax, parameterization, raw migrations, seeders with `DB::statement`; fires even on a pasted query asking 'why is this slow'."
|
|
5
5
|
domain: engineering
|
|
6
6
|
workspaces:
|
|
7
7
|
- engineering
|
|
@@ -307,22 +307,41 @@ prefer the cheaper one (`do-and-judge` < `do-and-judge-two-stage` <
|
|
|
307
307
|
|
|
308
308
|
### 4. Dispatch
|
|
309
309
|
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
* `do-
|
|
314
|
-
* `judge`
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
`do-competitively
|
|
318
|
-
|
|
319
|
-
|
|
310
|
+
Use the matching dispatch prompt and orchestrate inline via this skill.
|
|
311
|
+
Describe each dispatch step explicitly in chat so the user can follow it.
|
|
312
|
+
|
|
313
|
+
* `do-and-judge` → [`prompts/do-and-judge.md`](prompts/do-and-judge.md)
|
|
314
|
+
* `do-and-judge-two-stage` → [`prompts/do-and-judge-two-stage.md`](prompts/do-and-judge-two-stage.md)
|
|
315
|
+
* `do-in-steps` → [`prompts/do-in-steps.md`](prompts/do-in-steps.md)
|
|
316
|
+
* `do-in-parallel` → [`prompts/do-in-parallel.md`](prompts/do-in-parallel.md)
|
|
317
|
+
* `do-competitively` → [`prompts/do-competitively.md`](prompts/do-competitively.md)
|
|
318
|
+
* `judge-with-debate` → [`prompts/judge-with-debate.md`](prompts/judge-with-debate.md)
|
|
319
|
+
* `do-in-worktrees` → [`prompts/do-in-worktrees.md`](prompts/do-in-worktrees.md)
|
|
320
|
+
* Standalone judge → judge prompt in [`prompts/do-and-judge.md`](prompts/do-and-judge.md)
|
|
320
321
|
|
|
321
322
|
### 5. Report
|
|
322
323
|
|
|
323
324
|
Follow the output format below. Never merge a diff without reporting
|
|
324
325
|
the judge verdict.
|
|
325
326
|
|
|
327
|
+
### 6. Emit telemetry
|
|
328
|
+
|
|
329
|
+
After every auto-dispatched run, write one telemetry line to
|
|
330
|
+
`agents/runtime/state/audit/YYYY-MM.jsonl` (current UTC month — use
|
|
331
|
+
`new Date().toISOString().slice(0, 7)` for the filename). Standard
|
|
332
|
+
audit-log-v1 object with `input_kind: "orchestration"` and an
|
|
333
|
+
`orchestration` sub-object per
|
|
334
|
+
[`orchestration-telemetry.md`](../../agent-src/contexts/execution/orchestration-telemetry.md).
|
|
335
|
+
|
|
336
|
+
Minimal emit (fill what is observable; `token_delta_provenance: "estimated"` if
|
|
337
|
+
host usage metadata is unavailable):
|
|
338
|
+
|
|
339
|
+
```json
|
|
340
|
+
{"schema_version":1,"id":"<ulid>","ts":"<iso>","work_id":"<work_id>","phase":"implement","outcome":"success","confidence_band":"high","risk_class":"low","input_kind":"orchestration","type":"phase","orchestration":{"task_size_estimate":<int>,"spawn_count":<int>,"tiers":[...],"token_delta":<int>,"token_delta_provenance":"estimated","wall_clock_ms":<int>,"outcome":"DONE","verify_mode":"deterministic"}}
|
|
341
|
+
```
|
|
342
|
+
|
|
343
|
+
Skip emit when `subagents.enabled: false` or `spawn_count == 0` (in-session run).
|
|
344
|
+
|
|
326
345
|
## Gotcha
|
|
327
346
|
|
|
328
347
|
* **Identical model both sides** — same blind spots. The Iron Law
|
|
@@ -358,10 +377,10 @@ the judge verdict.
|
|
|
358
377
|
|
|
359
378
|
| Task | Skill / command |
|
|
360
379
|
|--------------------------------------|--------------------------------------|
|
|
361
|
-
| Configuration reference | [`subagent-configuration`](../../contexts/subagent-configuration.md) |
|
|
362
|
-
| Do-and-judge loop | [
|
|
363
|
-
| Stepwise plan with judge gates | [
|
|
364
|
-
| Standalone judge on an existing diff | [
|
|
380
|
+
| Configuration reference | [`subagent-configuration`](../../agent-src/contexts/execution/subagent-configuration.md) |
|
|
381
|
+
| Do-and-judge loop | Inline — see [`prompts/do-and-judge.md`](prompts/do-and-judge.md) |
|
|
382
|
+
| Stepwise plan with judge gates | Inline — see [`prompts/do-in-steps.md`](prompts/do-in-steps.md) |
|
|
383
|
+
| Standalone judge on an existing diff | Inline — see judge prompt in [`prompts/do-and-judge.md`](prompts/do-and-judge.md) |
|
|
365
384
|
| External / networked second opinion | [`ai-council`](../ai-council/SKILL.md) |
|
|
366
385
|
| Verifying completeness | [`verify-before-complete`](../verify-before-complete/SKILL.md) |
|
|
367
386
|
| What a subagent owns vs never owns | [`subagent-boundary`](../../../docs/contracts/subagent-boundary.md) |
|
|
@@ -22,6 +22,17 @@ Every prompt cites the status taxonomy in
|
|
|
22
22
|
ends with the **return-envelope** instruction so the subagent's reply
|
|
23
23
|
validates against `tests/test_subagent_status_schema.py`.
|
|
24
24
|
|
|
25
|
+
## Prompt-cache discipline
|
|
26
|
+
|
|
27
|
+
When dispatching sibling subagents (e.g. `do-in-parallel` with N independent
|
|
28
|
+
slices), **reuse a stable system-prompt prefix** across all siblings. Keep
|
|
29
|
+
task-invariant text (role declaration, constraints, status enum, return-envelope
|
|
30
|
+
instruction) in the prefix; put only the slice-specific `TASK:` and
|
|
31
|
+
`CONTEXT FILES:` in the variable section. This maximises host-side prompt-cache
|
|
32
|
+
hits (Anthropic `cache_control: ephemeral`) across the cohort — the prefix is
|
|
33
|
+
cached after the first sibling and served from cache for the rest, cutting
|
|
34
|
+
input-token cost proportionally to cohort size.
|
|
35
|
+
|
|
25
36
|
## Loading
|
|
26
37
|
|
|
27
38
|
`tests/test_subagent_prompt_loading.py` asserts that every mode named
|
|
@@ -60,3 +60,11 @@ already mitigated, DONE. Otherwise DONE_WITH_CONCERNS.
|
|
|
60
60
|
A step that returns BLOCKED stops the chain. The orchestrator does not
|
|
61
61
|
"jump ahead" or re-order — it surfaces the BLOCKED envelope to the user
|
|
62
62
|
and waits.
|
|
63
|
+
|
|
64
|
+
## Dependency gate
|
|
65
|
+
|
|
66
|
+
Every step after the first declares its parent (the preceding step). A
|
|
67
|
+
step MUST NOT dispatch before its parent's return passed the judge —
|
|
68
|
+
deterministic reference: `sliceDispatchAllowed()` in
|
|
69
|
+
`src/scripts/_lib/subagent_steering.ts`, contract in
|
|
70
|
+
[`subagent-steering § Ordered-slice dependency gate`](../../../contexts/execution/subagent-steering.md).
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
model_tier: high
|
|
3
3
|
name: systematic-debugging
|
|
4
|
-
description: "Use
|
|
4
|
+
description: "Use on a bug, test failure, crash, or unexpected behavior — enforce reproduce → isolate → hypothesize → verify before any fix; fires even on 'this is broken' / 'quick fix'."
|
|
5
5
|
domain: discovery
|
|
6
6
|
council_depth: deep
|
|
7
7
|
workspaces:
|
|
@@ -258,6 +258,35 @@ When reporting debug findings to the user:
|
|
|
258
258
|
5. **Fix** — the minimal change
|
|
259
259
|
6. **Regression test** — the test that catches this bug returning
|
|
260
260
|
|
|
261
|
+
## Knowledge capture (`mistake_made` event)
|
|
262
|
+
|
|
263
|
+
Root cause traces to a `agents/knowledge/` page followed while
|
|
264
|
+
implementing (documented convention wrong, API-shape page stale,
|
|
265
|
+
procedure incomplete) → append a `mistake_made` event to the
|
|
266
|
+
knowledge intake — never rewrite the page mid-task (see
|
|
267
|
+
[`knowledge-pages`](../../templates/contexts/knowledge-pages.md)):
|
|
268
|
+
|
|
269
|
+
```bash
|
|
270
|
+
./scripts-run src/scripts/emit_knowledge_event \
|
|
271
|
+
--type mistake_made \
|
|
272
|
+
--error-category "<one or two words>" \
|
|
273
|
+
--context-source "<agents/knowledge/... path, or 'null' if no page was followed>" \
|
|
274
|
+
--correction "<what the fix actually was>" \
|
|
275
|
+
--recurrence-key "<stable slug for this class of mistake>"
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
Verify the append landed: check the command's exit code (0 =
|
|
279
|
+
appended), then `grep <recurrenceKey> agents/knowledge/intake/events-*.jsonl`
|
|
280
|
+
finds the new line.
|
|
281
|
+
|
|
282
|
+
**Live contradiction exception.** Followed page DEMONSTRABLY wrong
|
|
283
|
+
right now (observed ≠ documented, not a one-off) → hybrid immediate-fix
|
|
284
|
+
case instead — surface the correction, ask before continuing (see
|
|
285
|
+
[`knowledge-pages`](../../templates/contexts/knowledge-pages.md) §
|
|
286
|
+
Contested entries). Approved → isolated fix commit. Declined →
|
|
287
|
+
`./scripts-run src/scripts/append_contested` on that page, then still
|
|
288
|
+
emit the `context_stale` event above for the consolidation pass.
|
|
289
|
+
|
|
261
290
|
## Gotchas
|
|
262
291
|
|
|
263
292
|
* Reading half a stack trace and jumping to a fix — the actual cause is
|
|
@@ -152,6 +152,10 @@ Risks: <arbitrary values, !important, dark-mode gaps>
|
|
|
152
152
|
flow) when the brief allows; cite the design brief's `aesthetic:`
|
|
153
153
|
line if `fe-design`'s aesthetic-direction section produced one.
|
|
154
154
|
|
|
155
|
+
## Taste Dials
|
|
156
|
+
|
|
157
|
+
`DESIGN.md` `## Taste Dials` → honour: Variance → layout-family spread + asymmetry; Motion → animation budget + reduced-motion posture; Density → spacing scale + info-per-viewport. Absent → follow brief's inferred dials.
|
|
158
|
+
|
|
155
159
|
## Do NOT
|
|
156
160
|
|
|
157
161
|
- Do NOT add `!important` to win a specificity fight; restructure
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
model_tier: medium
|
|
3
3
|
name: testing-anti-patterns
|
|
4
|
-
description: "Use BEFORE writing
|
|
4
|
+
description: "Use BEFORE writing/changing tests, adding mocks, or test-only methods on production classes — Iron Laws against mocking-the-mock, production pollution, silent partial mocks."
|
|
5
5
|
domain: quality
|
|
6
6
|
workspaces:
|
|
7
7
|
- engineering
|
|
@@ -16,8 +16,8 @@ packs:
|
|
|
16
16
|
|
|
17
17
|
|
|
18
18
|
> **Grounded corpus (Tier-1 consultation):** ground surface → threats →
|
|
19
|
-
> controls before enumerating from memory —
|
|
20
|
-
> <skills-root>/corpus-grounding/scripts/ground
|
|
19
|
+
> controls before enumerating from memory — `./scripts-run
|
|
20
|
+
> <skills-root>/corpus-grounding/scripts/ground ground --manifest
|
|
21
21
|
> <skills-root>/threat-modeling/data/manifest.json "<surface description>"`
|
|
22
22
|
> returns surface class, ATT&CK/CWE-cited threats, required controls, and
|
|
23
23
|
> negative tests, with confidence + evidence-gap. Propose grounded
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
model_tier: medium
|
|
3
3
|
name: token-optimizer
|
|
4
|
-
description: "Use BEFORE any verbose CLI run, large file read, doc conversion, or near-context handoff —
|
|
4
|
+
description: "Use BEFORE any verbose CLI run, large file read, doc conversion, or near-context handoff — decision tree keyed by intent citing the canonical token-saving asset."
|
|
5
5
|
domain: process
|
|
6
6
|
execution:
|
|
7
7
|
type: assisted
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
model_tier: inherit
|
|
3
3
|
name: typography-system
|
|
4
|
-
description: "Derive a type system from a style constraint —
|
|
4
|
+
description: "Derive a type system from a style constraint — font pairings, scale/line-height/weights, DTCG tokens via design-tokens. Use to choose fonts or build a typographic scale."
|
|
5
5
|
domain: product
|
|
6
6
|
personas: []
|
|
7
7
|
workspaces:
|
|
@@ -54,7 +54,7 @@ degrades gracefully: with no brand layer, only stage 1 runs.
|
|
|
54
54
|
`fontSize`, `fontWeight`, `lineHeight`.
|
|
55
55
|
5. **Verify** — confirm both chosen fonts exist on Google Fonts (check the
|
|
56
56
|
`Google Fonts URL` column in the CSV); run
|
|
57
|
-
|
|
57
|
+
`./scripts-run <skills-root>/design-tokens/scripts/tokens validate --dir src/`
|
|
58
58
|
to confirm no hardcoded font-size or font-family values remain outside the
|
|
59
59
|
token file; exit code 0 is the evidence.
|
|
60
60
|
|
|
@@ -72,7 +72,7 @@ style, not the other way around.
|
|
|
72
72
|
evidence gap):
|
|
73
73
|
|
|
74
74
|
```bash
|
|
75
|
-
|
|
75
|
+
./scripts-run <skills-root>/corpus-grounding/scripts/ground search \
|
|
76
76
|
--manifest <skills-root>/brand/data/manifest.json \
|
|
77
77
|
"<archetype + sector>" --domain typography --json
|
|
78
78
|
```
|
|
@@ -127,6 +127,7 @@ brand already registers fonts, use them and skip the filter.
|
|
|
127
127
|
|
|
128
128
|
## See also
|
|
129
129
|
|
|
130
|
+
- [`design-canon.md`](../../../docs/guidelines/design-canon.md) — named-systems + typography-craft (foundry/theory) grounding index; pull to escape the AI-default fonts.
|
|
130
131
|
- [`design-tokens`](../design-tokens/SKILL.md) — toolchain that generates CSS
|
|
131
132
|
vars and the Tailwind snippet from `tokens.json`.
|
|
132
133
|
- [`design-intelligence`](../design-intelligence/SKILL.md) — idiom corpus that
|
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
model_tier: medium
|
|
3
3
|
name: verify-completion-evidence
|
|
4
4
|
description: "Use when claiming 'done', suggesting a commit, push, or PR — runs the evidence gate so completion claims come from fresh output in this message, not memory or earlier runs."
|
|
5
|
+
personas:
|
|
6
|
+
- production-validator
|
|
5
7
|
domain: quality
|
|
6
8
|
workspaces:
|
|
7
9
|
- engineering
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
---
|
|
2
|
+
model_tier: inherit
|
|
3
|
+
name: wireframe
|
|
4
|
+
description: "Explore a flow or layout with 3+ disposable lo-fi greyscale wireframes on a named axis, before any hi-fi work. Use when the user wants to sketch directions or explore structure."
|
|
5
|
+
domain: product
|
|
6
|
+
personas: []
|
|
7
|
+
workspaces:
|
|
8
|
+
- engineering
|
|
9
|
+
packs:
|
|
10
|
+
- frontend-design
|
|
11
|
+
trust:
|
|
12
|
+
level: professional
|
|
13
|
+
install:
|
|
14
|
+
removable: true
|
|
15
|
+
execution:
|
|
16
|
+
type: manual
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# Wireframe
|
|
20
|
+
|
|
21
|
+
Produce low-fidelity wireframes or storyboards to explore a flow, layout, or
|
|
22
|
+
information hierarchy before committing to hi-fi design. Wireframes are
|
|
23
|
+
**disposable** — their value is the breadth of options and the decision they
|
|
24
|
+
produce, not the fidelity of any one artifact.
|
|
25
|
+
|
|
26
|
+
## When to use
|
|
27
|
+
|
|
28
|
+
- The user wants to "explore options", "sketch something out", "see a few
|
|
29
|
+
directions" for a screen, flow, navigation pattern, or hierarchy.
|
|
30
|
+
- The design problem is open enough that hi-fi work would be wasted — the
|
|
31
|
+
structure question is not yet settled.
|
|
32
|
+
|
|
33
|
+
**When NOT to use:** styled, production-viable alternatives on a settled
|
|
34
|
+
structure → [`design-variations`](../design-variations/SKILL.md) (hi-fi,
|
|
35
|
+
branded, recommendation-bearing). A single refined implementation →
|
|
36
|
+
[`fe-design`](../fe-design/SKILL.md) + stack executor.
|
|
37
|
+
|
|
38
|
+
## Procedure
|
|
39
|
+
|
|
40
|
+
1. **Confirm the goal.** What is explored (screen / multi-screen flow /
|
|
41
|
+
navigation / hierarchy / interaction model), the imagined user's goal,
|
|
42
|
+
constraints (mobile/desktop, non-negotiable elements), the count
|
|
43
|
+
(3 minimum, 5–6 ceiling), and the **axis of variation**. If the axis is
|
|
44
|
+
open, propose 2–3 (e.g. single-page form vs multi-step wizard vs
|
|
45
|
+
progressive disclosure) and ask which to explore.
|
|
46
|
+
2. **Hold the lo-fi conventions** so the output reads as wireframe, not as
|
|
47
|
+
broken hi-fi:
|
|
48
|
+
- greyscale only — black, white, 2–3 grays; no brand color;
|
|
49
|
+
- system sans-serif — no type personality yet;
|
|
50
|
+
- labeled boxes for content areas ("headline", "image", "feature card");
|
|
51
|
+
- striped placeholders with monospace size labels for imagery (the
|
|
52
|
+
honest-placeholder pattern in
|
|
53
|
+
[`fe-design § Craft details`](../fe-design/SKILL.md));
|
|
54
|
+
- short label-style skeleton copy ("Headline goes here / one sentence on
|
|
55
|
+
the value prop") — never Lorem ipsum (per `output-discipline`), never
|
|
56
|
+
final copy.
|
|
57
|
+
3. **Sketch ≥3 variations** on the named axis — layout (centered / split /
|
|
58
|
+
grid), information density, flow structure (single page / multi-step /
|
|
59
|
+
progressive disclosure), CTA placement, navigation pattern. Write each
|
|
60
|
+
variation's distinguishing structure down BEFORE sketching it — left
|
|
61
|
+
unspecified, variations converge on near-identical layouts. Order
|
|
62
|
+
by-the-book → off-distribution; at least one genuinely novel bet.
|
|
63
|
+
4. **Annotate** — 2–4 numbered callouts per variation naming what is
|
|
64
|
+
interesting and its trade-off ("fastest path, but heavy first
|
|
65
|
+
impression"), placed next to the variation, not in a separate doc.
|
|
66
|
+
5. **Capture the decision** after the user picks: chosen variation (or
|
|
67
|
+
hybrid), what attracted them, what they explicitly rejected, new
|
|
68
|
+
constraints surfaced. This capture is the brief for the hi-fi follow-up.
|
|
69
|
+
6. **Hand off** — [`design-variations`](../design-variations/SKILL.md) for
|
|
70
|
+
styled options on the chosen structure, or
|
|
71
|
+
[`design-intelligence`](../design-intelligence/SKILL.md) +
|
|
72
|
+
[`fe-design`](../fe-design/SKILL.md) for a single hi-fi direction. In an
|
|
73
|
+
existing codebase the hi-fi step still passes `existing-ui-audit` per the
|
|
74
|
+
`ui-audit-gate` rule.
|
|
75
|
+
|
|
76
|
+
## Output format
|
|
77
|
+
|
|
78
|
+
1. **One file** (HTML or annotated markdown/SVG canvas) with ≥3 greyscale
|
|
79
|
+
variations side-by-side — flows as small storyboards (3–5 screens each);
|
|
80
|
+
no brand color, no styled typography, no real imagery.
|
|
81
|
+
2. **Per-variation annotations** — 2–4 callouts naming the structural bet and
|
|
82
|
+
its trade-off, inline next to the variation.
|
|
83
|
+
3. **Decision-capture block** (after user pick) — chosen direction,
|
|
84
|
+
attractions, explicit rejections, new constraints; framed as the hi-fi
|
|
85
|
+
brief.
|
|
86
|
+
4. **No recommendation ranking** — wireframes surface trade-offs; the pick
|
|
87
|
+
belongs to the user (contrast: `design-variations` closes with a
|
|
88
|
+
recommendation).
|
|
89
|
+
|
|
90
|
+
## Do NOT
|
|
91
|
+
|
|
92
|
+
- Do NOT apply brand color, brand type, or real imagery — that pulls focus to
|
|
93
|
+
aesthetics before structure is settled.
|
|
94
|
+
- Do NOT polish — wireframes are disposable thinking artifacts.
|
|
95
|
+
- Do NOT write final copy or Lorem ipsum — label-style skeleton copy only.
|
|
96
|
+
- Do NOT let variations converge — write each variation's structure down
|
|
97
|
+
before sketching.
|
|
98
|
+
- Do NOT skip decision capture — an exploration round without a recorded
|
|
99
|
+
decision has to be re-litigated in the hi-fi round.
|
|
100
|
+
- Do NOT embed system internals (paths, skill/tool names) in the artifact —
|
|
101
|
+
Q13 in [`design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md).
|
|
102
|
+
|
|
103
|
+
## Gotcha
|
|
104
|
+
|
|
105
|
+
- This is the one context where rough, hand-drawn-feeling shapes (rectangles,
|
|
106
|
+
lines, simple icons) are acceptable — everything sits at the same low
|
|
107
|
+
fidelity, so nothing reads as a failed asset (the V4/imagery antipatterns
|
|
108
|
+
apply to hi-fi, not here).
|
|
109
|
+
- The wireframe file tends to get promoted into hi-fi by incremental edits —
|
|
110
|
+
don't. Start the hi-fi artifact fresh from the decision capture; the
|
|
111
|
+
wireframe's greyscale skeleton hard-codes non-decisions.
|
|
112
|
+
|
|
113
|
+
## See also
|
|
114
|
+
|
|
115
|
+
- [`design-variations`](../design-variations/SKILL.md) — hi-fi options on the chosen structure.
|
|
116
|
+
- [`design-intelligence`](../design-intelligence/SKILL.md) — grounded direction selection for the hi-fi follow-up.
|
|
117
|
+
- [`fe-design`](../fe-design/SKILL.md) — production heuristics + honest-placeholder pattern.
|
|
118
|
+
- [`existing-ui-audit`](../existing-ui-audit/SKILL.md) — mandatory pre-step once hi-fi work lands in a codebase.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"skill": "wireframe",
|
|
3
|
+
"last_eval": "2026-07-06",
|
|
4
|
+
"description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers lo-fi structure/flow exploration. Should-not-trigger covers near-miss neighbors: design-variations (hi-fi options), fe-design (single implementation), design-review (review existing), design-intelligence (direction selection).",
|
|
5
|
+
"queries": [
|
|
6
|
+
{"q": "sketch a few rough directions for the onboarding flow", "trigger": true},
|
|
7
|
+
{"q": "wireframe the sign-up: single page vs multi-step wizard", "trigger": true},
|
|
8
|
+
{"q": "explore some layout ideas for the dashboard before we style it", "trigger": true},
|
|
9
|
+
{"q": "I'm not sure about the information hierarchy — sketch some low-fi options", "trigger": true},
|
|
10
|
+
{"q": "storyboard three ways the checkout flow could work", "trigger": true},
|
|
11
|
+
{"q": "show me 3 styled design options for the hero section", "trigger": false, "note": "hi-fi options → design-variations"},
|
|
12
|
+
{"q": "build the settings page component", "trigger": false, "note": "single implementation → fe-design / stack executor"},
|
|
13
|
+
{"q": "review this mockup for problems", "trigger": false, "note": "review of existing design → design-review"},
|
|
14
|
+
{"q": "pick a visual direction and font pairing for the app", "trigger": false, "note": "direction selection → design-intelligence / typography-system"},
|
|
15
|
+
{"q": "generate a moodboard image of the landing page", "trigger": false, "note": "image generation → image-provider-routing"}
|
|
16
|
+
]
|
|
17
|
+
}
|
|
@@ -43,7 +43,28 @@ made by the user directly or by the agent on request, following the
|
|
|
43
43
|
# This file is git-ignored. Each developer has their own settings.
|
|
44
44
|
# Run scripts/install to create this file, then /onboard for first-run setup.
|
|
45
45
|
|
|
46
|
-
# ---
|
|
46
|
+
# --- Discipline profile (successor knob, opt-in until the evidence gates pass) ---
|
|
47
|
+
#
|
|
48
|
+
# The ONE runtime knob for the discipline-rule tier (ADR-110; council
|
|
49
|
+
# verdicts 2026-07-07). Measured on claude-haiku-4-5, docs/benchmark.md
|
|
50
|
+
# § Cost-factor sweep:
|
|
51
|
+
#
|
|
52
|
+
# off = kernel only (~1x tokens) — for hosts with a MEASURED null
|
|
53
|
+
# lift (src/config/host-capabilities.yml).
|
|
54
|
+
# essential = kernel + the lift-carrying rules (~3.3x, keeps the weak-host
|
|
55
|
+
# discipline lift; the full load's residual is not significant).
|
|
56
|
+
# full = every rule tier (~11.7x). EXPERIMENTAL opt-in only.
|
|
57
|
+
# auto = resolve per session against host-capabilities.yml
|
|
58
|
+
# (measured-null model -> off, otherwise -> essential).
|
|
59
|
+
#
|
|
60
|
+
# When set, this key WINS over the legacy rule_loading_tier below
|
|
61
|
+
# (mapping when absent: minimal->off, balanced->essential, full->full).
|
|
62
|
+
# The installer fills it per preset (minimal->off, balanced->essential,
|
|
63
|
+
# full->full — behaviour-preserving); `auto` is the evidence-gated flip
|
|
64
|
+
# target (roadmap Phase 4).
|
|
65
|
+
discipline_profile: essential
|
|
66
|
+
|
|
67
|
+
# --- Cost profile (legacy knob — superseded by discipline_profile) ---
|
|
47
68
|
#
|
|
48
69
|
# Master switch that controls which rule tiers load each session.
|
|
49
70
|
# See `docs/customization.md` for the authoritative description and
|
|
@@ -39,7 +39,7 @@ schema_version: 1
|
|
|
39
39
|
# CI guard: a release bump of `package.json` must update this value
|
|
40
40
|
# in lockstep — see scripts/check_template_pin_drift.py (road-to-
|
|
41
41
|
# portable-runtime-and-update-check P3.3).
|
|
42
|
-
agent_config_version: "
|
|
42
|
+
agent_config_version: "8.0.0"
|
|
43
43
|
|
|
44
44
|
# --- Project identity ---
|
|
45
45
|
project:
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
2. Copy the template below
|
|
9
9
|
3. Replace all `{placeholders}` with actual content
|
|
10
10
|
4. Remove all `<!-- comments -->` when done
|
|
11
|
-
5. Run:
|
|
11
|
+
5. Run: `./scripts-run src/scripts/skill_linter src/agent-src/commands/{command-name}.md`
|
|
12
12
|
6. Sync: `task sync` (regenerates `dist/agent-src/` and `.augment/`)
|
|
13
13
|
7. Generate Claude symlink: `task generate-tools` (or manually create symlink)
|
|
14
14
|
|
|
@@ -99,7 +99,7 @@ Before considering a command complete:
|
|
|
99
99
|
- [ ] **Steps**: numbered sub-headings (`### 1.`, `### 2.`, ...)
|
|
100
100
|
- [ ] **Source of truth**: works on `.agent-src.uncondensed/`, not `dist/agent-src/` or `.augment/`
|
|
101
101
|
- [ ] **No auto-apply**: presents findings, asks before destructive changes
|
|
102
|
-
- [ ] **Linter passes**:
|
|
102
|
+
- [ ] **Linter passes**: `./scripts-run src/scripts/skill_linter` reports 0 FAIL
|
|
103
103
|
- [ ] **English only**: all content in English
|
|
104
104
|
- [ ] **Synced**: `dist/agent-src/commands/` has the same file
|
|
105
105
|
- [ ] **Claude symlink**: `.claude/skills/{name}/SKILL.md` → `../../../dist/agent-src/commands/{name}.md`
|