@event4u/agent-config 3.3.0 → 4.2.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/.agent-src/README.md +2 -2
- package/.agent-src/commands/agent-handoff.md +31 -2
- package/.agent-src/commands/agent-status.md +5 -5
- package/.agent-src/commands/agents/audit.md +8 -8
- package/.agent-src/commands/agents/init.md +25 -1
- package/.agent-src/commands/agents/optimize.md +3 -3
- package/.agent-src/commands/agents/user.md +1 -1
- package/.agent-src/commands/agents.md +1 -1
- package/.agent-src/commands/analyze-reference-repo.md +1 -1
- package/.agent-src/commands/check-current-md.md +8 -8
- package/.agent-src/commands/{compress.md → condense.md} +55 -55
- package/.agent-src/commands/context/create.md +7 -4
- package/.agent-src/commands/context/refactor.md +3 -1
- package/.agent-src/commands/feature/dev.md +1 -1
- package/.agent-src/commands/feature/explore.md +1 -1
- package/.agent-src/commands/feature/plan.md +10 -8
- package/.agent-src/commands/feature/refactor.md +3 -1
- package/.agent-src/commands/feature/roadmap.md +7 -4
- package/.agent-src/commands/fix/portability.md +3 -3
- package/.agent-src/commands/fix/refs.md +4 -4
- package/.agent-src/commands/ghostwriter.md +2 -2
- package/.agent-src/commands/memory/learn-low-impact.md +3 -3
- package/.agent-src/commands/module/explore.md +34 -8
- package/.agent-src/commands/optimize/agents-dir.md +9 -7
- package/.agent-src/commands/optimize/augmentignore.md +2 -2
- package/.agent-src/commands/optimize/skills.md +9 -9
- package/.agent-src/commands/post-as.md +1 -1
- package/.agent-src/commands/project-analyze.md +2 -2
- package/.agent-src/commands/project-health.md +3 -2
- package/.agent-src/commands/research/deep.md +1 -1
- package/.agent-src/commands/research/report.md +1 -1
- package/.agent-src/commands/research.md +1 -1
- package/.agent-src/commands/roadmap/ai-council.md +1 -1
- package/.agent-src/commands/roadmap/create.md +9 -4
- package/.agent-src/commands/rule-compliance-audit.md +1 -1
- package/.agent-src/commands/upstream-contribute.md +14 -14
- package/.agent-src/commands/video/from-script.md +1 -1
- package/.agent-src/commands/video/scene.md +1 -1
- package/.agent-src/commands/video/stitch.md +1 -1
- package/.agent-src/commands/video/storyboard.md +1 -1
- package/.agent-src/commands/video.md +1 -1
- package/.agent-src/contexts/augment-infrastructure.md +1 -1
- package/.agent-src/contexts/authority/commit-mechanics.md +15 -0
- package/.agent-src/contexts/authority/kernel-rule-edits.md +3 -3
- package/.agent-src/contexts/authority/scope-mechanics.md +1 -1
- package/.agent-src/contexts/communication/rules-auto/augment-source-of-truth-mechanics.md +28 -28
- package/.agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +4 -4
- package/.agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +2 -2
- package/.agent-src/contexts/contracts/artifact-engagement-flow.md +6 -6
- package/.agent-src/contexts/contracts/command-suggestion-flow.md +3 -3
- package/.agent-src/contexts/contracts/emergency-triage-block.md +4 -4
- package/.agent-src/contexts/contracts/frugality-charter.md +3 -3
- package/.agent-src/contexts/documentation-hierarchy.md +14 -7
- package/.agent-src/contexts/execution/autonomy-examples.md +1 -1
- package/.agent-src/contexts/execution/cheap-question-mechanics.md +39 -2
- package/.agent-src/contexts/execution/roadmap-process-loop.md +28 -5
- package/.agent-src/contexts/override-system.md +5 -5
- package/.agent-src/ghostwriter/fictional-fixture-v1.md +1 -1
- package/.agent-src/personas/advisors/first-principles.md +1 -1
- package/.agent-src/personas/hollywood-director.md +1 -1
- package/.agent-src/rules/architecture.md +5 -1
- package/.agent-src/rules/augment-edit-discipline.md +5 -5
- package/.agent-src/rules/augment-source-of-truth.md +15 -15
- package/.agent-src/rules/commit-conventions.md +1 -1
- package/.agent-src/rules/commit-policy.md +10 -0
- package/.agent-src/rules/domain-adoption-policy.md +3 -3
- package/.agent-src/rules/fast-path-marker-visibility.md +3 -3
- package/.agent-src/rules/finance-safety-floor.md +1 -1
- package/.agent-src/rules/framework-neutrality-in-generic-skills.md +8 -8
- package/.agent-src/rules/git-history-discipline.md +1 -1
- package/.agent-src/rules/improve-before-implement.md +2 -2
- package/.agent-src/rules/language-and-tone.md +2 -2
- package/.agent-src/rules/media-governance-routing.md +5 -5
- package/.agent-src/rules/no-attribution-footers.md +1 -0
- package/.agent-src/rules/no-cheap-questions.md +3 -0
- package/.agent-src/rules/no-decorative-emojis-in-git-surfaces.md +111 -0
- package/.agent-src/rules/no-pr-progress-comments.md +118 -0
- package/.agent-src/rules/no-roadmap-references.md +3 -3
- package/.agent-src/rules/non-destructive-by-default.md +1 -1
- package/.agent-src/rules/persona-governance.md +3 -3
- package/.agent-src/rules/preservation-guard.md +15 -15
- package/.agent-src/rules/roadmap-ci-steps-policy.md +7 -3
- package/.agent-src/rules/rule-type-governance.md +1 -1
- package/.agent-src/rules/skill-quality.md +1 -1
- package/.agent-src/rules/{caveman-speak.md → telegraph-speak.md} +15 -15
- package/.agent-src/rules/token-optimizer-maintenance.md +6 -6
- package/.agent-src/skills/agent-docs-writing/SKILL.md +17 -11
- package/.agent-src/skills/agents-md-thin-root/SKILL.md +9 -9
- package/.agent-src/skills/check-refs/SKILL.md +2 -2
- package/.agent-src/skills/code-refactoring/SKILL.md +2 -2
- package/.agent-src/skills/command-writing/SKILL.md +19 -19
- package/.agent-src/skills/comp-banding/SKILL.md +1 -1
- package/.agent-src/skills/condense-memory/SKILL.md +131 -0
- package/.agent-src/skills/context-authoring/SKILL.md +2 -2
- package/.agent-src/skills/context-document/SKILL.md +5 -3
- package/.agent-src/skills/copilot-agents-optimization/SKILL.md +3 -3
- package/.agent-src/skills/description-assist/SKILL.md +2 -2
- package/.agent-src/skills/git-workflow/SKILL.md +1 -1
- package/.agent-src/skills/guideline-writing/SKILL.md +5 -5
- package/.agent-src/skills/learning-to-rule-or-skill/SKILL.md +4 -4
- package/.agent-src/skills/lint-skills/SKILL.md +3 -3
- package/.agent-src/skills/md-language-check/SKILL.md +2 -2
- package/.agent-src/skills/module-detect-on-the-fly/SKILL.md +138 -0
- package/.agent-src/skills/module-management/SKILL.md +166 -94
- package/.agent-src/skills/override-management/SKILL.md +1 -1
- package/.agent-src/skills/persona-writing/SKILL.md +5 -5
- package/.agent-src/skills/positioning-strategy/SKILL.md +1 -1
- package/.agent-src/skills/project-docs/SKILL.md +6 -4
- package/.agent-src/skills/readme-reviewer/SKILL.md +2 -2
- package/.agent-src/skills/roadmap-management/SKILL.md +13 -1
- package/.agent-src/skills/roadmap-writing/SKILL.md +4 -2
- package/.agent-src/skills/rule-refactor/SKILL.md +5 -5
- package/.agent-src/skills/rule-writing/SKILL.md +18 -18
- package/.agent-src/skills/script-writing/SKILL.md +1 -1
- package/.agent-src/skills/skill-improvement-pipeline/SKILL.md +6 -6
- package/.agent-src/skills/skill-management/SKILL.md +21 -21
- package/.agent-src/skills/skill-reviewer/SKILL.md +2 -2
- package/.agent-src/skills/skill-writing/SKILL.md +8 -8
- package/.agent-src/skills/skill-writing/evals/triggers.json +1 -1
- package/.agent-src/skills/token-optimizer/SKILL.md +4 -4
- package/.agent-src/skills/unit-economics-modeling/SKILL.md +1 -1
- package/.agent-src/skills/upstream-contribute/SKILL.md +17 -17
- package/.agent-src/templates/AGENTS.md +1 -0
- package/.agent-src/templates/agent-settings.md +24 -13
- package/.agent-src/templates/agents/agent-project-settings.example.yml +61 -2
- package/.agent-src/templates/command.md +5 -5
- package/.agent-src/templates/contexts.md +1 -1
- package/.agent-src/templates/copilot-instructions.md +8 -8
- package/.agent-src/templates/features.md +1 -1
- package/.agent-src/templates/hooks/pre-commit-frontmatter +2 -2
- package/.agent-src/templates/hooks/pre-commit-roadmap-progress +3 -3
- package/.agent-src/templates/persona.md +2 -2
- package/.agent-src/templates/roadmaps.md +1 -1
- package/.agent-src/templates/rule.md +13 -13
- package/.agent-src/templates/scripts/memory_lookup.py +1 -1
- package/.agent-src/templates/scripts/memory_status.py +2 -2
- package/.agent-src/templates/scripts/work_engine/_lib/agent_settings.py +195 -1
- package/.agent-src/templates/scripts/work_engine/orchestration.py +1 -1
- package/.agent-src/templates/skill-archive-note.md +5 -5
- package/.agent-src/templates/skill.md +1 -1
- package/.claude-plugin/marketplace.json +4 -4
- package/AGENTS.md +16 -17
- package/CHANGELOG.md +216 -3
- package/CONTRIBUTING.md +31 -12
- package/README.md +21 -12
- package/config/agent-settings.template.yml +22 -2
- package/config/discovery/unassigned-artefacts.yml +24 -24
- package/config/profiles/full.ini +1 -1
- package/dist/cli/agent-config.js +52 -3
- package/dist/cli/agent-config.js.map +1 -1
- package/dist/cli/commands/uiServe.js +9 -0
- package/dist/cli/commands/uiServe.js.map +1 -1
- package/dist/cli/registry.js +2 -1
- package/dist/cli/registry.js.map +1 -1
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +649 -606
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +4 -4
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +439 -437
- package/dist/discovery/trust-report.md +5 -5
- package/dist/discovery/workspaces.json +450 -448
- package/dist/install/atomic.js +92 -0
- package/dist/install/atomic.js.map +1 -0
- package/dist/install/conflict.js +196 -0
- package/dist/install/conflict.js.map +1 -0
- package/dist/install/detect.js +218 -0
- package/dist/install/detect.js.map +1 -0
- package/dist/install/paths.js +82 -0
- package/dist/install/paths.js.map +1 -0
- package/dist/install/plan.js +157 -0
- package/dist/install/plan.js.map +1 -0
- package/dist/install/txlog.js +140 -0
- package/dist/install/txlog.js.map +1 -0
- package/dist/install/types.js +19 -0
- package/dist/install/types.js.map +1 -0
- package/dist/install/wizard-plan.js +184 -0
- package/dist/install/wizard-plan.js.map +1 -0
- package/dist/mcp/registry-manifest.json +4 -4
- package/dist/router.json +67 -19
- package/dist/server/app.js +6 -0
- package/dist/server/app.js.map +1 -1
- package/dist/server/routes/install.js +358 -0
- package/dist/server/routes/install.js.map +1 -0
- package/dist/server/routes/wizard.js +468 -32
- package/dist/server/routes/wizard.js.map +1 -1
- package/dist/server/routes/workspace.js +396 -0
- package/dist/server/routes/workspace.js.map +1 -0
- package/dist/server/schemas/settings.js +5 -3
- package/dist/server/schemas/settings.js.map +1 -1
- package/dist/ui/assets/index-BDAhhpDV.js +40 -0
- package/dist/ui/assets/index-BDAhhpDV.js.map +1 -0
- package/dist/ui/assets/index-BXZILUxe.css +1 -0
- package/dist/ui/index.html +2 -2
- package/docs/MIGRATION.md +1 -1
- package/docs/adrs/cost/0001-hard-stop-hook.md +1 -1
- package/docs/adrs/router/0001-three-tier-routing.md +4 -4
- package/docs/adrs/schema/0001-json-schema-frontmatter.md +1 -1
- package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +4 -4
- package/docs/adrs/{caveman → telegraph}/0001-default-off-until-bench.md +9 -9
- package/docs/adrs/telegraph/README.md +9 -0
- package/docs/architecture/augment-projection.md +4 -4
- package/docs/architecture/claude-bundle.md +1 -1
- package/docs/architecture/current-onboard-baseline.md +3 -3
- package/docs/architecture/multi-tool-projection.md +10 -10
- package/docs/architecture/source-projection.md +27 -27
- package/docs/architecture.md +19 -15
- package/docs/archive/CHANGELOG-pre-2.11.0.md +2 -2
- package/docs/archive/CHANGELOG-pre-2.15.0.md +3 -3
- package/docs/archive/CHANGELOG-pre-2.16.0.md +1 -1
- package/docs/archive/CHANGELOG-pre-2.2.0.md +70 -70
- package/docs/archive/CHANGELOG-pre-2.20.0.md +2 -2
- package/docs/archive/CHANGELOG-pre-2.25.0.md +15 -15
- package/docs/archive/CHANGELOG-pre-3.0.0.md +4 -4
- package/docs/archive/CHANGELOG-pre-3.1.0.md +2 -2
- package/docs/archive/CHANGELOG-pre-3.2.0.md +3 -3
- package/docs/benchmark.md +65 -0
- package/docs/benchmarks.md +16 -16
- package/docs/catalog.md +17 -15
- package/docs/contracts/CHANGELOG-conventions.md +1 -1
- package/docs/contracts/STABILITY.md +2 -2
- package/docs/contracts/adoption-signal-floor.md +110 -0
- package/docs/contracts/adr-chat-history-split.md +4 -4
- package/docs/contracts/adr-command-suggestion.md +4 -4
- package/docs/contracts/adr-gtm-context-spine.md +1 -1
- package/docs/contracts/adr-implement-ticket-runtime.md +4 -4
- package/docs/contracts/adr-install-user-type-axis.md +1 -1
- package/docs/contracts/adr-layout.md +2 -2
- package/docs/contracts/adr-product-ui-track.md +10 -10
- package/docs/contracts/adr-user-types-axis.md +3 -3
- package/docs/contracts/adr-wing4-context-spine.md +1 -1
- package/docs/contracts/agent-memory-contract.md +3 -3
- package/docs/contracts/agents-md-tech-stack.md +2 -2
- package/docs/contracts/ai-council-config.md +2 -2
- package/docs/contracts/at-rest-encryption.md +4 -0
- package/docs/contracts/audit-log-v1.md +1 -1
- package/docs/contracts/benchmark-ab-contract.md +101 -0
- package/docs/contracts/benchmark-corpus-spec.md +1 -1
- package/docs/contracts/branch-protection-policy.md +98 -0
- package/docs/contracts/ci-cost-budget.md +106 -0
- package/docs/contracts/ci-green-floor.md +141 -0
- package/docs/contracts/command-clusters.md +6 -6
- package/docs/contracts/command-surface-tiers.md +2 -2
- package/docs/contracts/command-taxonomy.md +2 -2
- package/docs/contracts/{compression-default-kill-criterion.md → condensation-default-kill-criterion.md} +29 -29
- package/docs/contracts/config-presets.md +1 -1
- package/docs/contracts/context-paths.md +3 -3
- package/docs/contracts/context-spine.md +1 -1
- package/docs/contracts/cost-summary-schema.md +12 -12
- package/docs/contracts/cross-wing-handoff.md +4 -4
- package/docs/contracts/daily-workspace.md +4 -0
- package/docs/contracts/decision-trace-v1.md +2 -2
- package/docs/contracts/discovery-manifest.md +4 -4
- package/docs/contracts/explain-modes.md +4 -0
- package/docs/contracts/file-ownership-matrix.json +3493 -3318
- package/docs/contracts/file-ownership-matrix.md +3 -3
- package/docs/contracts/frontmatter-contract.md +4 -4
- package/docs/contracts/ghostwriter-schema.md +3 -3
- package/docs/contracts/gui-wizard.md +110 -97
- package/docs/contracts/harness-expectations.md +123 -0
- package/docs/contracts/host-agent-protocol.md +4 -0
- package/docs/contracts/implement-ticket-flow.md +9 -9
- package/docs/contracts/install-scopes.md +77 -0
- package/docs/contracts/iron-law-overrides.txt +1 -1
- package/docs/contracts/kernel-membership.md +26 -26
- package/docs/contracts/linear-ai-rules-inclusion.md +1 -1
- package/docs/contracts/linter-structural-model.md +2 -2
- package/docs/contracts/load-context-budget-model.md +4 -4
- package/docs/contracts/load-context-schema.md +13 -13
- package/docs/contracts/local-analytics.md +4 -0
- package/docs/contracts/local-knowledge-ingestion.md +1 -1
- package/docs/contracts/mcp-cloud-scope.md +2 -2
- package/docs/contracts/mcp-phase-1-scope.md +3 -3
- package/docs/contracts/measurement-baseline.md +5 -5
- package/docs/contracts/mental-models.md +30 -30
- package/docs/contracts/multi-tool-projection-fidelity.md +4 -4
- package/docs/contracts/namespace.md +4 -4
- package/docs/contracts/orchestration-dsl-v1.md +7 -7
- package/docs/contracts/package-self-orientation.md +12 -12
- package/docs/contracts/persona-schema.md +6 -6
- package/docs/contracts/pilot/language-and-tone.md +1 -1
- package/docs/contracts/plain-language-surface.md +117 -0
- package/docs/contracts/profile-system.md +3 -3
- package/docs/contracts/release-pr-gating.md +103 -0
- package/docs/contracts/role-experience.md +3 -3
- package/docs/contracts/rule-classification.md +13 -13
- package/docs/contracts/rule-interactions.md +4 -4
- package/docs/contracts/rule-interactions.yml +30 -30
- package/docs/contracts/rule-priority-hierarchy.md +13 -13
- package/docs/contracts/rule-router.md +2 -2
- package/docs/contracts/safety-model.md +1 -1
- package/docs/contracts/skill-distribution-channels.md +61 -0
- package/docs/contracts/skill-domains.md +2 -2
- package/docs/contracts/smoke-contracts.md +5 -5
- package/docs/contracts/telegraph-telemetry.md +83 -0
- package/docs/contracts/trust-and-safety.md +5 -5
- package/docs/contracts/ui-stack-extension.md +7 -7
- package/docs/contracts/ui-track-flow.md +9 -9
- package/docs/contracts/user-type-schema.md +4 -4
- package/docs/contracts/workflow-packs.md +4 -4
- package/docs/contracts/workspace-documents.md +4 -0
- package/docs/customization.md +28 -8
- package/docs/decisions/ADR-001-kernel-swap-deferred.md +6 -6
- package/docs/decisions/ADR-002-kernel-bucket-overrides.md +11 -11
- package/docs/decisions/ADR-003-flat-cluster-subs-and-colon-syntax.md +2 -2
- package/docs/decisions/ADR-004-rule-governance-pruning.md +4 -4
- package/docs/decisions/ADR-005-subagent-worktrees.md +7 -7
- package/docs/decisions/ADR-011-domain-pack-readiness.md +6 -6
- package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +3 -3
- package/docs/decisions/ADR-015-discovery-manifest-contract.md +3 -3
- package/docs/decisions/ADR-017-monorepo-physical-layout.md +10 -10
- package/docs/decisions/ADR-018-trust-and-safety-layer.md +6 -6
- package/docs/decisions/ADR-019-router-json-dist-location.md +2 -2
- package/docs/decisions/ADR-020-global-only-consumer-scope.md +2 -2
- package/docs/decisions/ADR-021-deployment-shape.md +3 -3
- package/docs/decisions/ADR-022-daily-workspace-decomposition.md +1 -1
- package/docs/decisions/ADR-027-changelog-machine-vs-manual.md +2 -2
- package/docs/decisions/ADR-028-root-layout.md +7 -7
- package/docs/decisions/ADR-029-multi-workspace-deferred.md +2 -2
- package/docs/decisions/ADR-rule-kernel-and-router.md +5 -5
- package/docs/deploy/connector-setup.md +2 -2
- package/docs/deploy/policy-cookbook.md +2 -2
- package/docs/deploy/team-deployment-posture.md +20 -0
- package/docs/development.md +17 -17
- package/docs/distribution/registries.md +32 -0
- package/docs/distribution/registry-submissions.md +85 -0
- package/docs/distribution/telemetry-schema.md +1 -1
- package/docs/getting-started-by-role.md +45 -3
- package/docs/getting-started.md +2 -2
- package/docs/guidelines/agent-infra/5w2h-analysis.md +3 -3
- package/docs/guidelines/agent-infra/ask-when-uncertain-demos.md +1 -1
- package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +3 -3
- package/docs/guidelines/agent-infra/carve-out-predicates.md +3 -3
- package/docs/guidelines/agent-infra/critical-thinking.md +4 -4
- package/docs/guidelines/agent-infra/direct-answers-demos.md +1 -1
- package/docs/guidelines/agent-infra/first-principles.md +2 -2
- package/docs/guidelines/agent-infra/inversion-thinking.md +5 -5
- package/docs/guidelines/agent-infra/layered-settings.md +56 -2
- package/docs/guidelines/agent-infra/mental-models.md +3 -3
- package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +2 -2
- package/docs/guidelines/agent-infra/rule-type-governance.md +1 -1
- package/docs/guidelines/agent-infra/scqa-framework.md +5 -5
- package/docs/guidelines/agent-infra/self-improvement-pipeline.md +2 -2
- package/docs/guidelines/agent-infra/six-hats.md +3 -3
- package/docs/guidelines/agent-infra/skill-quality-checklist.md +5 -5
- package/docs/guidelines/agent-infra/systems-thinking.md +1 -1
- package/docs/guidelines/agent-infra/verify-before-complete-demos.md +1 -1
- package/docs/guidelines/augment-portability-patterns.md +4 -4
- package/docs/guidelines/cross-role-handoff.md +2 -2
- package/docs/guidelines/php/php-coding-patterns.md +1 -1
- package/docs/guidelines/prompt-templates.md +6 -6
- package/docs/maintainers/dev-mode.md +1 -1
- package/docs/mcp.md +1 -1
- package/docs/parity/bench.json +3 -3
- package/docs/parity/ruflo.md +2 -2
- package/docs/profiles.md +11 -11
- package/docs/quality.md +11 -11
- package/docs/safety.md +3 -3
- package/docs/setup/mcp-client-config.md +1 -1
- package/docs/setup/mcp-r2-bootstrap.md +1 -1
- package/docs/setup/mcp-server-docker.md +3 -3
- package/docs/setup/per-ide/windsurf.md +1 -1
- package/docs/skills-catalog.md +8 -7
- package/docs/troubleshooting.md +1 -1
- package/docs/walkthroughs/daily-workspace-a11y.md +87 -0
- package/llms.txt +7 -6
- package/package.json +1 -1
- package/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
- package/scripts/_archive/README.md +2 -2
- package/scripts/_archive/_backfill_skill_domains.py +3 -3
- package/scripts/_archive/_bootstrap_tier_frontmatter.py +3 -3
- package/scripts/_archive/_p43_bodies.py +10 -10
- package/scripts/_archive/{_p43_compress.py → _p43_condense.py} +5 -5
- package/scripts/_archive/_p4_migrate.py +7 -7
- package/scripts/_archive/_phase2_shim_helper.py +1 -1
- package/scripts/_archive/_pilot_council_question.py +5 -5
- package/scripts/_cli/explain_last/inputs.py +1 -1
- package/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
- package/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
- package/scripts/_lib/agent_settings.py +195 -1
- package/scripts/_lib/agent_src.py +19 -19
- package/scripts/_lib/bench_ab_cache.py +162 -0
- package/scripts/_lib/bench_ab_scoring.py +209 -0
- package/scripts/_lib/{bench_caveman.py → bench_telegraph.py} +21 -21
- package/scripts/_lib/{bench_caveman_report.py → bench_telegraph_report.py} +21 -21
- package/scripts/_lib/claude_desktop_bundler.py +5 -5
- package/scripts/_lib/module_detection.py +223 -0
- package/scripts/_lib/scope_guard.sh +162 -0
- package/scripts/_phase4_bucket.py +3 -3
- package/scripts/_pilot_measure.py +4 -4
- package/scripts/_tmp_scan_framework_leakage.py +1 -1
- package/scripts/adoption_report.py +195 -0
- package/scripts/adoption_snapshot.py +219 -0
- package/scripts/adoption_status.py +166 -0
- package/scripts/ai-video/lib/parse-blueprint.sh +1 -1
- package/scripts/ai_council/advisors.py +5 -5
- package/scripts/ai_council/compile_corpus.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_budget_v2_audit.py +3 -3
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_context_layer_v1_review.py +2 -2
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_inject_quiet_flag.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_v2.sh +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_verbosity.sh +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_nondestructive_inline_audit.py +3 -3
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_per_task.sh +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase6_trigger_jaccard.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase_2a_budget_rebalance.py +6 -6
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_rebalancing_audit.py +1 -1
- package/scripts/ai_council/one_off_archive/2026-05/_one_off_tier_retrofit.py +6 -6
- package/scripts/annotate_discovery.py +13 -13
- package/scripts/apply_modules_config.py +290 -0
- package/scripts/audit_adr_coverage.py +2 -2
- package/scripts/audit_auto_rules.py +2 -2
- package/scripts/audit_cloud_compatibility.py +3 -3
- package/scripts/audit_command_surface.py +9 -9
- package/scripts/audit_likelihood.py +2 -2
- package/scripts/audit_user_type_axis.py +2 -2
- package/scripts/bench_ab_cache_dispatch.py +68 -0
- package/scripts/bench_ab_clone.py +170 -0
- package/scripts/bench_ab_diff.py +227 -0
- package/scripts/bench_ab_integrity.py +143 -0
- package/scripts/bench_ab_run.py +235 -0
- package/scripts/bench_ab_task_runner.py +369 -0
- package/scripts/bench_ab_tracka_run.py +202 -0
- package/scripts/{bench_compress_memory.py → bench_condense_memory.py} +16 -16
- package/scripts/bench_run.py +33 -33
- package/scripts/bench_runner.py +2 -2
- package/scripts/bootstrap.sh +99 -0
- package/scripts/build_cloud_bundle.py +6 -6
- package/scripts/build_discovery_manifest.py +7 -7
- package/scripts/build_linear_digest.py +3 -3
- package/scripts/build_rule_trigger_matrix.py +8 -8
- package/scripts/chat_history.py +5 -5
- package/scripts/check_always_budget.py +11 -5
- package/scripts/check_augment_description_cap.py +3 -3
- package/scripts/check_cluster_patterns.py +2 -2
- package/scripts/check_command_count_messaging.py +3 -3
- package/scripts/{check_compression.py → check_condensation.py} +34 -34
- package/scripts/{check_compressed_paths.py → check_condensed_paths.py} +8 -8
- package/scripts/check_context_paths.py +7 -7
- package/scripts/check_council_layout.py +2 -2
- package/scripts/check_council_references.py +9 -9
- package/scripts/check_iron_law_prominence.py +2 -2
- package/scripts/check_kernel_rule_bundle.py +2 -2
- package/scripts/check_module_management_neutral.py +149 -0
- package/scripts/check_no_roadmap_refs.py +9 -9
- package/scripts/check_portability.py +3 -3
- package/scripts/check_public_catalog_links.py +4 -4
- package/scripts/check_references.py +7 -6
- package/scripts/check_release_pr_shape.py +112 -0
- package/scripts/check_reply_consistency.py +3 -3
- package/scripts/check_safety_floor_untouched.py +1 -1
- package/scripts/check_template_pin_drift.py +5 -5
- package/scripts/check_token_optimizer_freshness.py +3 -3
- package/scripts/ci_status.py +301 -0
- package/scripts/ci_time_ratio.py +1 -1
- package/scripts/cleanup_other_scope.sh +146 -0
- package/scripts/compile_router.py +10 -10
- package/scripts/{compress.py → condense.py} +64 -64
- package/scripts/condense.sh +18 -0
- package/scripts/{compress_memory.py → condense_memory.py} +33 -33
- package/scripts/config/presets.py +2 -2
- package/scripts/config/profiles.py +1 -1
- package/scripts/cost_by_conversation.py +3 -3
- package/scripts/cost_summary.py +7 -7
- package/scripts/count_token_optimizer_usage.sh +1 -1
- package/scripts/gen_discovery_baseline.py +5 -5
- package/scripts/generate_index.py +6 -6
- package/scripts/generate_ownership_matrix.py +10 -10
- package/scripts/generate_pack_manifests.py +1 -1
- package/scripts/ghostwriter_fixture_allowlist.txt +1 -1
- package/scripts/install +3 -3
- package/scripts/install-hooks.sh +6 -6
- package/scripts/install.py +273 -45
- package/scripts/install.sh +187 -1
- package/scripts/inventory_frontmatter.py +2 -2
- package/scripts/iron_law_sha.py +3 -3
- package/scripts/lint_agents_layout.py +14 -7
- package/scripts/lint_agents_md.py +4 -4
- package/scripts/lint_archived_skills.py +3 -3
- package/scripts/lint_artefact_frontmatter.py +2 -2
- package/scripts/lint_bench_ab.py +172 -0
- package/scripts/lint_bench_corpus.py +1 -1
- package/scripts/lint_command_tiers.py +5 -5
- package/scripts/lint_context_spine_usage.py +1 -1
- package/scripts/lint_framework_leakage.py +7 -7
- package/scripts/lint_framework_leakage_allowlist.json +152 -84
- package/scripts/lint_ghostwriter_source.py +3 -3
- package/scripts/lint_handoffs.py +1 -1
- package/scripts/lint_load_context.py +11 -11
- package/scripts/lint_media_policy_linkage.py +5 -5
- package/scripts/lint_namespace.py +1 -1
- package/scripts/lint_no_new_atomic_commands.py +2 -2
- package/scripts/lint_orchestration_dsl.py +1 -1
- package/scripts/lint_pack_boundaries.py +2 -2
- package/scripts/lint_persona_governance.py +4 -4
- package/scripts/lint_role_experiences.py +237 -0
- package/scripts/lint_rule_interactions.py +2 -2
- package/scripts/lint_rule_tiers.py +1 -1
- package/scripts/lint_trust_coherence.py +2 -2
- package/scripts/mcp_registry_submit.sh +187 -0
- package/scripts/mcp_server/tools.py +1 -1
- package/scripts/measure_frugality_savings.py +10 -10
- package/scripts/measure_patterns.py +1 -1
- package/scripts/measure_projection_bytes.py +5 -5
- package/scripts/measure_rule_budget.py +3 -3
- package/scripts/measure_skill_reduction.py +1 -1
- package/scripts/memory_lookup.py +1 -1
- package/scripts/memory_status.py +2 -2
- package/scripts/migrate_command_suggestions.py +3 -3
- package/scripts/mine_session.py +1 -1
- package/scripts/move_artefact.py +3 -3
- package/scripts/new_skill.py +2 -2
- package/scripts/pack_mcp_content.py +9 -9
- package/scripts/plan_physical_move.py +6 -6
- package/scripts/print_required_checks.py +196 -0
- package/scripts/probe_skill_registration.py +413 -0
- package/scripts/propose_modules_config.py +145 -0
- package/scripts/prototype_lint_contradictions.py +1 -1
- package/scripts/recruit_preflight.sh +152 -0
- package/scripts/refine_ticket_detect.py +3 -3
- package/scripts/release.py +20 -0
- package/scripts/render_benchmark_md.py +308 -0
- package/scripts/roadmap_progress_hook.py +1 -1
- package/scripts/run_skill_evals.py +2 -2
- package/scripts/runtime_registry.py +4 -4
- package/scripts/schemas/command.schema.json +4 -4
- package/scripts/schemas/rule.schema.json +5 -5
- package/scripts/schemas/skill.schema.json +3 -3
- package/scripts/schemas/user-type.schema.json +1 -1
- package/scripts/score_skill_selection.py +1 -1
- package/scripts/skill_collision_clusters.py +2 -2
- package/scripts/skill_linter.py +81 -81
- package/scripts/skill_overlap.py +5 -5
- package/scripts/skill_tools/audit_persona_coverage.py +2 -2
- package/scripts/skill_tools/audit_user_type_coverage.py +2 -2
- package/scripts/skill_tools/run_block_d_eval.py +1 -1
- package/scripts/skill_tools/score_skill_relevance.py +1 -1
- package/scripts/skill_tools/suggest_skill_for_task.py +1 -1
- package/scripts/skill_trigger_eval.py +3 -3
- package/scripts/smoke/kernel.sh +7 -1
- package/scripts/smoke/router.sh +5 -5
- package/scripts/smoke/skills.sh +1 -1
- package/scripts/smoke_quickstart.py +1 -1
- package/scripts/snapshot_agent_outputs.py +3 -3
- package/scripts/spotcheck_thin_root.py +1 -1
- package/scripts/{caveman_stats.py → telegraph_stats.py} +18 -18
- package/scripts/update_counts.py +1 -1
- package/scripts/validate_decision_engine.py +1 -1
- package/scripts/validate_frontmatter.py +1 -1
- package/scripts/validate_safe_paths.py +3 -3
- package/scripts/{validate_caveman_carveouts.py → validate_telegraph_carveouts.py} +7 -7
- package/scripts/verify_roadmap_closure.py +6 -6
- package/templates/consumer-settings/ONBOARDING.md +41 -0
- package/.agent-src/commands/install-via-agent.md +0 -129
- package/.agent-src/skills/compress-memory/SKILL.md +0 -131
- package/dist/ui/assets/index-D-DY1ywI.js +0 -35
- package/dist/ui/assets/index-D-DY1ywI.js.map +0 -1
- package/dist/ui/assets/index-Dqfhmg-d.css +0 -1
- package/docs/adrs/caveman/README.md +0 -9
- package/docs/contracts/caveman-telemetry.md +0 -83
- package/scripts/compress.sh +0 -18
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
# ADR-002 (2026-05-06) — kernel-bucket cap raise + per-rule overrides.
|
|
16
16
|
# Source: docs/decisions/ADR-002-kernel-bucket-overrides.md
|
|
17
17
|
# Empirical r_actual=0.795 vs r_projected=0.712. The 6 rules below carry
|
|
18
|
-
# Iron-Law fences + non-externalisable enumerations; further
|
|
18
|
+
# Iron-Law fences + non-externalisable enumerations; further condensation
|
|
19
19
|
# would force semantic loss. All sit ≤ 4 000-char override ceiling.
|
|
20
20
|
ask-when-uncertain
|
|
21
21
|
direct-answers
|
|
@@ -10,7 +10,7 @@ keep-beta-until: 2026-08-12
|
|
|
10
10
|
> · **Source of truth:** `docs/contracts/rule-classification.md` § 3.1
|
|
11
11
|
> · **Pilot artifacts:** `docs/contracts/pilot/`
|
|
12
12
|
|
|
13
|
-
Locks the kernel set and the empirical
|
|
13
|
+
Locks the kernel set and the empirical condensation rate `r` derived
|
|
14
14
|
from the P1.3 pilot. Phase 2.2 executes against this contract.
|
|
15
15
|
|
|
16
16
|
## § 1 — Inclusion criteria (kernel-only)
|
|
@@ -37,7 +37,7 @@ A rule belongs in the kernel iff it satisfies **all** of:
|
|
|
37
37
|
`no-cheap-questions` are first-class kernel members even though
|
|
38
38
|
they fire during deliberation, not strictly pre-send.)*
|
|
39
39
|
|
|
40
|
-
All other rules → `
|
|
40
|
+
All other rules → `condense-and-keep` (auto-tier) or migrate to
|
|
41
41
|
skill / guideline per `rule-classification.md`.
|
|
42
42
|
|
|
43
43
|
> **Council amendment (P1.4).** Criterion #3 originally read "must be
|
|
@@ -49,12 +49,12 @@ skill / guideline per `rule-classification.md`.
|
|
|
49
49
|
> existing 9-rule kernel set. See
|
|
50
50
|
> `agents/runtime/council/sessions/20260506T044941Z-phase1-cross-check-r2.json`. <!-- council-ref-allowed: contract decision trace -->
|
|
51
51
|
|
|
52
|
-
## § 2 — Empirical
|
|
52
|
+
## § 2 — Empirical condensation rate (pilot)
|
|
53
53
|
|
|
54
54
|
Pilot picks (per P1.3 algorithm: shortest / median / longest of the 9
|
|
55
55
|
always-rules in `rule-classification.md` § 3.1):
|
|
56
56
|
|
|
57
|
-
| pilot | original |
|
|
57
|
+
| pilot | original | condensed | r | per-rule cap (2.5k) | Iron-Law SHA |
|
|
58
58
|
|---|---:|---:|---:|---|---|
|
|
59
59
|
| agent-authority | 1217 | 1020 | 0.838 | OK | match (`e3b0c442…`) |
|
|
60
60
|
| direct-answers | 3991 | 2841 | 0.712 | +341 over | match (`ef438530…`) |
|
|
@@ -65,21 +65,21 @@ always-rules in `rule-classification.md` § 3.1):
|
|
|
65
65
|
| mean r (outlier-skewed by lean pilot) | 0.742 |
|
|
66
66
|
| **median r** (locked for projection) | **0.712** |
|
|
67
67
|
| max r (already-lean floor) | 0.838 |
|
|
68
|
-
| min r (most
|
|
68
|
+
| min r (most condensable) | 0.677 |
|
|
69
69
|
|
|
70
70
|
Locked `r = 0.712` (median) for P2.2 projection. Council amendment
|
|
71
71
|
(P1.4) — the original lock was the **mean** (0.742), but Sonnet 4.5
|
|
72
72
|
flagged outlier skew: `agent-authority` at 1217 chars pre-pilot was
|
|
73
|
-
already near the
|
|
73
|
+
already near the condensation floor (`r = 0.838`), pulling the mean
|
|
74
74
|
above the typical band. Median (0.712) is robust to the lean
|
|
75
75
|
outlier and sits inside the roadmap-stated 0.6–0.75 band. Risk
|
|
76
|
-
asymmetry confirms the choice: under-estimating
|
|
76
|
+
asymmetry confirms the choice: under-estimating condensed size
|
|
77
77
|
blows the 25k cap mid-P2.2 (no abort path); over-estimating just
|
|
78
78
|
yields headroom. GPT-4o concurred. Source:
|
|
79
79
|
`agents/runtime/council/sessions/20260506T044941Z-phase1-cross-check-r2.json`. <!-- council-ref-allowed: contract decision trace -->
|
|
80
80
|
|
|
81
81
|
**Pilot caveat — already-lean floor.** `agent-authority` (1217 chars
|
|
82
|
-
pre-pilot) yielded only `r = 0.838`. Pre-
|
|
82
|
+
pre-pilot) yielded only `r = 0.838`. Pre-condensed rules give less
|
|
83
83
|
back; rules > 3k chars give more back. Future kernel additions
|
|
84
84
|
≤ 1.5k chars should not assume the median — they may already be at
|
|
85
85
|
floor.
|
|
@@ -117,7 +117,7 @@ absorbs pilot variance for the 6 untested rules.
|
|
|
117
117
|
|
|
118
118
|
### § 4.1 — Post-P2.2 locked kernel (empirical, 2026-05-06)
|
|
119
119
|
|
|
120
|
-
P2.2 applied
|
|
120
|
+
P2.2 applied condensation (imperative rewrite, examples → guidelines,
|
|
121
121
|
rationale → contexts) + verified Iron-Law fence preservation.
|
|
122
122
|
Empirical r=0.795 (vs 0.712 projected). Bucket cap raised 25k → 26k
|
|
123
123
|
via `docs/decisions/ADR-002-kernel-bucket-overrides.md`. Six rules
|
|
@@ -164,7 +164,7 @@ until the next kernel re-measurement.
|
|
|
164
164
|
|
|
165
165
|
† **agent-authority swap candidate (P1.4 ADR).** Sonnet 4.5 argues
|
|
166
166
|
this is a routing index (zero Iron Law fences, dispatches to other
|
|
167
|
-
kernel rules) and should be `
|
|
167
|
+
kernel rules) and should be `condense-and-keep` (auto-tier-3),
|
|
168
168
|
freeing 867 projected chars. The Council also recommends promoting
|
|
169
169
|
`autonomous-execution` (5631 → 4009 projected) into kernel as a
|
|
170
170
|
mode-independent Band-4 authority. Net effect: 23071 − 867 + 4009 =
|
|
@@ -191,10 +191,10 @@ Both Council members concurred — the original 1.5k figure forced 8 of
|
|
|
191
191
|
The 2.5k cap fits 7 of 9 rules without ADR; only the two largest
|
|
192
192
|
remain as legitimate Iron-Law-density exceptions.
|
|
193
193
|
|
|
194
|
-
Rules that land **above the 2.5k per-rule cap** even after
|
|
194
|
+
Rules that land **above the 2.5k per-rule cap** even after condensation
|
|
195
195
|
and Iron-Law preservation:
|
|
196
196
|
|
|
197
|
-
| rule | post-
|
|
197
|
+
| rule | post-condensation chars | over-cap (2.5k) | reason cap cannot be hit |
|
|
198
198
|
|---|---:|---:|---|
|
|
199
199
|
| direct-answers | 2842 | +342 | Three Iron-Law fences (≈ 470 chars) + severity-tiered claim table required for invented-facts gate |
|
|
200
200
|
| language-and-tone | 3786 | +1286 | Iron-Law fence + exhaustive user-visible-prose catalog + pre-send gate are co-load-bearing |
|
|
@@ -204,12 +204,12 @@ and Iron-Law preservation:
|
|
|
204
204
|
ADR (see § 5.2).
|
|
205
205
|
|
|
206
206
|
Per roadmap § "Iron-Law over budget = ADR exception, not auto-
|
|
207
|
-
|
|
207
|
+
condense" — these surface as `iron-law-override` exceptions for P2.1
|
|
208
208
|
to gate behind ADRs in `docs/decisions/`.
|
|
209
209
|
|
|
210
210
|
The remaining 6 always-rules project to 1669–2916 chars post-
|
|
211
|
-
|
|
212
|
-
measures the real post-
|
|
211
|
+
condensation — all under the 2.5k cap with no ADR needed. P2.2
|
|
212
|
+
measures the real post-condensation sizes; if any breach the cap, an
|
|
213
213
|
ADR lands per-rule.
|
|
214
214
|
|
|
215
215
|
### § 5.2 — Kernel-set swap ADR (agent-authority ↔ autonomous-execution)
|
|
@@ -236,19 +236,19 @@ clearing the way for the swap under a fresh ADR.
|
|
|
236
236
|
|
|
237
237
|
## § 6 — Abort criteria for P2.2
|
|
238
238
|
|
|
239
|
-
**Council amendment (P1.4).** Sonnet 4.5 flagged that P2.2
|
|
239
|
+
**Council amendment (P1.4).** Sonnet 4.5 flagged that P2.2 condenses
|
|
240
240
|
in place with no defined abort path. The following triggers force
|
|
241
241
|
revert + re-projection rather than mid-phase scramble:
|
|
242
242
|
|
|
243
243
|
- **Iron-Law drift.** Any kernel rule loses Iron-Law SHA equivalence
|
|
244
|
-
after
|
|
245
|
-
content). Single occurrence aborts the rule's
|
|
246
|
-
- **Bucket overflow.** Kernel sum post-
|
|
244
|
+
after condensation (whitespace-normalised, case-folded fence-block
|
|
245
|
+
content). Single occurrence aborts the rule's condensation.
|
|
246
|
+
- **Bucket overflow.** Kernel sum post-condensation > 27 500 chars
|
|
247
247
|
(10 % over hard cap). Aborts the entire P2.2 phase.
|
|
248
|
-
- **Single-rule runaway.** Any kernel rule post-
|
|
249
|
-
> 4 000 chars. Aborts that rule's
|
|
248
|
+
- **Single-rule runaway.** Any kernel rule post-condensation
|
|
249
|
+
> 4 000 chars. Aborts that rule's condensation; flag for ADR.
|
|
250
250
|
- **Empirical r drift.** Median of measured r across the first 4
|
|
251
|
-
|
|
251
|
+
condensed rules deviates > 0.10 from the locked 0.712 (i.e.,
|
|
252
252
|
measured median outside [0.612, 0.812]). P2.2 pauses, re-locks r,
|
|
253
253
|
re-runs § 3 projection.
|
|
254
254
|
|
|
@@ -266,10 +266,10 @@ with the trigger-relaxed parameter, lock new value, re-attempt.
|
|
|
266
266
|
|
|
267
267
|
## § 8 — What this contract does NOT do
|
|
268
268
|
|
|
269
|
-
- It does **not** edit any source rule. P2.2 ships
|
|
270
|
-
`.agent-src.
|
|
269
|
+
- It does **not** edit any source rule. P2.2 ships condensation to
|
|
270
|
+
`.agent-src.uncondensed/rules/`.
|
|
271
271
|
- It does **not** lock per-rule `chars` (only the bucket sum). Per-
|
|
272
|
-
rule values are projections; P2.2 measures real post-
|
|
272
|
+
rule values are projections; P2.2 measures real post-condensation.
|
|
273
273
|
- It does **not** decide kernel additions. Adding a rule to the
|
|
274
274
|
kernel requires an ADR per roadmap § "Sequencing-drift time-box"
|
|
275
275
|
and re-runs P1.3 with the new candidate.
|
|
@@ -288,4 +288,4 @@ with the trigger-relaxed parameter, lock new value, re-attempt.
|
|
|
288
288
|
| 2026-05-06 | `agents/runtime/council/sessions/20260506T044821Z-phase1-cross-check.json` | Council R1 (truncated at 1024 tokens) | <!-- council-ref-allowed: contract decision trace -->
|
|
289
289
|
| 2026-05-06 | `agents/runtime/council/sessions/20260506T044941Z-phase1-cross-check-r2.json` | Council R2 (3500 tokens) — locks median r, splits criterion #3, adds criterion #5, raises per-rule cap to 2.5k, defines abort criteria | <!-- council-ref-allowed: contract decision trace -->
|
|
290
290
|
| 2026-05-06 | this file | kernel set locked: 9 rules, projected 23 071 chars (median r = 0.712) |
|
|
291
|
-
| 2026-05-06 | P2.2
|
|
291
|
+
| 2026-05-06 | P2.2 condensation + `scripts/iron_law_sha.py --all-kernel` | empirical: 25 590 chars (r_actual = 0.795 across kernel; longer rules condense less than the pilot median) — see `docs/decisions/ADR-002-kernel-bucket-overrides.md` (KERNEL_HARD raised 25k → 26k, 6 per-rule overrides ≤ 4k ceiling, all Iron-Law SHAs preserved) |
|
|
@@ -130,7 +130,7 @@ persistence on cloud platforms; the rule is a no-op.
|
|
|
130
130
|
partitions workspace / team / personal. Step 3 only needs to
|
|
131
131
|
document the three-layer rationale for the README.
|
|
132
132
|
- Re-classify on every audit run; if a rule is added to
|
|
133
|
-
`.agent-src.
|
|
133
|
+
`.agent-src.uncondensed/rules/`, this document MUST gain a row.
|
|
134
134
|
|
|
135
135
|
## Source of tier data
|
|
136
136
|
|
|
@@ -88,7 +88,7 @@ procedure → no warning under the new model. ✓ roadmap success criterion.
|
|
|
88
88
|
success criterion.
|
|
89
89
|
|
|
90
90
|
Of 13 commands ≥ 1000 words, only **2** lack a delegation signal —
|
|
91
|
-
both are candidates for Phase 4.1 review (`
|
|
91
|
+
both are candidates for Phase 4.1 review (`condense.md`,
|
|
92
92
|
`project-analyze.md`; the latter has density 0.86, exempt under the
|
|
93
93
|
density-AND-delegation gate).
|
|
94
94
|
|
|
@@ -115,7 +115,7 @@ Calibration sweep on the 2026-05-08 corpus (310 artifacts):
|
|
|
115
115
|
Pass rate: 186 → 209 (`pass`); 124 → 101 (`pass_with_warnings`); 0
|
|
116
116
|
errors. Each remaining warning is a genuine structural defect:
|
|
117
117
|
|
|
118
|
-
- `
|
|
118
|
+
- `condense.md` (1569 words, density 0.58, no delegation signal) —
|
|
119
119
|
inlined logic in a non-orchestrator command.
|
|
120
120
|
- `artifact-drafting-protocol.md` rule (65 lines, density 0.37, no
|
|
121
121
|
Iron-Law block) — prose-dominant long rule.
|
|
@@ -44,10 +44,10 @@ Where:
|
|
|
44
44
|
(per [`load-context-schema.md`](load-context-schema.md)).
|
|
45
45
|
- `transitive_closure` walks `load_context:` declarations on
|
|
46
46
|
context files **up to depth 2** — see § Nesting cap below.
|
|
47
|
-
- `RawSize` is the byte size of the
|
|
47
|
+
- `RawSize` is the byte size of the condensed file
|
|
48
48
|
(`.agent-src/...`), measured by `os.path.getsize()`. The
|
|
49
|
-
|
|
50
|
-
|
|
49
|
+
uncondensed source paths in frontmatter are mapped to their
|
|
50
|
+
condensed counterparts before sizing.
|
|
51
51
|
- A context loaded by N always-rules counts **N times** (once per
|
|
52
52
|
loading rule). Rationale: the always-budget protects context-window
|
|
53
53
|
utilization at activation time; if rule A and rule B both fire on
|
|
@@ -138,7 +138,7 @@ the full `RawSize(X)` under Model (b). No `chars(X) / N` discount.
|
|
|
138
138
|
has no measurable upside.
|
|
139
139
|
- Phase 4c (shared-context discount) becomes a no-op under 3a.
|
|
140
140
|
Phase 4 leverage shifts to 4a (demote), 4b (merge), and 4d
|
|
141
|
-
(hard-
|
|
141
|
+
(hard-condense) — see `road-to-context-layer-maturity` Phase 4
|
|
142
142
|
inputs gate.
|
|
143
143
|
|
|
144
144
|
**Reopener:** if a future inventory shows ≥ 3 shared-context loaders
|
|
@@ -33,10 +33,10 @@ load_context_eager: # opt-in eager — auto-loaded on rule fire
|
|
|
33
33
|
---
|
|
34
34
|
```
|
|
35
35
|
|
|
36
|
-
> **Logical names only.** The `.agent-src.
|
|
36
|
+
> **Logical names only.** The `.agent-src.uncondensed/` prefix is
|
|
37
37
|
> rejected by the schema regex (`scripts/schemas/rule.schema.json`) and
|
|
38
|
-
> by `scripts/lint_load_context.py`. The
|
|
39
|
-
> (`scripts/
|
|
38
|
+
> by `scripts/lint_load_context.py`. The condense-time rewriter
|
|
39
|
+
> (`scripts/condense.py::_rewrite_paths`) resolves logical names to the
|
|
40
40
|
> deployment-correct relative path (e.g. `../contexts/<area>/<file>.md`
|
|
41
41
|
> for a rule at `rules/<name>.md`). The full migration history lives
|
|
42
42
|
> in the archived path-fixes roadmap under `agents/roadmaps/archive/`.
|
|
@@ -53,16 +53,16 @@ opt-in and budget-gated.
|
|
|
53
53
|
## Path rules
|
|
54
54
|
|
|
55
55
|
- Logical names rooted at the source. The rewriter resolves them at
|
|
56
|
-
|
|
56
|
+
condense time.
|
|
57
57
|
- Paths MUST end in `.md`.
|
|
58
58
|
- Allowed roots:
|
|
59
59
|
- `contexts/<area>/<file>.md` — canonical logical name (resolves
|
|
60
|
-
against `.agent-src.
|
|
60
|
+
against `.agent-src.uncondensed/`).
|
|
61
61
|
- `agents/settings/contexts/<file>.md` — project-local material (consumer
|
|
62
62
|
repo only).
|
|
63
|
-
- `.agent-src/contexts/<file>.md` —
|
|
63
|
+
- `.agent-src/contexts/<file>.md` — condensed mirror; tolerated
|
|
64
64
|
defensively, not authored.
|
|
65
|
-
- The `.agent-src.
|
|
65
|
+
- The `.agent-src.uncondensed/` prefix is **rejected** by the schema
|
|
66
66
|
regex and by `lint_load_context.py` with a remediation hint pointing
|
|
67
67
|
at the canonical logical name.
|
|
68
68
|
- A rule MAY reference contexts under either tree, but a package-shipped
|
|
@@ -144,10 +144,10 @@ definition it is not loaded into every turn.
|
|
|
144
144
|
|
|
145
145
|
## Public-vs-internal leak
|
|
146
146
|
|
|
147
|
-
A rule shipped to consumers (`.agent-src.
|
|
147
|
+
A rule shipped to consumers (`.agent-src.uncondensed/rules/`) may
|
|
148
148
|
declare `load_context:` entries pointing at:
|
|
149
149
|
|
|
150
|
-
- `.agent-src.
|
|
150
|
+
- `.agent-src.uncondensed/contexts/` — public, OK.
|
|
151
151
|
- `agents/settings/contexts/` — package-internal, **lint warning** (the entry
|
|
152
152
|
will not exist in consumer projects).
|
|
153
153
|
|
|
@@ -163,7 +163,7 @@ defined across both `load_context:` and `load_context_eager:` edges.
|
|
|
163
163
|
|
|
164
164
|
### Real consumer — `autonomous-execution`
|
|
165
165
|
|
|
166
|
-
`.agent-src.
|
|
166
|
+
`.agent-src.uncondensed/rules/autonomous-execution.md` is the first
|
|
167
167
|
production rule to declare `load_context:`. Its frontmatter:
|
|
168
168
|
|
|
169
169
|
```yaml
|
|
@@ -173,9 +173,9 @@ description: "Deciding whether to ask the user or just act on a workflow step
|
|
|
173
173
|
alwaysApply: false
|
|
174
174
|
source: package
|
|
175
175
|
load_context:
|
|
176
|
-
- .agent-src.
|
|
177
|
-
- .agent-src.
|
|
178
|
-
- .agent-src.
|
|
176
|
+
- .agent-src.uncondensed/contexts/execution/autonomy-detection.md
|
|
177
|
+
- .agent-src.uncondensed/contexts/execution/autonomy-mechanics.md
|
|
178
|
+
- .agent-src.uncondensed/contexts/execution/autonomy-examples.md
|
|
179
179
|
---
|
|
180
180
|
```
|
|
181
181
|
|
|
@@ -45,7 +45,7 @@ prose-only.
|
|
|
45
45
|
`list_*`, `read_resource_body`) that touch the content blob only.
|
|
46
46
|
- **What it never does:** execute Python scripts, shell out, spawn
|
|
47
47
|
runtimes, touch consumer FS, write to R2, mutate consumer state,
|
|
48
|
-
call upstream LLM APIs, or read `.agent-src.
|
|
48
|
+
call upstream LLM APIs, or read `.agent-src.uncondensed/`.
|
|
49
49
|
- **Owner code path:** `internal/workers/mcp/` (TypeScript, Cloudflare Worker).
|
|
50
50
|
This contract is the normative spec.
|
|
51
51
|
- **Auth model:** `public` (default) or `bearer-auth` (operator opt-in)
|
|
@@ -120,7 +120,7 @@ prose-only.
|
|
|
120
120
|
shape `releases/v<X.Y.Z>-<sha>/` (immutable per release). The blob
|
|
121
121
|
bundles `.agent-src/skills/<name>/SKILL.md`,
|
|
122
122
|
`.agent-src/commands/**/*.md`, and `docs/guidelines/` (the same
|
|
123
|
-
projection the local kernel reads). Never reads `.agent-src.
|
|
123
|
+
projection the local kernel reads). Never reads `.agent-src.uncondensed/`.
|
|
124
124
|
- **Identity surface:** `serverInfo.version` reads from a Worker-
|
|
125
125
|
bundled constant, `_meta.packageVersion` reads from a
|
|
126
126
|
`wrangler.toml` env var, `_meta.skillSetSignature` reads from a
|
|
@@ -26,8 +26,8 @@ phase with its own design-call gate.
|
|
|
26
26
|
- Transport: **stdio**. No SSE, no HTTP, no WebSocket.
|
|
27
27
|
- MCP primitives: **`prompts/list`** + **`prompts/get`** — read-only.
|
|
28
28
|
- Source data: **`.agent-src/skills/<name>/SKILL.md`** and
|
|
29
|
-
**`.agent-src/commands/**/*.md`** (
|
|
30
|
-
|
|
29
|
+
**`.agent-src/commands/**/*.md`** (condensed projections, never the
|
|
30
|
+
uncondensed source-of-truth tree).
|
|
31
31
|
- Loaded set (Phase 2): every well-formed skill + command under
|
|
32
32
|
`.agent-src/` (Phase 1 hand-picked set retained as a smoke fixture
|
|
33
33
|
in `prompts.py::PHASE_1_SKILLS`).
|
|
@@ -154,7 +154,7 @@ change invalidates it.
|
|
|
154
154
|
|
|
155
155
|
### F3 — Stdio Docker bundle
|
|
156
156
|
|
|
157
|
-
`docker/mcp-server/Dockerfile` ships a stdio-only image. The contract:
|
|
157
|
+
`internal/docker/mcp-server/Dockerfile` ships a stdio-only image. The contract:
|
|
158
158
|
|
|
159
159
|
- **No HTTP / SSE listener** in the image. Stdio is the only wire.
|
|
160
160
|
- The image embeds `scripts/mcp_server/`, the two tool dependencies
|
|
@@ -5,7 +5,7 @@ stability: stable
|
|
|
5
5
|
# Measurement baseline — contract
|
|
6
6
|
|
|
7
7
|
> **Status:** locked 2026-05-16 · **Owner:** `step-4-measurement-and-benchmark.md`
|
|
8
|
-
> · **Cited by:** every P2 enforcement roadmap (skill rationalization G0, north-star G1,
|
|
8
|
+
> · **Cited by:** every P2 enforcement roadmap (skill rationalization G0, north-star G1, condensation default decision).
|
|
9
9
|
|
|
10
10
|
Single source of truth for what `task bench` measures, what counts as
|
|
11
11
|
drift, and what unblocks enforcement. Read this before pinning a number
|
|
@@ -36,7 +36,7 @@ timestamped, never overwritten, content-addressed by run.
|
|
|
36
36
|
|
|
37
37
|
Total 26 prompts ≥ Acceptance Criteria floor of 25. Mid-window edits
|
|
38
38
|
to either YAML restart the 60-day clock per
|
|
39
|
-
[`
|
|
39
|
+
[`condensation-default-kill-criterion.md`](condensation-default-kill-criterion.md) § 2.
|
|
40
40
|
|
|
41
41
|
## What counts as drift
|
|
42
42
|
|
|
@@ -77,14 +77,14 @@ on the 30-report floor.
|
|
|
77
77
|
Downstream consumers:
|
|
78
78
|
|
|
79
79
|
- ``step-99-north-star-restructure.md` § Acceptance G1` — reads this exit code.
|
|
80
|
-
- [`
|
|
80
|
+
- [`condensation-default-kill-criterion.md` § 3](condensation-default-kill-criterion.md) — reads the decision table after baseline closes.
|
|
81
81
|
- ``step-2-skill-inventory-rationalization.md` § G0` — usage-data soak floor.
|
|
82
82
|
|
|
83
83
|
## What the closeout writes
|
|
84
84
|
|
|
85
85
|
On baseline closure, the step-4 closeout writes the numeric verdict to
|
|
86
86
|
[`docs/parity/bench.json`](../parity/bench.json) — frozen snapshot with
|
|
87
|
-
the 30+ reports averaged, drift verdict, and the
|
|
87
|
+
the 30+ reports averaged, drift verdict, and the condensation-default
|
|
88
88
|
decision per the kill-criterion table. That file is the artefact every
|
|
89
89
|
P2 roadmap reads — not the live `internal/bench/reports/` directory.
|
|
90
90
|
|
|
@@ -98,5 +98,5 @@ P2 roadmap reads — not the live `internal/bench/reports/` directory.
|
|
|
98
98
|
|
|
99
99
|
- [`benchmark-report-schema.md`](benchmark-report-schema.md) · per-report JSON schema
|
|
100
100
|
- [`benchmark-corpus-spec.md`](benchmark-corpus-spec.md) · corpus YAML schema
|
|
101
|
-
- [`
|
|
101
|
+
- [`condensation-default-kill-criterion.md`](condensation-default-kill-criterion.md) · decision table read by step-4 closeout
|
|
102
102
|
- `step-4-measurement-and-benchmark.md` · the owning roadmap
|
|
@@ -37,7 +37,7 @@ decisions. The expensive part is identifying which "principle" is
|
|
|
37
37
|
actually load-bearing vs. inherited belief; the cheap part is the
|
|
38
38
|
re-derivation. Use when an inherited approach feels stale and you
|
|
39
39
|
suspect the real constraint moved.
|
|
40
|
-
*Cited by:* `.agent-src.
|
|
40
|
+
*Cited by:* `.agent-src.uncondensed/skills/improve-before-implement/`
|
|
41
41
|
(challenges weak requirements before code is written).
|
|
42
42
|
|
|
43
43
|
### 2. Jobs-to-be-Done (JTBD)
|
|
@@ -47,7 +47,7 @@ the job is the situation × motivation × expected outcome, not the
|
|
|
47
47
|
demographic. The unit of analysis is the **switch event** — what
|
|
48
48
|
caused them to fire the previous solution. JTBD reframes feature
|
|
49
49
|
requests as evidence of an unmet job, not feature gaps.
|
|
50
|
-
*Cited by:* `.agent-src.
|
|
50
|
+
*Cited by:* `.agent-src.uncondensed/skills/po-discovery/`
|
|
51
51
|
(reframes fuzzy product asks via job-shape).
|
|
52
52
|
|
|
53
53
|
### 3. Pareto principle (80/20)
|
|
@@ -56,7 +56,7 @@ Roughly 80% of effects come from 20% of causes. The lift is in
|
|
|
56
56
|
**identifying** the 20% — which user segment, which test failure,
|
|
57
57
|
which N+1 query — not in re-stating the ratio. Anti-pattern: using
|
|
58
58
|
80/20 as permission to ignore the long tail without measuring it.
|
|
59
|
-
*Cited by:* `.agent-src.
|
|
59
|
+
*Cited by:* `.agent-src.uncondensed/skills/performance-analysis/`
|
|
60
60
|
(N+1 detection prioritizes the 20% of queries causing 80% of latency).
|
|
61
61
|
|
|
62
62
|
### 4. Second-order thinking
|
|
@@ -66,7 +66,7 @@ what looks best now; second-order weighs the consequences of the
|
|
|
66
66
|
consequences. Most "obvious" decisions die at second-order — the
|
|
67
67
|
optimization that ships now creates the maintenance debt that kills
|
|
68
68
|
velocity in 6 months.
|
|
69
|
-
*Cited by:* `.agent-src.
|
|
69
|
+
*Cited by:* `.agent-src.uncondensed/skills/adversarial-review/`
|
|
70
70
|
(stress-tests a plan by walking past the immediate verdict).
|
|
71
71
|
|
|
72
72
|
### 5. Opportunity cost
|
|
@@ -76,7 +76,7 @@ not pick**, not the dollar / time spent. A 2-week feature is not
|
|
|
76
76
|
"2 weeks expensive" — it is the highest-value 2-week feature you
|
|
77
77
|
chose not to ship instead. Naming the alternative makes the cost
|
|
78
78
|
legible; pretending there isn't one is the failure mode.
|
|
79
|
-
*Cited by:* `.agent-src.
|
|
79
|
+
*Cited by:* `.agent-src.uncondensed/skills/rice-prioritization/`
|
|
80
80
|
(scores compete for capacity; non-shipped items are the cost basis).
|
|
81
81
|
|
|
82
82
|
### 6. Theory of constraints
|
|
@@ -86,7 +86,7 @@ Improving any non-constraint resource is local optimization with
|
|
|
86
86
|
zero system effect — usually negative, since it loads the actual
|
|
87
87
|
constraint harder. The discipline: identify, exploit, subordinate,
|
|
88
88
|
elevate, then find the next constraint.
|
|
89
|
-
*Cited by:* `.agent-src.
|
|
89
|
+
*Cited by:* `.agent-src.uncondensed/skills/funnel-analysis/`
|
|
90
90
|
(identifies the single funnel stage that bounds conversion throughput).
|
|
91
91
|
|
|
92
92
|
### 7. MVP (Minimum Viable Product)
|
|
@@ -97,7 +97,7 @@ junior-grade product. The trap is shipping an MVP that cannot
|
|
|
97
97
|
distinguish "user behavior validates the hypothesis" from "user
|
|
98
98
|
behavior was driven by something else"; that is just a small
|
|
99
99
|
product.
|
|
100
|
-
*Cited by:* `.agent-src.
|
|
100
|
+
*Cited by:* `.agent-src.uncondensed/skills/po-discovery/`
|
|
101
101
|
(scopes a discovery slice that produces a learning, not a feature).
|
|
102
102
|
|
|
103
103
|
### 8. Build-Measure-Learn
|
|
@@ -107,7 +107,7 @@ to persevere or pivot. The skill is in **shortening the loop** —
|
|
|
107
107
|
weeks beat months because months let teams rationalize a failed
|
|
108
108
|
hypothesis. The loop is the artefact; any individual cycle is just
|
|
109
109
|
one iteration.
|
|
110
|
-
*Cited by:* `.agent-src.
|
|
110
|
+
*Cited by:* `.agent-src.uncondensed/skills/test-driven-development/`
|
|
111
111
|
(the build-measure-learn loop applied to one function at a time).
|
|
112
112
|
|
|
113
113
|
### 9. Hypothesis-driven development
|
|
@@ -116,7 +116,7 @@ State the hypothesis as a falsifiable sentence with a metric and a
|
|
|
116
116
|
threshold **before** writing the code. "If we do X, metric Y will
|
|
117
117
|
move by Z." Without the threshold, the team will declare any
|
|
118
118
|
movement victory. With it, the team learns from the misses.
|
|
119
|
-
*Cited by:* `.agent-src.
|
|
119
|
+
*Cited by:* `.agent-src.uncondensed/skills/project-analysis-hypothesis-driven/`
|
|
120
120
|
(competing hypotheses + validation loops + evidence-based conclusions).
|
|
121
121
|
|
|
122
122
|
### 10. Reversible vs. irreversible decisions
|
|
@@ -126,7 +126,7 @@ plus speed. The bias under uncertainty: shipping a reversible
|
|
|
126
126
|
decision early is almost always cheaper than the meeting required
|
|
127
127
|
to decide. The skill is recognizing irreversibility — usually data
|
|
128
128
|
shape, public API surface, or hiring.
|
|
129
|
-
*Cited by:* `.agent-src.
|
|
129
|
+
*Cited by:* `.agent-src.uncondensed/skills/decision-record/`
|
|
130
130
|
(records the reversal-criteria so the irreversibility verdict is auditable).
|
|
131
131
|
|
|
132
132
|
### 11. DX as first-class concern
|
|
@@ -136,7 +136,7 @@ a polish task. Slow tests, fragile local setup, and surprising tool
|
|
|
136
136
|
output compound — every developer pays the tax every day. Treat DX
|
|
137
137
|
issues like user-facing bugs, with severity and SLA. The compounding
|
|
138
138
|
math makes "fix it later" almost always wrong.
|
|
139
|
-
*Cited by:* `.agent-src.
|
|
139
|
+
*Cited by:* `.agent-src.uncondensed/skills/test-performance/`
|
|
140
140
|
(test-suite latency is a developer-facing metric, optimized as such).
|
|
141
141
|
|
|
142
142
|
### 12. Conway's Law
|
|
@@ -145,7 +145,7 @@ The systems an organization builds mirror its communication structure.
|
|
|
145
145
|
Re-orgs propagate to architecture; architecture changes that fight the
|
|
146
146
|
org chart fail. The lever is bidirectional: pick the architecture you
|
|
147
147
|
want, then engineer the communication paths that produce it.
|
|
148
|
-
*Cited by:* `.agent-src.
|
|
148
|
+
*Cited by:* `.agent-src.uncondensed/skills/api-design/`
|
|
149
149
|
(bounded-context choices follow team boundaries, not the other way around).
|
|
150
150
|
|
|
151
151
|
### 13. Occam's Razor
|
|
@@ -155,7 +155,7 @@ that introduces the fewest new entities. In debugging, the boring
|
|
|
155
155
|
explanation (typo, off-by-one, stale cache) is usually correct. The
|
|
156
156
|
trap is **assuming** instead of **falsifying** — Occam suggests
|
|
157
157
|
order of investigation, not a verdict.
|
|
158
|
-
*Cited by:* `.agent-src.
|
|
158
|
+
*Cited by:* `.agent-src.uncondensed/skills/systematic-debugging/`
|
|
159
159
|
(reproduce → isolate → hypothesize, simplest hypothesis first).
|
|
160
160
|
|
|
161
161
|
### 14. Meadows leverage points
|
|
@@ -165,7 +165,7 @@ system are paradigm shifts, then goals, then rules — far above
|
|
|
165
165
|
parameter tweaks. Most "improvement" effort fights parameters
|
|
166
166
|
(numbers, delays) at the bottom of the ranking. Climb the ranking
|
|
167
167
|
before optimizing.
|
|
168
|
-
*Cited by:* `.agent-src.
|
|
168
|
+
*Cited by:* `.agent-src.uncondensed/skills/architecture-review-lens/`
|
|
169
169
|
(boundary / dependency-direction issues are higher-leverage than tweaks).
|
|
170
170
|
|
|
171
171
|
### 15. Signal vs. noise
|
|
@@ -175,7 +175,7 @@ A change of size N is meaningful only if N exceeds the noise floor
|
|
|
175
175
|
for that metric × that horizon. The discipline: estimate the noise
|
|
176
176
|
band first, then evaluate the change. Without the noise band, every
|
|
177
177
|
movement looks like a trend.
|
|
178
|
-
*Cited by:* `.agent-src.
|
|
178
|
+
*Cited by:* `.agent-src.uncondensed/skills/funnel-analysis/`
|
|
179
179
|
(stage-to-stage drop is read against the typical week-on-week noise).
|
|
180
180
|
|
|
181
181
|
### 16. Leading vs. lagging indicators
|
|
@@ -185,7 +185,7 @@ late. Leading indicators (activation events, repeat-use, support
|
|
|
185
185
|
volume) are noisy and early. Operating on lagging alone means the
|
|
186
186
|
team learns about problems after they cost money. Pair them: lagging
|
|
187
187
|
is the score, leading is the steering wheel.
|
|
188
|
-
*Cited by:* `.agent-src.
|
|
188
|
+
*Cited by:* `.agent-src.uncondensed/skills/dashboard-design/`
|
|
189
189
|
(RED / USE / Golden Signals split leading from lagging explicitly).
|
|
190
190
|
|
|
191
191
|
### 17. Churn as health metric
|
|
@@ -195,7 +195,7 @@ delivers ongoing value. A flat retention tail means the product
|
|
|
195
195
|
works for the survivors; a sliding tail means the underlying job is
|
|
196
196
|
not getting done. Churn is upstream of CAC payback — fix it first,
|
|
197
197
|
then scale.
|
|
198
|
-
*Cited by:* `.agent-src.
|
|
198
|
+
*Cited by:* `.agent-src.uncondensed/skills/funnel-analysis/`
|
|
199
199
|
(retention bend distinguishes activation problems from product-fit).
|
|
200
200
|
|
|
201
201
|
### 18. Pull vs. push systems
|
|
@@ -205,7 +205,7 @@ start work when upstream capacity is free. Push optimizes individual
|
|
|
205
205
|
utilization, pull optimizes flow. Most software teams claim pull and
|
|
206
206
|
operate push (queues filling up, sprints overcommitted, WIP
|
|
207
207
|
unmanaged). The fix is WIP limits, not motivation.
|
|
208
|
-
*Cited by:* `.agent-src.
|
|
208
|
+
*Cited by:* `.agent-src.uncondensed/skills/laravel-horizon/`
|
|
209
209
|
(queue-balance strategies are pull-vs-push policy in concrete form).
|
|
210
210
|
|
|
211
211
|
### 19. Shift-left
|
|
@@ -215,7 +215,7 @@ lifecycle — to the developer's machine, the PR, the design — where
|
|
|
215
215
|
the cost of fixing is order-of-magnitude lower. The trade-off:
|
|
216
216
|
shift-left adds friction at the front; the math holds when defect
|
|
217
217
|
escape rate drops faster than the friction cost.
|
|
218
|
-
*Cited by:* `.agent-src.
|
|
218
|
+
*Cited by:* `.agent-src.uncondensed/skills/threat-modeling/`
|
|
219
219
|
(threats enumerated before implementation, not after pen-test).
|
|
220
220
|
|
|
221
221
|
### 20. Latency vs. throughput
|
|
@@ -225,7 +225,7 @@ not implementation-detail. Batch processing trades latency for
|
|
|
225
225
|
throughput; real-time pipelines trade throughput for latency. The
|
|
226
226
|
mistake is optimizing without naming which one matters for the user
|
|
227
227
|
job at hand.
|
|
228
|
-
*Cited by:* `.agent-src.
|
|
228
|
+
*Cited by:* `.agent-src.uncondensed/skills/database/`
|
|
229
229
|
(index strategy and query batching surface the trade-off explicitly).
|
|
230
230
|
|
|
231
231
|
### 21. Trust boundaries
|
|
@@ -235,7 +235,7 @@ trusted: client → server, tenant A → tenant B, free tier → paid
|
|
|
235
235
|
tier, public endpoint → internal service. Threats enter at boundary
|
|
236
236
|
crossings; defense lives at the crossing, not deeper. Drawing the
|
|
237
237
|
boundary correctly is half the security work.
|
|
238
|
-
*Cited by:* `.agent-src.
|
|
238
|
+
*Cited by:* `.agent-src.uncondensed/skills/threat-modeling/`
|
|
239
239
|
(produces trust boundaries + abuse cases mapped to files).
|
|
240
240
|
|
|
241
241
|
### 22. Defense in depth
|
|
@@ -245,7 +245,7 @@ rules, environment hardening, and instrumentation so a bypass at
|
|
|
245
245
|
one layer is caught at the next. The trap is mistaking redundancy
|
|
246
246
|
for security theatre — each layer must have an independent failure
|
|
247
247
|
mode, not a copy of the previous one.
|
|
248
|
-
*Cited by:* `.agent-src.
|
|
248
|
+
*Cited by:* `.agent-src.uncondensed/skills/defense-in-depth/`
|
|
249
249
|
(turns local fix into structural one across four guard layers).
|
|
250
250
|
|
|
251
251
|
### 23. Blast radius
|
|
@@ -255,7 +255,7 @@ consumer, queue worker, API client, migration, and test that the
|
|
|
255
255
|
change touches. The radius is the work; the diff is the artefact.
|
|
256
256
|
Underestimating radius is the failure mode that breaks production
|
|
257
257
|
when the change "looked small".
|
|
258
|
-
*Cited by:* `.agent-src.
|
|
258
|
+
*Cited by:* `.agent-src.uncondensed/skills/blast-radius-analyzer/`
|
|
259
259
|
(file:line citation per dependency, BEFORE the edit).
|
|
260
260
|
|
|
261
261
|
### 24. Iron triangle (scope / time / quality)
|
|
@@ -264,7 +264,7 @@ Scope, time, and quality are coupled — fix two, the third moves.
|
|
|
264
264
|
Pretending to fix all three is how teams ship at low quality and
|
|
265
265
|
call it on-time. The honest move is naming which two are fixed and
|
|
266
266
|
which one absorbs the variance, BEFORE the work starts.
|
|
267
|
-
*Cited by:* `.agent-src.
|
|
267
|
+
*Cited by:* `.agent-src.uncondensed/skills/refine-ticket/`
|
|
268
268
|
(AC sharpening forces explicit scope decisions before estimation).
|
|
269
269
|
|
|
270
270
|
### 25. Definition of Done
|
|
@@ -274,7 +274,7 @@ work — tests, docs, deployment, comms. Without one, every team
|
|
|
274
274
|
member ships their personal threshold and disputes downstream. The
|
|
275
275
|
discipline is making it visible, agreed, and consistently applied —
|
|
276
276
|
not the specific items on it.
|
|
277
|
-
*Cited by:* `.agent-src.
|
|
277
|
+
*Cited by:* `.agent-src.uncondensed/skills/verify-completion-evidence/`
|
|
278
278
|
(fresh evidence is required before any "done" claim).
|
|
279
279
|
|
|
280
280
|
### 26. Postmortem-driven learning
|
|
@@ -284,7 +284,7 @@ the team that hides the incident. Blameless postmortems separate
|
|
|
284
284
|
contribution from blame, surface systemic causes, and produce
|
|
285
285
|
mitigations that reduce future incident rate — not just the count
|
|
286
286
|
of one-off fixes.
|
|
287
|
-
*Cited by:* `.agent-src.
|
|
287
|
+
*Cited by:* `.agent-src.uncondensed/skills/incident-commander/`
|
|
288
288
|
(severity framing + comms cadence + post-mortem skeleton).
|
|
289
289
|
|
|
290
290
|
### 27. Tech debt as interest
|
|
@@ -294,7 +294,7 @@ payment (the ongoing tax on velocity). Carrying the debt is the
|
|
|
294
294
|
right call when the principal is repayable and the interest is
|
|
295
295
|
small; the failure is treating ongoing high-interest debt as a
|
|
296
296
|
fixed cost. Track it like a balance sheet.
|
|
297
|
-
*Cited by:* `.agent-src.
|
|
297
|
+
*Cited by:* `.agent-src.uncondensed/skills/tech-debt-tracker/`
|
|
298
298
|
(interest-vs-principal framing, prioritisation by carrying cost).
|
|
299
299
|
|
|
300
300
|
### 28. Mise en place
|
|
@@ -304,7 +304,7 @@ before the cooking step starts. Switching between prep and cook is
|
|
|
304
304
|
where errors enter. In software, the analogue is staged commits,
|
|
305
305
|
prepared test fixtures, and decisions locked before implementation.
|
|
306
306
|
The discipline is the savings, not the metaphor.
|
|
307
|
-
*Cited by:* `.agent-src.
|
|
307
|
+
*Cited by:* `.agent-src.uncondensed/skills/existing-ui-audit/`
|
|
308
308
|
(inventory before any non-trivial UI edit, hard gate).
|
|
309
309
|
|
|
310
310
|
### 29. Premortem
|
|
@@ -314,7 +314,7 @@ risks the team already knows but has not voiced. The trick is the
|
|
|
314
314
|
past-tense framing; "what could go wrong" surfaces less than "it
|
|
315
315
|
failed, what happened". Cheap; high signal-to-noise; the residual
|
|
316
316
|
output is a risk register the team actually defends.
|
|
317
|
-
*Cited by:* `.agent-src.
|
|
317
|
+
*Cited by:* `.agent-src.uncondensed/skills/risk-officer/`
|
|
318
318
|
(blast-radius framing, mitigations, residual-risk verdict pre-commit).
|
|
319
319
|
|
|
320
320
|
### 30. Inversion
|
|
@@ -324,7 +324,7 @@ guarantee failure at X?" — then avoid that. Inversion exposes the
|
|
|
324
324
|
non-obvious failure modes that direct planning misses, especially
|
|
325
325
|
in security, ops, and people problems where the failure surface is
|
|
326
326
|
larger than the success surface.
|
|
327
|
-
*Cited by:* `.agent-src.
|
|
327
|
+
*Cited by:* `.agent-src.uncondensed/skills/adversarial-review/`
|
|
328
328
|
(devil's-advocate stress-test poking holes in a plan).
|
|
329
329
|
|
|
330
330
|
## Adding or removing a model
|