@event4u/agent-config 14.10.0 → 14.12.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/.augment-plugin/marketplace.json +3 -3
- package/.augment-plugin/plugin.json +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +161 -208
- package/README.md +1 -1
- package/dist/agent-src/commands/design.md +88 -0
- package/dist/agent-src/commands/project/analyze.md +47 -0
- package/dist/agent-src/commands/review/changes.md +67 -6
- package/dist/agent-src/commands/roadmap/create.md +49 -0
- package/dist/agent-src/commands/roadmap/next.md +27 -11
- package/dist/agent-src/commands/roadmap/process-full.md +14 -0
- package/dist/agent-src/commands/video/from-script.md +60 -3
- package/dist/agent-src/commands/video/stitch.md +14 -0
- package/dist/agent-src/contexts/communication/rules-auto/guidelines-mechanics.md +1 -0
- package/dist/agent-src/contexts/execution/evidence-discipline.md +26 -0
- package/dist/agent-src/contexts/execution/roadmap-process-loop.md +154 -2
- package/dist/agent-src/rules/active-remediation.md +3 -3
- package/dist/agent-src/rules/code-provenance.md +2 -2
- package/dist/agent-src/rules/context-hygiene.md +13 -33
- package/dist/agent-src/rules/council-availability.md +2 -2
- package/dist/agent-src/rules/decision-revisit-gate.md +3 -1
- package/dist/agent-src/rules/design-fidelity.md +18 -0
- package/dist/agent-src/rules/design-review-after-ui-write.md +2 -2
- package/dist/agent-src/rules/evaluator-independence.md +56 -44
- package/dist/agent-src/rules/fix-what-you-see.md +9 -1
- package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +1 -1
- package/dist/agent-src/rules/minimal-safe-diff.md +14 -20
- package/dist/agent-src/rules/missing-skill-recovery.md +13 -1
- package/dist/agent-src/rules/playbook-precedence.md +105 -0
- package/dist/agent-src/rules/recurring-criticism.md +3 -1
- package/dist/agent-src/rules/roadmap-progress-sync.md +14 -13
- package/dist/agent-src/rules/scale-discipline.md +24 -0
- package/dist/agent-src/rules/security-sensitive-stop.md +2 -2
- package/dist/agent-src/rules/settings-ask-protocol.md +2 -2
- package/dist/agent-src/rules/ui-audit-gate.md +27 -15
- package/dist/agent-src/rules/untrusted-input-defense.md +2 -2
- package/dist/agent-src/skills/accessibility-auditor/SKILL.md +19 -0
- package/dist/agent-src/skills/adr-create/SKILL.md +7 -0
- package/dist/agent-src/skills/agents-md-thin-root/SKILL.md +33 -0
- package/dist/agent-src/skills/ai-council/references/advanced-modes.md +17 -3
- package/dist/agent-src/skills/ai-council/references/output-and-synthesis.md +31 -0
- package/dist/agent-src/skills/ai-council/references/procedure.md +19 -0
- package/dist/agent-src/skills/alerting-doctrine/SKILL.md +225 -0
- package/dist/agent-src/skills/authz-review/SKILL.md +0 -1
- package/dist/agent-src/skills/blast-radius-analyzer/SKILL.md +32 -0
- package/dist/agent-src/skills/brand/SKILL.md +3 -0
- package/dist/agent-src/skills/brand-asset-generation/SKILL.md +3 -0
- package/dist/agent-src/skills/brand-audit/SKILL.md +3 -0
- package/dist/agent-src/skills/brand-identity/SKILL.md +3 -0
- package/dist/agent-src/skills/brand-strategy/SKILL.md +3 -0
- package/dist/agent-src/skills/brand-to-tokens/SKILL.md +3 -0
- package/dist/agent-src/skills/check-refs/SKILL.md +3 -0
- package/dist/agent-src/skills/code-refactoring/SKILL.md +45 -1
- package/dist/agent-src/skills/code-review/SKILL.md +75 -5
- package/dist/agent-src/skills/command-routing/SKILL.md +6 -0
- package/dist/agent-src/skills/command-writing/SKILL.md +35 -0
- package/dist/agent-src/skills/condense-memory/SKILL.md +3 -0
- package/dist/agent-src/skills/context-authoring/SKILL.md +1 -1
- package/dist/agent-src/skills/conventional-commits-writing/SKILL.md +3 -0
- package/dist/agent-src/skills/copilot-agents-optimization/SKILL.md +10 -0
- package/dist/agent-src/skills/corpus-grounding/SKILL.md +3 -0
- package/dist/agent-src/skills/design-intelligence/SKILL.md +3 -0
- package/dist/agent-src/skills/design-intelligence/data/landing.csv +36 -35
- package/dist/agent-src/skills/design-intelligence/data/stacks/threejs.csv +1 -0
- package/dist/agent-src/skills/design-review/SKILL.md +79 -1
- package/dist/agent-src/skills/design-review/references/verification-automation.md +41 -0
- package/dist/agent-src/skills/design-system-capture/SKILL.md +35 -40
- package/dist/agent-src/skills/design-system-capture/references/import-procedure.md +50 -0
- package/dist/agent-src/skills/design-tokens/SKILL.md +3 -0
- package/dist/agent-src/skills/design-variations/SKILL.md +3 -0
- package/dist/agent-src/skills/developer-like-execution/SKILL.md +3 -0
- package/dist/agent-src/skills/estimate-ticket/SKILL.md +3 -0
- package/dist/agent-src/skills/existing-ui-audit/SKILL.md +28 -4
- package/dist/agent-src/skills/fe-design/SKILL.md +74 -41
- package/dist/agent-src/skills/fe-design/references/craft-floor.md +52 -0
- package/dist/agent-src/skills/fe-design/references/source-led-port.md +36 -0
- package/dist/agent-src/skills/file-editor/SKILL.md +5 -0
- package/dist/agent-src/skills/finishing-a-development-branch/SKILL.md +2 -2
- package/dist/agent-src/skills/git-workflow/SKILL.md +3 -0
- package/dist/agent-src/skills/html-deck/SKILL.md +3 -0
- package/dist/agent-src/skills/iconography/SKILL.md +3 -0
- package/dist/agent-src/skills/image-editing/SKILL.md +3 -0
- package/dist/agent-src/skills/image-generation/SKILL.md +3 -0
- package/dist/agent-src/skills/image-provider-routing/SKILL.md +3 -0
- package/dist/agent-src/skills/incident-commander/SKILL.md +10 -0
- package/dist/agent-src/skills/js-library-packaging/SKILL.md +173 -0
- package/dist/agent-src/skills/js-library-packaging/scripts/check_package_surface.ts +270 -0
- package/dist/agent-src/skills/laravel-migration/SKILL.md +3 -0
- package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md +3 -0
- package/dist/agent-src/skills/lint-skills/SKILL.md +3 -0
- package/dist/agent-src/skills/llm-provider-knowledge/SKILL.md +3 -0
- package/dist/agent-src/skills/logging-monitoring/SKILL.md +234 -51
- package/dist/agent-src/skills/logo-generation/SKILL.md +3 -0
- package/dist/agent-src/skills/md-language-check/SKILL.md +3 -0
- package/dist/agent-src/skills/monorepo-workspace/SKILL.md +149 -0
- package/dist/agent-src/skills/motion-choreographer/SKILL.md +6 -0
- package/dist/agent-src/skills/multi-tenancy/SKILL.md +4 -0
- package/dist/agent-src/skills/operational-readiness/SKILL.md +184 -0
- package/dist/agent-src/skills/override-management/SKILL.md +3 -0
- package/dist/agent-src/skills/persona-improvement/SKILL.md +3 -0
- package/dist/agent-src/skills/pest-testing/SKILL.md +3 -0
- package/dist/agent-src/skills/playbook-authoring/SKILL.md +162 -0
- package/dist/agent-src/skills/playwright-testing/SKILL.md +3 -0
- package/dist/agent-src/skills/privacy-review/SKILL.md +3 -0
- package/dist/agent-src/skills/project-analysis-core/SKILL.md +23 -0
- package/dist/agent-src/skills/prompt-engineering-image/SKILL.md +3 -0
- package/dist/agent-src/skills/quality-tools/SKILL.md +5 -0
- package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +81 -33
- package/dist/agent-src/skills/readme-reviewer/SKILL.md +3 -0
- package/dist/agent-src/skills/readme-writing/SKILL.md +3 -0
- package/dist/agent-src/skills/readme-writing-package/SKILL.md +3 -0
- package/dist/agent-src/skills/receiving-code-review/SKILL.md +2 -2
- package/dist/agent-src/skills/refine-prompt/SKILL.md +3 -0
- package/dist/agent-src/skills/refine-ticket/SKILL.md +3 -0
- package/dist/agent-src/skills/requesting-code-review/SKILL.md +2 -2
- package/dist/agent-src/skills/review-routing/SKILL.md +2 -2
- package/dist/agent-src/skills/roadmap-writing/SKILL.md +23 -41
- package/dist/agent-src/skills/roadmap-writing/references/follow-up-roadmap-shape.md +47 -0
- package/dist/agent-src/skills/rtk-output-filtering/SKILL.md +22 -6
- package/dist/agent-src/skills/runway-cognition/SKILL.md +3 -0
- package/dist/agent-src/skills/scene-expander/scene-blueprint.schema.yaml +26 -0
- package/dist/agent-src/skills/secrets-management/SKILL.md +4 -0
- package/dist/agent-src/skills/server-hardening/SKILL.md +159 -0
- package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +3 -0
- package/dist/agent-src/skills/skill-management/SKILL.md +3 -0
- package/dist/agent-src/skills/skill-reviewer/SKILL.md +3 -0
- package/dist/agent-src/skills/skill-writing/SKILL.md +6 -0
- package/dist/agent-src/skills/skill-writing/references/procedure.md +24 -2
- package/dist/agent-src/skills/spreadsheet-authoring/SKILL.md +3 -0
- package/dist/agent-src/skills/storybook-workshop/SKILL.md +203 -0
- package/dist/agent-src/skills/storybook-workshop/scripts/story_contrast_floor.ts +134 -0
- package/dist/agent-src/skills/subagent-orchestration/SKILL.md +1 -1
- package/dist/agent-src/skills/subagent-orchestration/prompts/README.md +25 -0
- package/dist/agent-src/skills/supply-chain-intake/SKILL.md +12 -0
- package/dist/agent-src/skills/systematic-debugging/SKILL.md +1 -1
- package/dist/agent-src/skills/terraform/SKILL.md +3 -0
- package/dist/agent-src/skills/test-driven-development/SKILL.md +1 -1
- package/dist/agent-src/skills/threat-modeling/SKILL.md +0 -3
- package/dist/agent-src/skills/token-optimizer/SKILL.md +3 -0
- package/dist/agent-src/skills/typography-system/SKILL.md +3 -0
- package/dist/agent-src/skills/ui-component-architect/SKILL.md +17 -1
- package/dist/agent-src/skills/upstream-contribute/SKILL.md +3 -0
- package/dist/agent-src/skills/validate-feature-fit/SKILL.md +3 -0
- package/dist/agent-src/skills/verify-completion-evidence/SKILL.md +2 -2
- package/dist/agent-src/skills/wireframe/SKILL.md +3 -0
- package/dist/agent-src/skills/wireframe/references/story-beat-ledger.schema.json +115 -0
- package/dist/agent-src/skills/workspace-link/SKILL.md +131 -0
- package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
- package/dist/agent-src/templates/playbook.md +75 -0
- package/dist/agent-src/templates/roadmaps.md +37 -0
- package/dist/agent-src/templates/scripts/check_playbook_invokes.ts +231 -0
- package/dist/agent-src/templates/scripts/work_engine/directives/ui/apply.ts +24 -0
- package/dist/agent-src/templates/scripts/work_engine/directives/ui/polish.ts +2 -0
- package/dist/agent-src/templates/scripts/work_engine/directives/ui/review.ts +216 -0
- package/dist/agent-src/templates/scripts/work_engine/directives/ui/scaffold.ts +159 -0
- package/dist/agent-src/templates/scripts/work_engine/directives/ui/stack_bundles.ts +73 -4
- package/dist/agent-src/templates/scripts/work_engine/stack/detect.ts +325 -40
- package/dist/cli/commands/uiAudit.js +221 -0
- package/dist/cli/commands/uiRender.js +206 -0
- package/dist/cli/main.js +22 -1
- package/dist/cli/mcp/content.js +64 -1
- package/dist/cli/mcp/dispatch.js +175 -10
- package/dist/cli/registry.js +3 -0
- package/dist/cli-delegate/{chunk-G23AT6GD.js → chunk-DMSZHXZS.js} +57 -1
- package/dist/cli-delegate/{chunk-77GR3VD4.js → chunk-FF7WAFMR.js} +58 -3
- package/dist/cli-delegate/{chunk-YM4GZDJG.js → chunk-JCW7ZLHK.js} +10 -0
- package/dist/cli-delegate/{chunk-H4VIVD4C.js → chunk-JJA2QEWA.js} +413 -391
- package/dist/cli-delegate/{chunk-PLSG6UL5.js → chunk-K4FFODTS.js} +341 -204
- package/dist/cli-delegate/{chunk-B2ERU2VA.js → chunk-WOKWX5PL.js} +1 -1
- package/dist/cli-delegate/cmd_brand_status.js +8 -6
- package/dist/cli-delegate/cmd_conformance.js +3 -3
- package/dist/cli-delegate/cmd_doctor.js +3 -3
- package/dist/cli-delegate/cmd_export.js +4 -4
- package/dist/cli-delegate/cmd_handoff.js +1 -1
- package/dist/cli-delegate/cmd_preflight.js +2 -2
- package/dist/cli-delegate/cmd_prune.js +4 -4
- package/dist/cli-delegate/cmd_session_recycle.js +70 -9
- package/dist/cli-delegate/cmd_settings_migrate.js +4 -4
- package/dist/cli-delegate/cmd_settings_set.js +1 -1
- package/dist/cli-delegate/cmd_sync.js +4 -4
- package/dist/cli-delegate/cmd_uninstall.js +4 -4
- package/dist/cli-delegate/cmd_validate.js +4 -4
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +362 -127
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +4 -4
- package/dist/discovery/dormancy-report.md +1 -1
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +18 -8
- package/dist/discovery/trust-report.md +3 -3
- package/dist/discovery/workspaces.json +16 -6
- package/dist/hooks/dispatch.js +2575 -1472
- package/dist/install/install.mjs +800 -708
- package/dist/mcp/registry-manifest.json +3 -3
- package/dist/mcp/server.json +2 -2
- package/dist/mcp/server.mjs +1685 -1250
- package/dist/router.json +1 -1
- package/dist/scripts/_lib/lean_projection_mode.js +40 -0
- package/dist/scripts/_lib/scoped_projection.js +84 -0
- package/dist/scripts/_lib/ui_surface.js +89 -0
- package/dist/scripts/condense.js +6 -10
- package/dist/scripts/project_thin_rules.js +40 -2
- package/dist/server/schemas/settings.js +6 -0
- package/dist/shared/skillRanking.js +159 -0
- package/docs/contracts/provider-lifecycle.md +47 -18
- package/docs/contracts/settings-classes.md +35 -5
- package/docs/guidelines/agent-infra/context-hygiene-mechanics.md +49 -0
- package/docs/guidelines/agent-infra/downstream-changes-mechanics.md +91 -0
- package/docs/guidelines/agent-infra/evaluator-independence-mechanics.md +92 -0
- package/docs/guidelines/agent-infra/minimal-safe-diff-mechanics.md +45 -1
- package/docs/guidelines/agent-infra/roadmap-deferred-resolution-provenance.md +54 -0
- package/docs/guidelines/code-clarity.md +21 -0
- package/docs/guidelines/design-antipatterns.md +4 -2
- package/docs/guidelines/design-asset-discipline.md +38 -0
- package/docs/guidelines/design-fidelity-mechanics.md +45 -29
- package/docs/guidelines/design-handover-extraction.md +35 -5
- package/docs/guidelines/design-modes.md +41 -1
- package/docs/guidelines/monorepo-antipatterns.md +141 -0
- package/docs/guidelines/redundancy-taxonomy.md +180 -0
- package/llms.txt +50 -39
- package/package.json +6 -2
- package/src/agent-src/templates/scripts/check_playbook_invokes.ts +231 -0
- package/src/agent-src/templates/scripts/work_engine/directives/ui/apply.ts +24 -0
- package/src/agent-src/templates/scripts/work_engine/directives/ui/polish.ts +2 -0
- package/src/agent-src/templates/scripts/work_engine/directives/ui/review.ts +216 -0
- package/src/agent-src/templates/scripts/work_engine/directives/ui/scaffold.ts +159 -0
- package/src/agent-src/templates/scripts/work_engine/directives/ui/stack_bundles.ts +73 -4
- package/src/agent-src/templates/scripts/work_engine/stack/detect.ts +325 -40
- package/src/config/agent-settings.template.yml +44 -0
- package/src/config/assurance-capability-registry.json +223 -0
- package/src/config/assurance-threshold-budget.json +65 -0
- package/src/config/budgets.yml +19 -0
- package/src/config/ci-local-parity.yml +29 -0
- package/src/config/discovery/prompt-patterns.yml +56 -0
- package/src/config/discovery/unassigned-artefacts.yml +2 -0
- package/src/config/dispatch-economy-metrics.json +4 -2
- package/src/config/estate-count-budget.json +8 -3
- package/src/config/evaluator-budgets.json +14 -14
- package/src/config/gate-coverage.yml +392 -8
- package/src/config/gate-violation-baselines.json +76 -72
- package/src/config/hook-latency-budget.json +1 -0
- package/src/config/hook-token-budget.json +137 -125
- package/src/config/pack-size-budget.json +39 -10
- package/src/config/preamble-payload-budget.json +97 -71
- package/src/config/quorum-attendance-budget.json +12 -4
- package/src/config/routing-coverage-seed.json +29 -0
- package/src/config/rule-activation-census.json +7 -3
- package/src/config/rule-enforcement-baseline.json +0 -1
- package/src/config/rule-stub-ceilings.json +112 -91
- package/src/config/suggestion-capture.json +28 -0
- package/src/config/surface-matrix.yml +21 -2
- package/src/config/web-launch-readiness.json +188 -0
- package/src/scripts/_cli/cmd_doctor.ts +15 -16
- package/src/scripts/_cli/doctor_install_mode.ts +49 -0
- package/src/scripts/_cli/doctor_overrides.ts +154 -0
- package/src/scripts/_dispatch.bash +17 -0
- package/src/scripts/_lib/as_of.ts +412 -0
- package/src/scripts/_lib/exec_evidence.ts +7 -0
- package/src/scripts/_lib/gate_baseline.ts +150 -1
- package/src/scripts/_lib/hook_settings.ts +33 -0
- package/src/scripts/_lib/host_listing_model.ts +192 -0
- package/src/scripts/_lib/lean_projection_mode.ts +44 -0
- package/src/scripts/_lib/mcp_bridge.ts +199 -0
- package/src/scripts/_lib/review_independence.ts +62 -10
- package/src/scripts/_lib/rule_injection.ts +239 -0
- package/src/scripts/_lib/run_checkpoint.ts +54 -1
- package/src/scripts/_lib/scoped_projection.ts +96 -0
- package/src/scripts/_lib/session_register.ts +44 -2
- package/src/scripts/_lib/skill_catalogue.ts +38 -2
- package/src/scripts/_lib/skill_estate.ts +115 -0
- package/src/scripts/_lib/transcript_reads.ts +207 -0
- package/src/scripts/_lib/ui_authority.ts +343 -0
- package/src/scripts/ai-video/adapters/fal.sh +8 -3
- package/src/scripts/ai-video/adapters/gemini-veo.sh +10 -0
- package/src/scripts/ai-video/adapters/higgsfield.sh +10 -2
- package/src/scripts/ai-video/adapters/kling.sh +10 -0
- package/src/scripts/ai-video/adapters/sora.sh +10 -0
- package/src/scripts/ai-video/lib/calibrate-cost.sh +145 -0
- package/src/scripts/ai-video/lib/model-capabilities/README.md +53 -7
- package/src/scripts/ai-video/lib/model-capabilities/comfyui.json +15 -3
- package/src/scripts/ai-video/lib/model-capabilities/fal.json +36 -6
- package/src/scripts/ai-video/lib/model-capabilities/gemini-veo.json +23 -0
- package/src/scripts/ai-video/lib/model-capabilities/higgsfield.json +23 -0
- package/src/scripts/ai-video/lib/model-capabilities/kling.json +23 -0
- package/src/scripts/ai-video/lib/model-capabilities/musetalk.json +8 -2
- package/src/scripts/ai-video/lib/model-capabilities/replicate.json +36 -6
- package/src/scripts/ai-video/lib/model-capabilities/sora.json +45 -0
- package/src/scripts/ai-video/lib/model-capabilities/syncso.json +8 -2
- package/src/scripts/ai-video/lib/parse-blueprint.sh +52 -5
- package/src/scripts/ai-video/lib/resume-scan.sh +92 -3
- package/src/scripts/ai-video/lib/seam-plan.sh +212 -0
- package/src/scripts/ai-video/smoke-trace.sh +450 -2
- package/src/scripts/ai-video/stitch.sh +191 -10
- package/src/scripts/ai-video/test-pipeline.sh +84 -6
- package/src/scripts/ai_council/argument_exhaustion.ts +130 -0
- package/src/scripts/ai_council/cli_agency_bounds.ts +139 -0
- package/src/scripts/ai_council/cli_least_agency_canary.ts +347 -0
- package/src/scripts/ai_council/clients.ts +3 -2
- package/src/scripts/ai_council/consensus.ts +63 -6
- package/src/scripts/ai_council/events_log.ts +46 -1
- package/src/scripts/ai_council/orchestrator.ts +103 -108
- package/src/scripts/ai_council/orchestrator_results.ts +166 -0
- package/src/scripts/ai_council/prompts.ts +12 -5
- package/src/scripts/ai_council/quorum.ts +82 -1
- package/src/scripts/ai_council/quorum_wiring.ts +82 -5
- package/src/scripts/ai_council/stance_tally.ts +22 -0
- package/src/scripts/bench_hook_latency.ts +62 -0
- package/src/scripts/build_proof.ts +12 -1
- package/src/scripts/capture_skill_catalogue.ts +21 -0
- package/src/scripts/check_always_budget.ts +2 -1
- package/src/scripts/check_augmentignore.ts +2 -1
- package/src/scripts/check_beta_review_markers.ts +2 -1
- package/src/scripts/check_bundle_path_leakage.ts +162 -7
- package/src/scripts/check_command_examples.ts +557 -0
- package/src/scripts/check_composite_arming.ts +364 -0
- package/src/scripts/check_corpus_staleness.ts +2 -1
- package/src/scripts/check_council_pin_staleness.ts +3 -1
- package/src/scripts/check_enforcement_coverage.ts +116 -3
- package/src/scripts/check_enforcement_denominator.ts +365 -0
- package/src/scripts/check_estate_count.ts +122 -3
- package/src/scripts/check_gate_coverage.ts +2 -1
- package/src/scripts/check_hook_bundle_freshness.ts +13 -1
- package/src/scripts/check_knowledge_cards.ts +2 -1
- package/src/scripts/check_knowledge_pages.ts +3 -2
- package/src/scripts/check_memory.ts +2 -1
- package/src/scripts/check_no_automerge_key.ts +287 -0
- package/src/scripts/check_pack_conformance_fixture.ts +565 -0
- package/src/scripts/check_preamble_payload_budget.ts +30 -3
- package/src/scripts/check_proposal.ts +2 -1
- package/src/scripts/check_reach_staleness.ts +2 -1
- package/src/scripts/check_release_adjacent_health.ts +2 -1
- package/src/scripts/check_release_pr_shape.ts +5 -0
- package/src/scripts/check_review_schema.ts +34 -1
- package/src/scripts/check_roadmap_trackable.ts +48 -3
- package/src/scripts/check_routing_coverage.ts +352 -0
- package/src/scripts/check_score_contract.ts +505 -0
- package/src/scripts/check_skill_admissions.ts +514 -0
- package/src/scripts/check_source_size_budget.ts +2 -1
- package/src/scripts/check_standing_payload_delta.ts +505 -0
- package/src/scripts/check_trigger_evals.ts +2 -1
- package/src/scripts/check_web_launch_readiness.ts +705 -0
- package/src/scripts/classify_change_risk.ts +281 -0
- package/src/scripts/compute_skill_tiers.ts +186 -0
- package/src/scripts/condense.ts +8 -13
- package/src/scripts/council_attendance_metrics.ts +183 -0
- package/src/scripts/council_cli.ts +10 -8
- package/src/scripts/council_parse_rate.ts +116 -0
- package/src/scripts/derive_playbooks.ts +406 -0
- package/src/scripts/description_route_check.ts +494 -0
- package/src/scripts/design_slop_rules.ts +56 -2
- package/src/scripts/dispatch_r2_reviewer.ts +16 -0
- package/src/scripts/frontend_corpus_hash.ts +116 -0
- package/src/scripts/grade_target_readiness.ts +478 -0
- package/src/scripts/hook_manifest.json +1 -1
- package/src/scripts/hook_manifest.yaml +124 -16
- package/src/scripts/hooks/concern_registry.ts +6 -0
- package/src/scripts/hooks/design_pass_hook.ts +356 -0
- package/src/scripts/hooks/rtk_wrap_hook.ts +30 -7
- package/src/scripts/hooks/rule_inject_hook.ts +318 -0
- package/src/scripts/hooks/suggestion_capture_hook.ts +368 -0
- package/src/scripts/hot_context_hook.ts +74 -7
- package/src/scripts/install.ts +40 -89
- package/src/scripts/lint_adapter_tier.ts +663 -0
- package/src/scripts/lint_archived_skills.ts +93 -0
- package/src/scripts/lint_budget_ownership.ts +56 -5
- package/src/scripts/lint_deterministic_time.ts +470 -0
- package/src/scripts/lint_framework_leakage.ts +5 -0
- package/src/scripts/lint_handoffs.ts +525 -1
- package/src/scripts/lint_judge_prompt_expectation.ts +155 -0
- package/src/scripts/lint_marketplace.ts +88 -0
- package/src/scripts/lint_media_policy_linkage.ts +140 -1
- package/src/scripts/lint_one_off_age.ts +6 -1
- package/src/scripts/lint_override_kernel_guard.ts +87 -5
- package/src/scripts/lint_roadmap_complexity.ts +56 -0
- package/src/scripts/lint_rule_enforcement_declaration.ts +24 -7
- package/src/scripts/lint_rule_norm_pin.ts +321 -0
- package/src/scripts/lint_skill_trigger_corpus.ts +349 -0
- package/src/scripts/lint_spawn_payload.ts +42 -5
- package/src/scripts/lint_symptom_intake.ts +2 -1
- package/src/scripts/mcp_parity_smoke.ts +30 -4
- package/src/scripts/mcp_render.ts +66 -1
- package/src/scripts/mcp_tool_fingerprint.ts +241 -0
- package/src/scripts/measure_risk_class_drift.ts +140 -0
- package/src/scripts/measure_skill_ranker_baseline.ts +212 -0
- package/src/scripts/media/lib/adapter-common.sh +211 -1
- package/src/scripts/media/lib/adapter-contract.md +74 -6
- package/src/scripts/model_rule_injection.ts +907 -0
- package/src/scripts/pack_install_smoke.ts +363 -0
- package/src/scripts/pr_conflict_census.ts +187 -0
- package/src/scripts/project_thin_rules.ts +45 -2
- package/src/scripts/release.ts +66 -860
- package/src/scripts/release_drill.ts +59 -3
- package/src/scripts/release_env.ts +298 -0
- package/src/scripts/release_publication.ts +720 -0
- package/src/scripts/report_pack_delta.ts +204 -0
- package/src/scripts/roadmap_context.ts +778 -0
- package/src/scripts/schemas/fidelity-measurement-sheet.schema.json +169 -0
- package/src/scripts/schemas/rule.schema.json +24 -2
- package/src/scripts/schemas/skill.schema.json +39 -0
- package/src/scripts/schemas/ui-authority.schema.json +114 -0
- package/src/scripts/select_analysis_mode.ts +112 -0
- package/src/scripts/session_register_hook.ts +29 -3
- package/src/scripts/sessions_cli.ts +67 -3
- package/src/scripts/skill_tools/score_skill_relevance.ts +36 -53
- package/src/scripts/sync_pr_branch.ts +40 -1
- package/src/scripts/token_sink_report.ts +239 -0
- package/src/scripts/trigger_coverage.ts +122 -3
- package/src/scripts/update_counts.ts +7 -3
- package/src/scripts/validate_frontmatter.ts +66 -0
- package/src/server/schemas/settings.ts +10 -0
- package/src/shared/skillRanking.ts +183 -0
- package/dist/agent-src/skills/accessibility-auditor/evals/evals.json +0 -15
- package/dist/agent-src/skills/agent-security-review/evals/triggers.json +0 -52
- package/dist/agent-src/skills/ai-code-blindspots/evals/triggers.json +0 -52
- package/dist/agent-src/skills/analysis-skill-router/evals/evals.json +0 -13
- package/dist/agent-src/skills/brand/evals/triggers.json +0 -17
- package/dist/agent-src/skills/brand-asset-generation/evals/triggers.json +0 -17
- package/dist/agent-src/skills/brand-audit/evals/triggers.json +0 -17
- package/dist/agent-src/skills/brand-identity/evals/triggers.json +0 -17
- package/dist/agent-src/skills/brand-strategy/evals/triggers.json +0 -17
- package/dist/agent-src/skills/brand-to-tokens/evals/triggers.json +0 -17
- package/dist/agent-src/skills/bug-analyzer/evals/evals.json +0 -13
- package/dist/agent-src/skills/canvas-design/evals/triggers.json +0 -17
- package/dist/agent-src/skills/character-consistency/evals/evals.json +0 -16
- package/dist/agent-src/skills/code-intelligence/evals/triggers.json +0 -52
- package/dist/agent-src/skills/code-review/evals/evals.json +0 -100
- package/dist/agent-src/skills/command-routing/evals/evals.json +0 -14
- package/dist/agent-src/skills/complexity-first-planning/evals/triggers.json +0 -17
- package/dist/agent-src/skills/contract-review/evals/triggers.json +0 -17
- package/dist/agent-src/skills/conventional-commits-writing/evals/evals.json +0 -15
- package/dist/agent-src/skills/corpus-grounding/evals/triggers.json +0 -17
- package/dist/agent-src/skills/dashboard-design/evals/evals.json +0 -16
- package/dist/agent-src/skills/dcf-modeling/evals/domain-truth.json +0 -29
- package/dist/agent-src/skills/dcf-modeling/evals/evals.json +0 -20
- package/dist/agent-src/skills/decision-record/evals/evals.json +0 -20
- package/dist/agent-src/skills/decision-record/evals/triggers.json +0 -87
- package/dist/agent-src/skills/design-intelligence/evals/evals.json +0 -14
- package/dist/agent-src/skills/design-intelligence/evals/triggers.json +0 -17
- package/dist/agent-src/skills/design-system-capture/evals/evals.json +0 -15
- package/dist/agent-src/skills/design-tokens/evals/triggers.json +0 -17
- package/dist/agent-src/skills/design-variations/evals/triggers.json +0 -17
- package/dist/agent-src/skills/developer-like-execution/evals/evals.json +0 -16
- package/dist/agent-src/skills/doc-coauthoring/evals/evals.json +0 -16
- package/dist/agent-src/skills/doc-coauthoring/evals/triggers.json +0 -17
- package/dist/agent-src/skills/docx-authoring/evals/triggers.json +0 -52
- package/dist/agent-src/skills/dpa-review/evals/triggers.json +0 -17
- package/dist/agent-src/skills/editorial-calendar/evals/domain-truth.json +0 -16
- package/dist/agent-src/skills/editorial-calendar/evals/evals.json +0 -16
- package/dist/agent-src/skills/eloquent/evals/triggers.json +0 -17
- package/dist/agent-src/skills/estimate-ticket/evals/evals.json +0 -16
- package/dist/agent-src/skills/estimate-ticket/evals/output-schema.yml +0 -20
- package/dist/agent-src/skills/estimate-ticket/evals/triggers.json +0 -19
- package/dist/agent-src/skills/evaluate-llm-feature/evals/triggers.json +0 -52
- package/dist/agent-src/skills/existing-ui-audit/evals/triggers.json +0 -47
- package/dist/agent-src/skills/experiment-loop/evals/output-schema.yml +0 -27
- package/dist/agent-src/skills/experiment-loop/evals/triggers.json +0 -17
- package/dist/agent-src/skills/fe-design/evals/triggers.json +0 -55
- package/dist/agent-src/skills/forecasting/evals/domain-truth.json +0 -29
- package/dist/agent-src/skills/forecasting/evals/evals.json +0 -20
- package/dist/agent-src/skills/forensics-report/evals/triggers.json +0 -17
- package/dist/agent-src/skills/frontend-render-security/evals/triggers.json +0 -52
- package/dist/agent-src/skills/fundraising-narrative/evals/domain-truth.json +0 -16
- package/dist/agent-src/skills/fundraising-narrative/evals/evals.json +0 -16
- package/dist/agent-src/skills/gated-reach/evals/triggers.json +0 -72
- package/dist/agent-src/skills/github-ci/evals/evals.json +0 -25
- package/dist/agent-src/skills/history-design/evals/triggers.json +0 -17
- package/dist/agent-src/skills/html-deck/evals/triggers.json +0 -17
- package/dist/agent-src/skills/humanizer/evals/strip_fixtures.json +0 -57
- package/dist/agent-src/skills/humanizer/evals/triggers.json +0 -17
- package/dist/agent-src/skills/iconography/evals/triggers.json +0 -17
- package/dist/agent-src/skills/image-analyser/evals/triggers.json +0 -17
- package/dist/agent-src/skills/image-creator/evals/triggers.json +0 -17
- package/dist/agent-src/skills/image-editing/evals/triggers.json +0 -17
- package/dist/agent-src/skills/image-generation/evals/triggers.json +0 -17
- package/dist/agent-src/skills/image-provider-routing/evals/triggers.json +0 -17
- package/dist/agent-src/skills/incident-commander/evals/domain-truth.json +0 -16
- package/dist/agent-src/skills/incident-commander/evals/evals.json +0 -20
- package/dist/agent-src/skills/judge-artifact-completeness/evals/triggers.json +0 -17
- package/dist/agent-src/skills/judge-injection-defense/evals/triggers.json +0 -17
- package/dist/agent-src/skills/judge-synthesis/evals/triggers.json +0 -17
- package/dist/agent-src/skills/launch-readiness/evals/evals.json +0 -21
- package/dist/agent-src/skills/learning-tutor/evals/triggers.json +0 -52
- package/dist/agent-src/skills/legal-intake-triage/evals/triggers.json +0 -17
- package/dist/agent-src/skills/legal-practice-profile/evals/triggers.json +0 -17
- package/dist/agent-src/skills/license-compliance-audit/evals/triggers.json +0 -52
- package/dist/agent-src/skills/license-compliance-borrow-check/evals/triggers.json +0 -52
- package/dist/agent-src/skills/license-compliance-credits/evals/triggers.json +0 -52
- package/dist/agent-src/skills/llm-provider-knowledge/evals/triggers.json +0 -20
- package/dist/agent-src/skills/logging-monitoring/evals/evals.json +0 -16
- package/dist/agent-src/skills/logo-generation/evals/triggers.json +0 -17
- package/dist/agent-src/skills/messaging-architecture/evals/domain-truth.json +0 -16
- package/dist/agent-src/skills/messaging-architecture/evals/evals.json +0 -16
- package/dist/agent-src/skills/nda-triage/evals/triggers.json +0 -17
- package/dist/agent-src/skills/pdf-tools/evals/triggers.json +0 -52
- package/dist/agent-src/skills/perf-feedback-craft/evals/evals.json +0 -16
- package/dist/agent-src/skills/persona-improvement/evals/triggers.json +0 -52
- package/dist/agent-src/skills/php-coder/evals/triggers.json +0 -17
- package/dist/agent-src/skills/prediction-pool-optimizer/evals/triggers.json +0 -21
- package/dist/agent-src/skills/prompt-engineering-image/evals/triggers.json +0 -17
- package/dist/agent-src/skills/prompt-engineering-patterns/evals/evals.json +0 -16
- package/dist/agent-src/skills/prompt-validator/evals/triggers.json +0 -17
- package/dist/agent-src/skills/quality-tools/evals/evals.json +0 -15
- package/dist/agent-src/skills/reasoning-orchestrator/evals/triggers.json +0 -17
- package/dist/agent-src/skills/refine-prompt/evals/evals.json +0 -16
- package/dist/agent-src/skills/refine-ticket/evals/evals.json +0 -16
- package/dist/agent-src/skills/refine-ticket/evals/output-schema.yml +0 -16
- package/dist/agent-src/skills/refine-ticket/evals/triggers.json +0 -17
- package/dist/agent-src/skills/release-comms/evals/evals.json +0 -16
- package/dist/agent-src/skills/rice-prioritization/evals/evals.json +0 -20
- package/dist/agent-src/skills/runway-cognition/evals/domain-truth.json +0 -29
- package/dist/agent-src/skills/runway-cognition/evals/evals.json +0 -20
- package/dist/agent-src/skills/scenario-modeling/evals/domain-truth.json +0 -29
- package/dist/agent-src/skills/scenario-modeling/evals/evals.json +0 -20
- package/dist/agent-src/skills/schema-review/evals/triggers.json +0 -17
- package/dist/agent-src/skills/screenshot-hygiene/evals/triggers.json +0 -52
- package/dist/agent-src/skills/security-maturity-assessment/evals/triggers.json +0 -52
- package/dist/agent-src/skills/skill-writing/evals/triggers.json +0 -17
- package/dist/agent-src/skills/spreadsheet-authoring/evals/triggers.json +0 -47
- package/dist/agent-src/skills/subagent-orchestration/evals/evals.json +0 -60
- package/dist/agent-src/skills/supply-chain-intake/evals/triggers.json +0 -52
- package/dist/agent-src/skills/systematic-debugging/evals/evals.json +0 -20
- package/dist/agent-src/skills/test-case-discovery/evals/triggers.json +0 -52
- package/dist/agent-src/skills/test-driven-development/evals/evals.json +0 -16
- package/dist/agent-src/skills/threat-modeling/evals/evals.json +0 -21
- package/dist/agent-src/skills/typography-system/evals/evals.json +0 -14
- package/dist/agent-src/skills/typography-system/evals/triggers.json +0 -17
- package/dist/agent-src/skills/unit-economics-modeling/evals/domain-truth.json +0 -40
- package/dist/agent-src/skills/unit-economics-modeling/evals/evals.json +0 -24
- package/dist/agent-src/skills/verify-completion-evidence/evals/evals.json +0 -16
- package/dist/agent-src/skills/verify-repair-loop/evals/output-schema.yml +0 -20
- package/dist/agent-src/skills/verify-repair-loop/evals/triggers.json +0 -17
- package/dist/agent-src/skills/vision-articulation/evals/evals.json +0 -16
- package/dist/agent-src/skills/voice-and-tone-design/evals/evals.json +0 -16
- package/dist/agent-src/skills/wireframe/evals/triggers.json +0 -17
- package/dist/agent-src/skills/worktree-lifecycle/evals/evals.json +0 -38
- package/dist/agent-src/skills/worktree-lifecycle/evals/triggers.json +0 -52
- package/dist/cli/agent-config.js.map +0 -1
- package/dist/cli/bash/runBash.js.map +0 -1
- package/dist/cli/commands/commands.js.map +0 -1
- package/dist/cli/commands/config.js.map +0 -1
- package/dist/cli/commands/doctorShell.js.map +0 -1
- package/dist/cli/commands/mcpServer.js.map +0 -1
- package/dist/cli/commands/packs.js.map +0 -1
- package/dist/cli/commands/profiles.js.map +0 -1
- package/dist/cli/commands/recordTriggerEval.js.map +0 -1
- package/dist/cli/commands/rtkDetect.js.map +0 -1
- package/dist/cli/commands/settings.js.map +0 -1
- package/dist/cli/commands/uiServe.js.map +0 -1
- package/dist/cli/commands/versions.js.map +0 -1
- package/dist/cli/commands/workspaces.js.map +0 -1
- package/dist/cli/configRoot.js.map +0 -1
- package/dist/cli/discovery/loadManifest.js.map +0 -1
- package/dist/cli/firstRunNotice.js.map +0 -1
- package/dist/cli/help.js.map +0 -1
- package/dist/cli/initRouting.js.map +0 -1
- package/dist/cli/log/logger.js.map +0 -1
- package/dist/cli/main.js.map +0 -1
- package/dist/cli/mcp/content.js.map +0 -1
- package/dist/cli/mcp/dispatch.js.map +0 -1
- package/dist/cli/mcp/stdio.js.map +0 -1
- package/dist/cli/paths.js.map +0 -1
- package/dist/cli/python/knowledge_ingest.js.map +0 -1
- package/dist/cli/python/workspace_analytics.js.map +0 -1
- package/dist/cli/python/workspace_crypto.js.map +0 -1
- package/dist/cli/python/workspace_documents.js.map +0 -1
- package/dist/cli/python/workspace_drive.js.map +0 -1
- package/dist/cli/python/workspace_drive_health.js.map +0 -1
- package/dist/cli/python/workspace_explain.js.map +0 -1
- package/dist/cli/python/workspace_hosts.js.map +0 -1
- package/dist/cli/python/workspace_inbox.js.map +0 -1
- package/dist/cli/python/workspace_render.js.map +0 -1
- package/dist/cli/python/workspace_roles.js.map +0 -1
- package/dist/cli/python/workspace_secrets.js.map +0 -1
- package/dist/cli/python/workspace_sessions.js.map +0 -1
- package/dist/cli/python/workspace_skills.js.map +0 -1
- package/dist/cli/registry.js.map +0 -1
- package/dist/install/agentSwitchDetection.js.map +0 -1
- package/dist/install/agentSwitchProfile.js.map +0 -1
- package/dist/install/atomic.js.map +0 -1
- package/dist/install/claudePathsPlan.js.map +0 -1
- package/dist/install/conflict.js.map +0 -1
- package/dist/install/detect.js.map +0 -1
- package/dist/install/emit_host_rules_cli.js.map +0 -1
- package/dist/install/globalRuleLayers.js.map +0 -1
- package/dist/install/hostLayerFingerprint.js.map +0 -1
- package/dist/install/partitionEligibility.js.map +0 -1
- package/dist/install/paths.js.map +0 -1
- package/dist/install/plan.js.map +0 -1
- package/dist/install/preflight.js.map +0 -1
- package/dist/install/rtkDetection.js.map +0 -1
- package/dist/install/ruleInScope.js.map +0 -1
- package/dist/install/ruleLayerPartition.js.map +0 -1
- package/dist/install/rule_scope.js.map +0 -1
- package/dist/install/rule_scope_cli.js.map +0 -1
- package/dist/install/selectedTools.js.map +0 -1
- package/dist/install/toolDetection.js.map +0 -1
- package/dist/install/txlog.js.map +0 -1
- package/dist/install/types.js.map +0 -1
- package/dist/install/wizard-plan.js.map +0 -1
- package/dist/install/wizardDismissals.js.map +0 -1
- package/dist/scripts/_lib/agent_settings.js.map +0 -1
- package/dist/scripts/_lib/agent_src.js.map +0 -1
- package/dist/scripts/_lib/claude_builtin_names.js.map +0 -1
- package/dist/scripts/_lib/claude_plugin.js.map +0 -1
- package/dist/scripts/_lib/claude_settings_hooks.js.map +0 -1
- package/dist/scripts/_lib/compile_time_toggles.js.map +0 -1
- package/dist/scripts/_lib/environment_detector.js.map +0 -1
- package/dist/scripts/_lib/host_launch.js.map +0 -1
- package/dist/scripts/_lib/install_layout.js.map +0 -1
- package/dist/scripts/_lib/installed_lock.js.map +0 -1
- package/dist/scripts/_lib/model_tier.js.map +0 -1
- package/dist/scripts/_lib/prune_empty_dirs.js.map +0 -1
- package/dist/scripts/_lib/scoped_projection.js.map +0 -1
- package/dist/scripts/_lib/script_output.js.map +0 -1
- package/dist/scripts/_lib/spawn_env.js.map +0 -1
- package/dist/scripts/_lib/surface_tiers.js.map +0 -1
- package/dist/scripts/_lib/token_count.js.map +0 -1
- package/dist/scripts/_lib/trigger_eval_floors.js.map +0 -1
- package/dist/scripts/_lib/user_global_paths.js.map +0 -1
- package/dist/scripts/ai_council/modes.js.map +0 -1
- package/dist/scripts/ai_council/transport_resolver.js.map +0 -1
- package/dist/scripts/condense.js.map +0 -1
- package/dist/scripts/project_thin_rules.js.map +0 -1
- package/dist/server/app.js.map +0 -1
- package/dist/server/io/atomicMultiWrite.js.map +0 -1
- package/dist/server/io/atomicWrite.js.map +0 -1
- package/dist/server/io/sharedWriteCheck.js.map +0 -1
- package/dist/server/io/substituteTemplate.js.map +0 -1
- package/dist/server/io/yamlIO.js.map +0 -1
- package/dist/server/nicknameResolver.js.map +0 -1
- package/dist/server/port.js.map +0 -1
- package/dist/server/routes/discovery.js.map +0 -1
- package/dist/server/routes/install.js.map +0 -1
- package/dist/server/routes/ping.js.map +0 -1
- package/dist/server/routes/schema.js.map +0 -1
- package/dist/server/routes/settings.js.map +0 -1
- package/dist/server/routes/settingsChanges.js.map +0 -1
- package/dist/server/routes/userMd.js.map +0 -1
- package/dist/server/routes/wizard.js.map +0 -1
- package/dist/server/routes/workspace.js.map +0 -1
- package/dist/server/schemas/settings.js.map +0 -1
- package/dist/server/serverInfo.js.map +0 -1
- package/dist/server/token.js.map +0 -1
- package/dist/server/writeRoot.js.map +0 -1
- package/dist/shared/capabilities.js.map +0 -1
- package/dist/shared/interactiveContext.js.map +0 -1
- package/dist/shared/nicknamePrefill.js.map +0 -1
- package/dist/shared/settingsAsks.js.map +0 -1
- package/dist/shared/settingsCarveOut.js.map +0 -1
- package/dist/shared/settingsClasses.js.map +0 -1
- package/dist/shared/settingsConsent.js.map +0 -1
- package/dist/shared/settingsSurface.js.map +0 -1
- package/dist/shared/userMd/formAdapter.js.map +0 -1
- package/dist/shared/userMd/schema.js.map +0 -1
- package/dist/shared/userMd/utils.js.map +0 -1
- package/dist/ui/assets/index-Cxgy63kz.js.map +0 -1
- package/src/scripts/_lib/adr_frontmatter.test.ts +0 -365
- package/src/scripts/_lib/adversarial_council_gate.test.ts +0 -112
- package/src/scripts/_lib/adversarial_reconcile.test.ts +0 -197
- package/src/scripts/_lib/auto_dispatch.corpus.test.ts +0 -150
- package/src/scripts/_lib/secret_detector.test.ts +0 -108
- package/src/scripts/_lib/secret_detector_adversarial.test.ts +0 -116
- package/src/scripts/_lib/untrusted_content.test.ts +0 -175
- package/src/scripts/check_secret_leak.test.ts +0 -90
- package/src/scripts/design_slop_rules.test.ts +0 -239
- package/src/scripts/self_review_gate.test.ts +0 -296
- package/src/shared/capabilities.test.ts +0 -43
|
@@ -12,6 +12,13 @@ trust:
|
|
|
12
12
|
install:
|
|
13
13
|
default: false
|
|
14
14
|
removable: true
|
|
15
|
+
scope:
|
|
16
|
+
write:
|
|
17
|
+
- pattern: "components/ui/**"
|
|
18
|
+
access: "create"
|
|
19
|
+
- pattern: "components.json"
|
|
20
|
+
access: "write"
|
|
21
|
+
verification_command: "npx shadcn@latest add <component> --dry-run"
|
|
15
22
|
execution:
|
|
16
23
|
type: assisted
|
|
17
24
|
handler: shell
|
|
@@ -47,7 +54,14 @@ block above:
|
|
|
47
54
|
|
|
48
55
|
## Compatibility
|
|
49
56
|
|
|
50
|
-
- **Tested against:** `shadcn@
|
|
57
|
+
- **Tested against:** `shadcn@4`, Tailwind CSS `4.x`, React `19`, primitives from
|
|
58
|
+
`@base-ui/react@1`, `components.json` style `base-nova` — every major read out
|
|
59
|
+
of `tests/fixtures/stack/shadcn-current/package.json`, the verbatim output of
|
|
60
|
+
`npx shadcn@latest init -d --template vite` on 2026-08-24. No version on this
|
|
61
|
+
line may be stated from prose; move it only by re-running that scaffold and
|
|
62
|
+
re-committing the fixture.
|
|
63
|
+
- Tailwind `3.x` and Radix primitives stay supported through the **v3 branch**
|
|
64
|
+
under § Gotcha — the CLI moved on, existing projects did not.
|
|
51
65
|
- The audit step (`directives/ui/audit.ts`) reads the line above and
|
|
52
66
|
compares it with `state.ui_audit.shadcn_inventory.version`; a major
|
|
53
67
|
mismatch triggers a soft halt before this skill runs.
|
|
@@ -56,8 +70,8 @@ block above:
|
|
|
56
70
|
|
|
57
71
|
Use when `state.stack.frontend == "react-shadcn"` and `directives/ui/apply.ts`,
|
|
58
72
|
`review.ts`, or `polish.ts` dispatches to this skill, or when a React project
|
|
59
|
-
clearly uses shadcn/ui (presence of `components.json`, `@
|
|
60
|
-
|
|
73
|
+
clearly uses shadcn/ui (presence of `components.json`, a `@base-ui/react` or
|
|
74
|
+
`@radix-ui/*` dependency, a `components/ui/` folder of generated primitives).
|
|
61
75
|
|
|
62
76
|
Do NOT use when:
|
|
63
77
|
- Project is Blade + Livewire + Flux (use `flux` / `livewire` / `blade-ui`).
|
|
@@ -75,13 +89,23 @@ Do NOT use when:
|
|
|
75
89
|
writes `state.ui_audit.shadcn_inventory` with the detected version —
|
|
76
90
|
when it diverges by a major, audit emits a soft halt before this
|
|
77
91
|
skill runs.
|
|
78
|
-
- shadcn/ui composes
|
|
79
|
-
|
|
92
|
+
- shadcn/ui composes a primitive vendor — `@base-ui/react` in a CLI-4 scaffold,
|
|
93
|
+
`@radix-ui/*` in older projects. Accessibility is built in either way, but
|
|
94
|
+
only when the wrapper components are used correctly (`asChild`,
|
|
80
95
|
`<DialogTrigger>` instead of a bare `<button>`).
|
|
81
|
-
- Tailwind tokens
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
96
|
+
- **Tailwind tokens: branch on the `css` axis, never guess.** `detect_stack()`
|
|
97
|
+
emits `axes.css` as `tailwind-v4` or `tailwind-v3`
|
|
98
|
+
(`work_engine/stack/detect.ts:521-524`); `existing-ui-audit` reads tokens on
|
|
99
|
+
the same key.
|
|
100
|
+
- `tailwind-v4` — **no config file exists.** Tokens live in the `@theme` block
|
|
101
|
+
of the entry CSS named by `components.json` → `tailwind.css`, and that file's
|
|
102
|
+
`"tailwind": {"config": ""}` — an empty `config` string — IS the v4 marker.
|
|
103
|
+
Never write `tailwind.config.{js,ts}` in a v4 project.
|
|
104
|
+
- `tailwind-v3` — tokens come from `tailwind.config.{js,ts}`
|
|
105
|
+
(`theme.extend.colors`).
|
|
106
|
+
- Either branch — CSS custom properties on `:root` and `.dark`
|
|
107
|
+
(`--background`, `--foreground`, `--primary`, `--ring`, …). Audit writes them
|
|
108
|
+
into `state.ui_audit.design_tokens`. Use those tokens; never hardcode values.
|
|
85
109
|
- Dark mode is class-based (`<html class="dark">`). Every color must come
|
|
86
110
|
from `bg-background`, `text-foreground`, etc. — never raw `bg-white`.
|
|
87
111
|
- Every interactive primitive must declare a focus-visible state via
|
|
@@ -164,6 +188,40 @@ registries / install-with-natural-language over MCP; configure per the
|
|
|
164
188
|
dependency. Decision note: **CLI path = default + universal; MCP path = opt-in
|
|
165
189
|
when the user has it configured; registry-JSON literacy underpins both.**
|
|
166
190
|
|
|
191
|
+
## Publish a registry — the library as a source others install from
|
|
192
|
+
|
|
193
|
+
The sections above **consume** a registry. This one **publishes** one: a component library in
|
|
194
|
+
this repository can expose its own components the same way, so a consumer installs them with
|
|
195
|
+
the tool they already use instead of copying files.
|
|
196
|
+
|
|
197
|
+
1. **Author `registry.json`** at the library root — the index — and one
|
|
198
|
+
`registry-item.json` per exposed component, each naming its files, its
|
|
199
|
+
`registryDependencies`, and its `cssVars` when it carries token requirements.
|
|
200
|
+
2. **Build** to `public/r` with the registry build command. **The installer gate applies
|
|
201
|
+
here exactly as it does to `add`**: propose it, run `--dry-run` first, and let the user
|
|
202
|
+
confirm. A build writes files, so nothing about it being "our own" registry lifts the
|
|
203
|
+
gate.
|
|
204
|
+
3. **The consumer adds a `registries` map entry** pointing at the published index; from then
|
|
205
|
+
on `@ns/item` resolves through it.
|
|
206
|
+
|
|
207
|
+
**Two registry item types are FORBIDDEN**, deprecated in v4: `registry:build` and
|
|
208
|
+
`registry:mcp`. Use **`registry:base`** and **`registry:font`** instead. Writing either
|
|
209
|
+
deprecated type produces an item the current CLI does not understand, and the failure surfaces
|
|
210
|
+
at the consumer rather than at authoring time.
|
|
211
|
+
|
|
212
|
+
**`dependencies` in a registry item never names `react` or `react-dom`.** They are peers of
|
|
213
|
+
the consuming app, and a registry item that installs its own copy reproduces the "invalid hook
|
|
214
|
+
call" failure one layer up — see
|
|
215
|
+
[`js-library-packaging`](../js-library-packaging/SKILL.md). `check_package_surface` enforces
|
|
216
|
+
this over a registry file.
|
|
217
|
+
|
|
218
|
+
> **Provenance.** The registry-publishing shape and the deprecated-type list come from an
|
|
219
|
+
> external plugin reference's component-CLI skill, read at a pinned revision. The source is
|
|
220
|
+
> deliberately not named here, per
|
|
221
|
+
> [`source-confidentiality`](../../rules/source-confidentiality.md): a shipped artifact does
|
|
222
|
+
> not carry derivation attribution to a named external project. The identifier and revision
|
|
223
|
+
> stay with the maintainer-side record.
|
|
224
|
+
|
|
167
225
|
## Procedure: render a shadcn/ui component for the design brief
|
|
168
226
|
|
|
169
227
|
### Step 0: Inspect
|
|
@@ -202,12 +260,12 @@ when the user has it configured; registry-JSON literacy underpins both.**
|
|
|
202
260
|
`bg-primary text-primary-foreground`, `text-muted-foreground`. No
|
|
203
261
|
`bg-white` / `text-black` / hardcoded `#fff`.
|
|
204
262
|
2. Spacing / radius from theme tokens (`rounded-lg` mapped to `--radius`
|
|
205
|
-
in `tailwind.config.{js,ts}`
|
|
206
|
-
when a token
|
|
263
|
+
— in the `@theme` block on `tailwind-v4`, in `tailwind.config.{js,ts}` on
|
|
264
|
+
`tailwind-v3`). Polish refactors hardcoded values when a token exists.
|
|
207
265
|
3. Dark mode: never branch on a `dark` prop; rely on the `.dark` class
|
|
208
266
|
on the root and semantic tokens.
|
|
209
267
|
4. Every interactive primitive: keyboard trigger present (Enter/Space
|
|
210
|
-
on buttons, Esc on dialogs —
|
|
268
|
+
on buttons, Esc on dialogs — free from the primitive vendor), focus ring,
|
|
211
269
|
`aria-label` from `state.ui_design.a11y` when icon-only.
|
|
212
270
|
|
|
213
271
|
### Step 3: State coverage
|
|
@@ -277,27 +335,17 @@ current state on the next polish round.
|
|
|
277
335
|
|
|
278
336
|
When `DESIGN.md` declares `## Taste Dials`, honour them: Variance → layout-family spread + asymmetry tolerance; Motion → animation budget + reduced-motion posture; Density → spacing scale + information-per-viewport. Absent → follow the design brief's inferred dials.
|
|
279
337
|
|
|
280
|
-
## Component workshop (Storybook) —
|
|
281
|
-
|
|
282
|
-
The
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
- **Story per reusable primitive, not per screen** — a story covers a component
|
|
292
|
-
and its states (default / loading / empty / error / dark), mirroring the
|
|
293
|
-
Step 3 state-coverage matrix. Screens are composed, not story-fied.
|
|
294
|
-
- **Reuse the token layer** — stories render under the same semantic tokens +
|
|
295
|
-
`.dark` class; never hardcode a preview theme (same token discipline as Step 2).
|
|
296
|
-
- **A11y in-workshop** — run the a11y addon so the isolation catches contrast /
|
|
297
|
-
role / focus issues before the component reaches a screen.
|
|
298
|
-
- Do NOT let stories drift from the component API — a story that props-drills
|
|
299
|
-
values the component no longer accepts is stale documentation; keep them beside
|
|
300
|
-
the component and update them in the same change.
|
|
338
|
+
## Component workshop (Storybook) — pointer
|
|
339
|
+
|
|
340
|
+
The workshop discipline (one concept per story, `@summary` on every export, stories run as
|
|
341
|
+
tests, the `!manifest` tag, the opt-in MCP channel) lives in
|
|
342
|
+
[`storybook-workshop`](../storybook-workshop/SKILL.md). It is stack-agnostic and was lifted
|
|
343
|
+
out of here rather than duplicated beside it.
|
|
344
|
+
|
|
345
|
+
What stays React-specific and therefore stays here: the state-coverage matrix in Step 3 that
|
|
346
|
+
the story set is derived from, the token discipline of Step 2 that stories render under, and
|
|
347
|
+
the `(rule, selector, severity)` a11y shape in § Review pass that the workshop's validate
|
|
348
|
+
step writes into.
|
|
301
349
|
|
|
302
350
|
## Security constraints
|
|
303
351
|
|
|
@@ -3,6 +3,9 @@ model_tier: high
|
|
|
3
3
|
name: readme-reviewer
|
|
4
4
|
description: "Use when reviewing a README for accuracy, usability, and alignment with the actual repository. Detects invented content, broken setup steps, and structural issues."
|
|
5
5
|
domain: quality
|
|
6
|
+
scope:
|
|
7
|
+
write: []
|
|
8
|
+
verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
|
|
6
9
|
execution:
|
|
7
10
|
type: assisted
|
|
8
11
|
handler: internal
|
|
@@ -3,6 +3,9 @@ model_tier: medium
|
|
|
3
3
|
name: readme-writing
|
|
4
4
|
description: "Use when creating, rewriting, or significantly improving a README based on the actual repository structure, commands, and intended audience."
|
|
5
5
|
domain: process
|
|
6
|
+
scope:
|
|
7
|
+
write: []
|
|
8
|
+
verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
|
|
6
9
|
execution:
|
|
7
10
|
type: assisted
|
|
8
11
|
handler: internal
|
|
@@ -3,6 +3,9 @@ model_tier: medium
|
|
|
3
3
|
name: readme-writing-package
|
|
4
4
|
description: "Use when creating or rewriting a README for a reusable package or library. Focus on installability, minimal usage example, compatibility, and developer onboarding."
|
|
5
5
|
domain: process
|
|
6
|
+
scope:
|
|
7
|
+
write: []
|
|
8
|
+
verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
|
|
6
9
|
execution:
|
|
7
10
|
type: assisted
|
|
8
11
|
handler: internal
|
|
@@ -122,7 +122,7 @@ For each comment classified as blocking/important:
|
|
|
122
122
|
|
|
123
123
|
Run the relevant tests and linters **between** each group — do not
|
|
124
124
|
batch four changes and then run tests once. See
|
|
125
|
-
[`verify-
|
|
125
|
+
[`verify-completion-evidence`](../verify-completion-evidence/SKILL.md).
|
|
126
126
|
|
|
127
127
|
## Output format
|
|
128
128
|
|
|
@@ -181,7 +181,7 @@ When reporting back to the user after handling review:
|
|
|
181
181
|
* Executing the fixes across many comments → [`fix-pr-comments`](../../commands/fix-pr-comments.md)
|
|
182
182
|
(handles both bot + human reviewers in one pass)
|
|
183
183
|
* Running the full verification gate before pushing replies →
|
|
184
|
-
[`verify-
|
|
184
|
+
[`verify-completion-evidence`](../verify-completion-evidence/SKILL.md)
|
|
185
185
|
* Writing the commit message that references the review →
|
|
186
186
|
[`conventional-commits-writing`](../conventional-commits-writing/SKILL.md)
|
|
187
187
|
* Digging into *why* the reviewer's scenario actually fails →
|
|
@@ -7,6 +7,9 @@ personas:
|
|
|
7
7
|
- senior-engineer
|
|
8
8
|
- ai-agent
|
|
9
9
|
domain: product
|
|
10
|
+
scope:
|
|
11
|
+
write: []
|
|
12
|
+
verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
|
|
10
13
|
execution:
|
|
11
14
|
type: assisted
|
|
12
15
|
handler: internal
|
|
@@ -10,6 +10,9 @@ personas:
|
|
|
10
10
|
- critical-challenger
|
|
11
11
|
- ai-agent
|
|
12
12
|
domain: product
|
|
13
|
+
scope:
|
|
14
|
+
write: []
|
|
15
|
+
verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
|
|
13
16
|
execution:
|
|
14
17
|
type: assisted
|
|
15
18
|
handler: internal
|
|
@@ -60,7 +60,7 @@ Before asking anyone else:
|
|
|
60
60
|
* Check for secrets in diff — API keys, connection strings, tokens
|
|
61
61
|
* Check file-system side effects — generated files, lockfile churn,
|
|
62
62
|
IDE configs, `.env` changes
|
|
63
|
-
* Run the linter + tests (see [`verify-
|
|
63
|
+
* Run the linter + tests (see [`verify-completion-evidence`](../verify-completion-evidence/SKILL.md))
|
|
64
64
|
* If you find issues → fix them, do **not** ship them and hope the
|
|
65
65
|
reviewer flags them
|
|
66
66
|
|
|
@@ -192,7 +192,7 @@ When handing the review request to the reviewer (PR body, Slack, email):
|
|
|
192
192
|
* Actually opening the PR → [`create-pr`](../../commands/create-pr.md)
|
|
193
193
|
* Writing the commits themselves → [`commit`](../../commands/commit.md),
|
|
194
194
|
[`conventional-commits-writing`](../conventional-commits-writing/SKILL.md)
|
|
195
|
-
* Verifying readiness → [`verify-
|
|
195
|
+
* Verifying readiness → [`verify-completion-evidence`](../verify-completion-evidence/SKILL.md)
|
|
196
196
|
* Processing the feedback when it arrives → [`receiving-code-review`](../receiving-code-review/SKILL.md)
|
|
197
197
|
|
|
198
198
|
## Validation checklist
|
|
@@ -31,7 +31,7 @@ Do NOT use when:
|
|
|
31
31
|
- The diff is low-risk and no ownership map exists — fall back to the
|
|
32
32
|
common role vocabulary below.
|
|
33
33
|
- A full PR description is requested — route to
|
|
34
|
-
[
|
|
34
|
+
[`/pr:create:description-only`](../../domains/git/pr/create/description-only/command.md) and let
|
|
35
35
|
it call this skill for the routing block.
|
|
36
36
|
- A threat model is wanted — route to
|
|
37
37
|
[`threat-modeling`](../threat-modeling/SKILL.md).
|
|
@@ -210,6 +210,6 @@ Data source: <"ownership-map.yml + historical-bug-patterns.yml"
|
|
|
210
210
|
|
|
211
211
|
- [`reviewer-awareness`](../../rules/reviewer-awareness.md) — the rule that routes here: anchor reviewer choice in paths and risk, never seniority
|
|
212
212
|
- [`review-routing-data-format`](../../../docs/guidelines/agent-infra/review-routing-data-format.md)
|
|
213
|
-
- [
|
|
213
|
+
- [`/pr:create:description-only`](../../domains/git/pr/create/description-only/command.md)
|
|
214
214
|
- [`judge-test-coverage`](../judge-test-coverage/SKILL.md) — consumes
|
|
215
215
|
the `required_test` entries from matched patterns.
|
|
@@ -51,8 +51,18 @@ dashboard-sync axis stays in `roadmap-management`.
|
|
|
51
51
|
Authoring or materially rewriting a roadmap must go through
|
|
52
52
|
Understand → Research → Draft per the
|
|
53
53
|
[`artifact-drafting-protocol`](../../rules/artifact-drafting-protocol.md)
|
|
54
|
-
rule.
|
|
55
|
-
|
|
54
|
+
rule. **Run the probe, do not eyeball the directory:**
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
agent-config roadmap:context
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
It reports sibling roadmaps on the same topic across all four roadmap
|
|
61
|
+
directories, inbox notes, and open PRs on the cited paths — the semantic axis a
|
|
62
|
+
filename scan cannot see. Each hit becomes one `relates:` row
|
|
63
|
+
(`extends` / `supersedes` / `depends` / `disjoint`, template rule 18); zero hits
|
|
64
|
+
becomes `relates: []` carrying the probe's `scanned:` line as its
|
|
65
|
+
justification. **Gate C first** — "write a
|
|
56
66
|
plan/roadmap" is a gated surface, so run
|
|
57
67
|
[`plan-confidence-gate`](../../contexts/execution/plan-confidence-gate.md)
|
|
58
68
|
before drafting (95%-conditions, marker, interview-or-degrade, C→R1 handoff).
|
|
@@ -218,45 +228,12 @@ preferred.
|
|
|
218
228
|
|
|
219
229
|
When a parent roadmap closes with `[~]` items, the
|
|
220
230
|
[`roadmap-management`](../roadmap-management/SKILL.md) skill spawns a
|
|
221
|
-
follow-up. Authors and reviewers must know the shape so they can
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
status: draft # optional — draft hides from dashboard
|
|
228
|
-
parent_roadmap: <parent-slug> # back-link to the archived source
|
|
229
|
-
---
|
|
230
|
-
|
|
231
|
-
# Roadmap: Follow-up to <parent-title>
|
|
232
|
-
|
|
233
|
-
> <One sentence: carried-over outcome.>
|
|
234
|
-
|
|
235
|
-
## Context
|
|
236
|
-
|
|
237
|
-
This roadmap collects items deferred from
|
|
238
|
-
[`agents/roadmaps/archive/<parent-slug>.md`](../archive/<parent-slug>.md).
|
|
239
|
-
{ … original phases preserved verbatim … }
|
|
240
|
-
|
|
241
|
-
<!-- For option 2 (ready + blocked), add this as a body note, NOT in frontmatter: -->
|
|
242
|
-
> Blocked until <condition>. Execution starts when the condition clears.
|
|
243
|
-
```
|
|
244
|
-
|
|
245
|
-
Two states the author picks between (mirrors the Iron Law 3
|
|
246
|
-
numbered-options block in [`roadmap-progress-sync`](../../rules/roadmap-progress-sync.md)):
|
|
247
|
-
|
|
248
|
-
- **`status: draft`** → hidden from `agents/roadmaps-progress.md`
|
|
249
|
-
until flipped. Use for items the user wants captured but not
|
|
250
|
-
surfaced to the active backlog yet.
|
|
251
|
-
- **`status: ready` (default; omit the key)** plus body
|
|
252
|
-
`> Blocked until …` note → visible in the dashboard, execution
|
|
253
|
-
gated by the documented condition. The blocking is a body
|
|
254
|
-
convention, not enforced by the dashboard generator — readers
|
|
255
|
-
honor the note.
|
|
256
|
-
|
|
257
|
-
The follow-up roadmap is **not** authored from scratch — the
|
|
258
|
-
deferred steps are copied verbatim (with their phase context). This
|
|
259
|
-
preserves the plan exactly as the author originally wrote it.
|
|
231
|
+
follow-up. Authors and reviewers must know the shape so they can recognise it:
|
|
232
|
+
the frontmatter template, the two states the author picks between
|
|
233
|
+
(`status: draft`, hidden from the dashboard, vs the default `status: ready`
|
|
234
|
+
plus a body `> Blocked until …` note), and the rule that deferred steps are
|
|
235
|
+
copied verbatim rather than re-authored →
|
|
236
|
+
[`references/follow-up-roadmap-shape.md`](references/follow-up-roadmap-shape.md).
|
|
260
237
|
|
|
261
238
|
### 8. Source-derived & capability-adoption roadmaps (conditional)
|
|
262
239
|
|
|
@@ -311,6 +288,11 @@ to every roadmap you author.
|
|
|
311
288
|
3. Are checkboxes present in every non-intro phase?
|
|
312
289
|
4. Are exit criteria decidable, or vibe-based ("looks good")?
|
|
313
290
|
5. Is content duplicated from another roadmap (supersession instead)?
|
|
291
|
+
5b. Does the frontmatter carry a `relates:` block — one row per probe hit with
|
|
292
|
+
an `extends`/`supersedes`/`depends`/`disjoint` relation, or an explicit
|
|
293
|
+
`relates: []` whose note carries the probe's `scanned:` line? A `relates:`
|
|
294
|
+
list written by reflex is worse than none: the empty case must be genuinely
|
|
295
|
+
empty, not unexamined.
|
|
314
296
|
6. Any human-gate steps or sign-off phases (§ 4c violation) —
|
|
315
297
|
agent-verifiable check or structured blocker instead?
|
|
316
298
|
7. *Source-derived/adoption only (§ 8):* is there a `KEEP`/`FOLD`/`CUT`
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# roadmap-writing — follow-up roadmap shape
|
|
2
|
+
|
|
3
|
+
> Mode body of the [`roadmap-writing`](../SKILL.md) skill (router-head
|
|
4
|
+
> retrofit, 2026-08-23 — SKILL.md reached the K6 400-line cap). Content moved
|
|
5
|
+
> VERBATIM from SKILL.md § 7; load this file when § 7 routes here.
|
|
6
|
+
|
|
7
|
+
When a parent roadmap closes with `[~]` items, the
|
|
8
|
+
[`roadmap-management`](../../roadmap-management/SKILL.md) skill spawns a
|
|
9
|
+
follow-up. Authors and reviewers must know the shape so they can
|
|
10
|
+
recognise it:
|
|
11
|
+
|
|
12
|
+
```markdown
|
|
13
|
+
---
|
|
14
|
+
complexity: lightweight
|
|
15
|
+
status: draft # optional — draft hides from dashboard
|
|
16
|
+
parent_roadmap: <parent-slug> # back-link to the archived source
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# Roadmap: Follow-up to <parent-title>
|
|
20
|
+
|
|
21
|
+
> <One sentence: carried-over outcome.>
|
|
22
|
+
|
|
23
|
+
## Context
|
|
24
|
+
|
|
25
|
+
This roadmap collects items deferred from
|
|
26
|
+
[`agents/roadmaps/archive/<parent-slug>.md`](../archive/<parent-slug>.md).
|
|
27
|
+
{ … original phases preserved verbatim … }
|
|
28
|
+
|
|
29
|
+
<!-- For option 2 (ready + blocked), add this as a body note, NOT in frontmatter: -->
|
|
30
|
+
> Blocked until <condition>. Execution starts when the condition clears.
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Two states the author picks between (mirrors the Iron Law 3
|
|
34
|
+
numbered-options block in [`roadmap-progress-sync`](../../../rules/roadmap-progress-sync.md)):
|
|
35
|
+
|
|
36
|
+
- **`status: draft`** → hidden from `agents/roadmaps-progress.md`
|
|
37
|
+
until flipped. Use for items the user wants captured but not
|
|
38
|
+
surfaced to the active backlog yet.
|
|
39
|
+
- **`status: ready` (default; omit the key)** plus body
|
|
40
|
+
`> Blocked until …` note → visible in the dashboard, execution
|
|
41
|
+
gated by the documented condition. The blocking is a body
|
|
42
|
+
convention, not enforced by the dashboard generator — readers
|
|
43
|
+
honor the note.
|
|
44
|
+
|
|
45
|
+
The follow-up roadmap is **not** authored from scratch — the
|
|
46
|
+
deferred steps are copied verbatim (with their phase context). This
|
|
47
|
+
preserves the plan exactly as the author originally wrote it.
|
|
@@ -3,6 +3,9 @@ model_tier: medium
|
|
|
3
3
|
name: rtk-output-filtering
|
|
4
4
|
description: "Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer, third-party Apache-2.0; upstream reports 60-90% token savings). Covers installation, configuration, and usage patterns."
|
|
5
5
|
domain: process
|
|
6
|
+
scope:
|
|
7
|
+
write: []
|
|
8
|
+
verification_reason: "this skill wraps another command's stdout; it has no output path of its own. Absence of a write is not something a command can prove."
|
|
6
9
|
execution:
|
|
7
10
|
type: assisted
|
|
8
11
|
handler: shell
|
|
@@ -28,12 +31,25 @@ commands through intelligent output filtering (whitespace, boilerplate,
|
|
|
28
31
|
comments, duplicate log messages). Single Rust binary, <10ms startup overhead.
|
|
29
32
|
**Third-party Apache-2.0 tool** (rtk-ai upstream — an external project, not part of this package).
|
|
30
33
|
|
|
31
|
-
**Savings,
|
|
32
|
-
"actual savings vary").
|
|
33
|
-
|
|
34
|
-
**
|
|
35
|
-
|
|
36
|
-
|
|
34
|
+
**Savings — STALE, and scoped. Do not quote the number without this label.**
|
|
35
|
+
Upstream reports 60-90% (their estimate — "actual savings vary").
|
|
36
|
+
agent-config's own figure is **33% overall, 0-57% per command**, and it is a
|
|
37
|
+
**single spot-measurement from 2026-07-28: one repo, one macOS machine, an
|
|
38
|
+
8-command corpus.** It has **not** been superseded by a wider run, and the
|
|
39
|
+
widened re-bench is **deferred** — `road-to-terminal-token-economy` steps
|
|
40
|
+
3.2-3.4. **The reason changed on 2026-08-23 and the label is updated with it:** the
|
|
41
|
+
original deferral was ordering (Phase 2 had not chosen the wrapper mechanism, so a
|
|
42
|
+
re-bench would measure the wrong subject). Phase 2 has now chosen — the existing
|
|
43
|
+
warn-only nudge — so that objection is discharged. What defers it now is the
|
|
44
|
+
re-bench's own registered design, which requires **at least two machines**, and only
|
|
45
|
+
one is reachable. A one-machine re-bench would reproduce exactly the narrowness the
|
|
46
|
+
widening exists to fix. AI council 2026-08-23, 2/2 convergent, on both readings.
|
|
47
|
+
|
|
48
|
+
Treat it as an order of magnitude for *that* corpus, never as this package's
|
|
49
|
+
general claim. Verbose commands (`git status`, `git log`, `ls -la`) save ~55%;
|
|
50
|
+
already-compact output (`--oneline`, `--stat`) passes through at ~0%, which is
|
|
51
|
+
why an overall percentage is meaningless without the corpus that produced it.
|
|
52
|
+
See `internal/bench/rtk-savings/RESULTS.md`.
|
|
37
53
|
|
|
38
54
|
**Docs:** https://www.mintlify.com/rtk-ai/rtk
|
|
39
55
|
**Repo:** https://github.com/rtk-ai/rtk
|
|
@@ -82,6 +82,31 @@ blocks:
|
|
|
82
82
|
target: negative
|
|
83
83
|
description: "Clichés to reject, load-bearing top-first."
|
|
84
84
|
|
|
85
|
+
# Chain directives — NOT one of the 12 blocks.
|
|
86
|
+
#
|
|
87
|
+
# A block above describes the shot. A chain directive describes how this scene
|
|
88
|
+
# JOINS ITS NEIGHBOUR, which is a property of the assembly, not of the prompt —
|
|
89
|
+
# so it is listed separately and the blueprint stays a 12-block IR everywhere
|
|
90
|
+
# else in the tree. `parse-blueprint.sh` accepts the label like any other and
|
|
91
|
+
# emits the value at the top level; the chain itself is read by
|
|
92
|
+
# `scripts/ai-video/lib/seam-plan.sh`, which this file's parser never sees.
|
|
93
|
+
chain_directives:
|
|
94
|
+
CONTINUITY:
|
|
95
|
+
required: false
|
|
96
|
+
target: continuity
|
|
97
|
+
default: cut
|
|
98
|
+
values: [cut, handoff, connector]
|
|
99
|
+
description: >
|
|
100
|
+
How this scene joins the PREVIOUS one. `cut` is a hard cut and is the
|
|
101
|
+
value assumed when the label is absent, so every blueprint written before
|
|
102
|
+
this directive existed keeps its exact meaning. `handoff` means this
|
|
103
|
+
scene's ref_images[0] is the extracted last frame of the previous scene's
|
|
104
|
+
RENDERED clip rather than its own still, which forces the two clips to
|
|
105
|
+
render sequentially. `connector` is a handoff plus one extra bridging
|
|
106
|
+
clip, and needs a probed `end_frame: true` on both adjacent models.
|
|
107
|
+
An unknown value is a parse error naming the value — never a silent
|
|
108
|
+
downgrade to `cut`.
|
|
109
|
+
|
|
85
110
|
# Adapter-contract JSON shape produced by parse-blueprint.sh
|
|
86
111
|
output_shape: |
|
|
87
112
|
{
|
|
@@ -102,6 +127,7 @@ output_shape: |
|
|
|
102
127
|
},
|
|
103
128
|
"duration": 5.0,
|
|
104
129
|
"negative": ["...", "..."],
|
|
130
|
+
"continuity": "cut" | "handoff" | "connector",
|
|
105
131
|
"requires": {
|
|
106
132
|
"audio_native": true | false
|
|
107
133
|
}
|