@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
package/docs/customization.md
CHANGED
|
@@ -66,7 +66,7 @@ ide
|
|
|
66
66
|
cost_profile
|
|
67
67
|
personal.bot_icon
|
|
68
68
|
personal.autonomy
|
|
69
|
-
|
|
69
|
+
telegraph.speak_scope
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
**Merge order** (lowest → highest precedence; every layer optional):
|
|
@@ -179,7 +179,7 @@ is recovered on the next server boot.
|
|
|
179
179
|
| `chat_history.enabled` | `true` | Persistent JSONL log at `agents/runtime/.agent-chat-history` for crash recovery. |
|
|
180
180
|
| `chat_history.frequency` | per profile | Logging granularity: `per_turn`, `per_phase`, or `per_tool` (see matrix below). |
|
|
181
181
|
| `chat_history.max_size_kb` | per profile | Max file size before overflow handling (see matrix below). |
|
|
182
|
-
| `chat_history.on_overflow` | per profile | `rotate` drops oldest, `
|
|
182
|
+
| `chat_history.on_overflow` | per profile | `rotate` drops oldest, `condense` marks for summarization (see matrix below). |
|
|
183
183
|
| `onboarding.onboarded` | `false` | Whether the setup wizard has run. The `onboarding-gate` rule prompts for `agent-config setup` while this is `false`. |
|
|
184
184
|
| `ai_council.enabled` | `false` | Master switch for the `/council` command. Even when enabled, every consultation asks before spending tokens. |
|
|
185
185
|
| `ai_council.members.<provider>.enabled` | `false` | Per-provider opt-in (`anthropic`, `openai`). Tokens live in `~/.event4u/agent-config/<provider>.key` (mode 0600), never in this file. Legacy `~/.config/agent-config/<provider>.key` is read as a fallback. |
|
|
@@ -226,7 +226,7 @@ to `false` in `.agent-settings.yml` to silence post-task analysis without
|
|
|
226
226
|
changing the profile.
|
|
227
227
|
|
|
228
228
|
The authoritative matrix of all matrix-controlled settings lives in
|
|
229
|
-
[`.agent-src.
|
|
229
|
+
[`.agent-src.uncondensed/templates/agent-settings.md`](../.agent-src.uncondensed/templates/agent-settings.md).
|
|
230
230
|
|
|
231
231
|
### Chat-history defaults per profile
|
|
232
232
|
|
|
@@ -240,13 +240,13 @@ behavior — the per-profile table is just the initial default.
|
|
|
240
240
|
| `chat_history.enabled` | `true` | `true` | `true` |
|
|
241
241
|
| `chat_history.frequency` | `per_turn` | `per_phase` | `per_tool` |
|
|
242
242
|
| `chat_history.max_size_kb` | `128` | `256` | `512` |
|
|
243
|
-
| `chat_history.on_overflow` | `rotate` | `rotate` | `
|
|
243
|
+
| `chat_history.on_overflow` | `rotate` | `rotate` | `condense` |
|
|
244
244
|
|
|
245
245
|
`custom` ignores these defaults — set every value explicitly.
|
|
246
246
|
|
|
247
247
|
### Verbosity
|
|
248
248
|
|
|
249
|
-
The `verbosity:` block and `
|
|
249
|
+
The `verbosity:` block and `telegraph.speak_scope` control how much narration
|
|
250
250
|
the agent emits around routine actions. Defaults are tuned for token
|
|
251
251
|
frugality — flip values to `true` (or higher tier) to restore legacy verbose
|
|
252
252
|
output. Iron-Law gates (`commit-policy`, `scope-control` git-ops,
|
|
@@ -261,10 +261,10 @@ output. Iron-Law gates (`commit-policy`, `scope-control` git-ops,
|
|
|
261
261
|
| `verbosity.intent_announcements` | `true`, `false` | `false` | Intent announcements ("Let me check…", "Now I will…", "Found it") in skill bodies. `false` = act and emit the result. |
|
|
262
262
|
| `verbosity.script_output` | `silent`, `minimal`, `verbose` | `minimal` | Stdout chatter from `scripts/*.py`, `scripts/*.sh`, and `.augment/scripts/`. `silent` = stderr only; `minimal` = one summary line per script; `verbose` = pre-Phase-10 per-step prints. Iron-Law surfaces (release confirms, install secrets prompts, error markers) ignore this key. |
|
|
263
263
|
| `verbosity.taskfile_command_echo` | `true`, `false` | `false` | Suppress the `task: [name] cmd...` echo Taskfile prints before each task body. `true` = echoes preserved (legacy behaviour); `false` = `silent: true` is set on every Phase-10 safe task. |
|
|
264
|
-
| `
|
|
264
|
+
| `telegraph.speak_scope` | `off`, `prose_only`, `aggressive` | `prose_only` | How widely telegraph-speak grammar applies in chat. `off` = no telegraph; `prose_only` = telegraph in body prose, numbered options + Iron-Law-literal blocks stay full prose; `aggressive` = telegraph everywhere except Iron-Law literals. |
|
|
265
265
|
|
|
266
266
|
The cross-rule index for these defaults lives in
|
|
267
|
-
[`.agent-src.
|
|
267
|
+
[`.agent-src.uncondensed/contexts/contracts/frugality-charter.md`](../.agent-src.uncondensed/contexts/contracts/frugality-charter.md).
|
|
268
268
|
Writer skills (`skill-writing`, `rule-writing`, `command-writing`,
|
|
269
269
|
`guideline-writing`, `roadmap-writing`, `persona-writing`,
|
|
270
270
|
`agent-docs-writing`, `context-authoring`, `conventional-commits-writing`,
|
|
@@ -394,7 +394,7 @@ tarball and is the source of truth consumed by:
|
|
|
394
394
|
> When you read "the Laravel pack", picture a filter over the shared
|
|
395
395
|
> artefact tree — not a separate npm package. The day ADR-011's
|
|
396
396
|
> extraction trigger flips, the same scan output drives the split;
|
|
397
|
-
> until then, every artefact lives under `.agent-src.
|
|
397
|
+
> until then, every artefact lives under `.agent-src.uncondensed/`.
|
|
398
398
|
|
|
399
399
|
Alongside the JSON manifest, the scanner writes
|
|
400
400
|
`dist/discovery/discovery-manifest.json.sha256` — a sidecar hash that
|
|
@@ -502,6 +502,26 @@ in `.agent-settings.yml`; the command then exits 0 with a one-line
|
|
|
502
502
|
notice instead of producing a trace. Exit codes: `0` rendered or
|
|
503
503
|
disabled · `1` no recent run found · `2` invocation error.
|
|
504
504
|
|
|
505
|
+
## Troubleshooting
|
|
506
|
+
|
|
507
|
+
### A skill appears twice in my AI tool
|
|
508
|
+
|
|
509
|
+
Most common cause: cross-scope drift between a user-global install (e.g.
|
|
510
|
+
`~/.claude/skills/`) and a project-local install (e.g. `./.claude/skills/`).
|
|
511
|
+
Run the probe to confirm:
|
|
512
|
+
|
|
513
|
+
```bash
|
|
514
|
+
task probe:skills
|
|
515
|
+
# or directly: python3 scripts/probe_skill_registration.py
|
|
516
|
+
```
|
|
517
|
+
|
|
518
|
+
The probe lists every registration across all six tools and flags
|
|
519
|
+
`DUPLICATE` (same skill in ≥ 2 sources) and `DRIFT` (same skill, different
|
|
520
|
+
descriptions or versions — the actual 2026-05-25 failure mode). To clean a
|
|
521
|
+
stale install at the other scope: `bash scripts/cleanup_other_scope.sh --confirm`.
|
|
522
|
+
Background: [`docs/contracts/skill-distribution-channels.md`](contracts/skill-distribution-channels.md)
|
|
523
|
+
+ [`docs/contracts/install-scopes.md`](contracts/install-scopes.md).
|
|
524
|
+
|
|
505
525
|
---
|
|
506
526
|
|
|
507
527
|
← [Back to README](../README.md)
|
|
@@ -37,7 +37,7 @@ landed in `kernel-membership.md` § 5.2:
|
|
|
37
37
|
**Variant (a) — status quo through P2.2 + P3.1.**
|
|
38
38
|
|
|
39
39
|
- Keep `agent-authority` in the kernel.
|
|
40
|
-
- Keep `autonomous-execution` in `
|
|
40
|
+
- Keep `autonomous-execution` in `condense-and-keep` (auto-tier) per
|
|
41
41
|
`docs/contracts/rule-classification.md` § 3.2.
|
|
42
42
|
- Re-evaluate the swap as a P3.2 ADR after the router schema and
|
|
43
43
|
compiler ship.
|
|
@@ -47,7 +47,7 @@ landed in `kernel-membership.md` § 5.2:
|
|
|
47
47
|
### Accepted
|
|
48
48
|
|
|
49
49
|
- 25k hard cap stays intact (no governance erosion via cap-raise).
|
|
50
|
-
- 2 Iron-Law-override ADRs land in P2.2 if post-
|
|
50
|
+
- 2 Iron-Law-override ADRs land in P2.2 if post-condensation
|
|
51
51
|
measurement confirms overage (`direct-answers`, `language-and-tone`).
|
|
52
52
|
- The 9-rule set carried into P2.2 is the locked § 4 list.
|
|
53
53
|
|
|
@@ -78,7 +78,7 @@ precedence at build time. At that point:
|
|
|
78
78
|
(`docs/guidelines/agent-authority.md`) as documentation of the
|
|
79
79
|
band model.
|
|
80
80
|
- `autonomous-execution` can be promoted into the kernel under a
|
|
81
|
-
new ADR (ADR-N) that replaces this one, *if* its post-
|
|
81
|
+
new ADR (ADR-N) that replaces this one, *if* its post-condensation
|
|
82
82
|
size fits the cap with no further demotion.
|
|
83
83
|
|
|
84
84
|
This deferral is **not** indefinite: P3.2 ships the router compiler;
|
|
@@ -90,7 +90,7 @@ migrations) so the migration plan reflects the final kernel set.
|
|
|
90
90
|
- **Variant (b) — swap + raise cap to 27k.** Rejected. Raising the
|
|
91
91
|
hard cap mid-roadmap weakens the original 25k contract that the
|
|
92
92
|
whole roadmap is built around. If 27k turns out to be the real
|
|
93
|
-
ceiling, that is a separate ADR after
|
|
93
|
+
ceiling, that is a separate ADR after condensation measurement
|
|
94
94
|
proves the band, not a pre-emptive concession.
|
|
95
95
|
- **Variant (c) — swap + demote `verify-before-complete`.**
|
|
96
96
|
Rejected. `verify-before-complete` carries criterion #1 (Iron
|
|
@@ -105,5 +105,5 @@ migrations) so the migration plan reflects the final kernel set.
|
|
|
105
105
|
- `docs/contracts/kernel-membership.md` § 4, § 5.2
|
|
106
106
|
- `agents/runtime/council/sessions/20260506T044941Z-phase1-cross-check-r2.json` <!-- council-ref-allowed: ADR decision trace -->
|
|
107
107
|
- `agents/roadmaps/road-to-kernel-and-router.md` § Decisions, § Phase 2
|
|
108
|
-
- `.agent-src.
|
|
109
|
-
- `.agent-src.
|
|
108
|
+
- `.agent-src.uncondensed/rules/agent-authority.md` (subject)
|
|
109
|
+
- `.agent-src.uncondensed/rules/autonomous-execution.md` (proposed promotion)
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# ADR-002 — Kernel-Bucket Cap Raise (25k → 26k) and Per-Rule Iron-Law Overrides
|
|
2
2
|
|
|
3
3
|
- **Status:** Accepted (2026-05-06)
|
|
4
|
-
- **Phase:** Road to Rule Kernel and Router · P2.2 (Heavy
|
|
4
|
+
- **Phase:** Road to Rule Kernel and Router · P2.2 (Heavy Condensation)
|
|
5
5
|
- **Supersedes:** none — extends the Council R2 amendments locked in
|
|
6
6
|
`docs/contracts/kernel-membership.md` § 5.1 (median r=0.712, per-rule cap 2.5k,
|
|
7
7
|
kernel-bucket 25k).
|
|
@@ -10,27 +10,27 @@
|
|
|
10
10
|
|
|
11
11
|
## Context
|
|
12
12
|
|
|
13
|
-
P1.3 projected the post-
|
|
13
|
+
P1.3 projected the post-condensation kernel bucket at **23 071 chars** using
|
|
14
14
|
the median pilot ratio r=0.712 (3 pilots: agent-authority, direct-answers,
|
|
15
15
|
language-and-tone). Pilot rules were **short to medium** (1.0k–2.5k baseline).
|
|
16
16
|
|
|
17
|
-
P2.2 applied the same
|
|
17
|
+
P2.2 applied the same condensation discipline to the remaining 6 kernel rules
|
|
18
18
|
(ask-when-uncertain, commit-policy, no-cheap-questions,
|
|
19
19
|
non-destructive-by-default, scope-control, plus the verify-before-complete
|
|
20
20
|
auto-tier rule kept by ADR-001). Iron-Law SHA preservation verified for
|
|
21
21
|
all 8 rules with Iron-Law fences (`scripts/iron_law_sha.py`).
|
|
22
22
|
|
|
23
|
-
**Empirical post-
|
|
23
|
+
**Empirical post-condensation measurements (2026-05-06):**
|
|
24
24
|
|
|
25
25
|
| metric | projected | actual |
|
|
26
26
|
|---|---:|---:|
|
|
27
27
|
| kernel bucket sum | 23 071 | **25 590** |
|
|
28
|
-
|
|
|
28
|
+
| condensation ratio r (kernel-wide) | 0.712 (median pilot) | **0.795** |
|
|
29
29
|
| rules > 2.5k cap | 2 (pilots) | 6 |
|
|
30
30
|
| rules > 4.0k ceiling | 0 | 0 |
|
|
31
31
|
|
|
32
32
|
The actual ratio (0.795) is worse than the pilot median (0.712) because
|
|
33
|
-
**longer rules
|
|
33
|
+
**longer rules condense less efficiently than short ones**: each Iron-Law
|
|
34
34
|
rule has a fixed payload of frontmatter, Iron-Law fence, exception
|
|
35
35
|
enumeration, see-also list — shrinkage is bounded by what cannot leave
|
|
36
36
|
the rule without breaking the rule's contract. The 5 longest source rules
|
|
@@ -61,7 +61,7 @@ enumeration + pre-send self-check + decline/fence semantics).
|
|
|
61
61
|
| `direct-answers` | 2 841 | +341 | ✓ |
|
|
62
62
|
|
|
63
63
|
3. **Cap stays sticky.** Future kernel additions or rule-body growth must
|
|
64
|
-
either (a)
|
|
64
|
+
either (a) condense within the 26k bucket, (b) externalise to a
|
|
65
65
|
`contexts/authority/*` companion, or (c) require a follow-up ADR.
|
|
66
66
|
|
|
67
67
|
## Rationale
|
|
@@ -92,23 +92,23 @@ place.
|
|
|
92
92
|
The `commit-policy` rule was trimmed below 2.5k (2 354 chars) by removing
|
|
93
93
|
a redundant cross-reference line, demonstrating that aggressive trimming
|
|
94
94
|
is possible where the rule does not carry an enumeration. The 6 overrides
|
|
95
|
-
are the rules where further
|
|
95
|
+
are the rules where further condensation would force semantic loss.
|
|
96
96
|
|
|
97
97
|
## Consequences
|
|
98
98
|
|
|
99
99
|
- **Pro:** Iron-Law fidelity preserved — every fence still byte-identical
|
|
100
100
|
to baseline (verified by `iron_law_sha.py --all-kernel`).
|
|
101
|
-
- **Pro:** Empirical
|
|
101
|
+
- **Pro:** Empirical condensation r=0.795 documented; future kernel work
|
|
102
102
|
uses this as the realistic ratio (not 0.712, which was a pilot-skewed
|
|
103
103
|
optimum).
|
|
104
104
|
- **Pro:** Override ceiling (4 000) untouched — no rule grows
|
|
105
105
|
unboundedly; the 4k cap remains the next checkpoint.
|
|
106
106
|
- **Con:** 25 590 / 26 000 = 98.4 % bucket utilisation. Adding any
|
|
107
|
-
10th kernel rule would require either
|
|
107
|
+
10th kernel rule would require either condensation of an existing rule
|
|
108
108
|
or a further cap raise.
|
|
109
109
|
- **Con:** ratio 0.795 means future "always" promotions cost more than
|
|
110
110
|
Phase 1 estimated. Phase 4 token-budget measurements should treat
|
|
111
|
-
0.795 as the reference
|
|
111
|
+
0.795 as the reference condensation rate.
|
|
112
112
|
|
|
113
113
|
## Rollback
|
|
114
114
|
|
|
@@ -120,7 +120,7 @@ ceiling.
|
|
|
120
120
|
|
|
121
121
|
- [`docs/contracts/command-clusters.md`](../contracts/command-clusters.md)
|
|
122
122
|
— locked cluster set + sub-command naming contract.
|
|
123
|
-
- [`.agent-src.
|
|
123
|
+
- [`.agent-src.uncondensed/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md`](../../.agent-src.uncondensed/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md)
|
|
124
124
|
— runtime routing semantics and the colon-canonical rule.
|
|
125
|
-
- [`.agent-src.
|
|
125
|
+
- [`.agent-src.uncondensed/contexts/execution/roadmap-process-loop.md`](../../.agent-src.uncondensed/contexts/execution/roadmap-process-loop.md)
|
|
126
126
|
— the shared mechanics that motivated the cluster shape.
|
|
@@ -234,7 +234,7 @@ documentation rewrite for marginal additional savings.
|
|
|
234
234
|
(Phase 5.4 R3 raw debate)
|
|
235
235
|
- `docs/decisions/ADR-rule-kernel-and-router.md` (kernel-membership
|
|
236
236
|
contract — Phase 5 changes leave kernel untouched per Lever C lock)
|
|
237
|
-
- `.agent-src.
|
|
238
|
-
- `.agent-src.
|
|
239
|
-
- `.agent-src.
|
|
240
|
-
- `.agent-src.
|
|
237
|
+
- `.agent-src.uncondensed/rules/guidelines.md` (deprecated subject)
|
|
238
|
+
- `.agent-src.uncondensed/rules/size-enforcement.md` (merged subject)
|
|
239
|
+
- `.agent-src.uncondensed/rules/package-ci-checks.md` (demoted subject)
|
|
240
|
+
- `.agent-src.uncondensed/rules/analysis-skill-routing.md` (demoted subject)
|
|
@@ -21,7 +21,7 @@ and specialist review lenses. Step A7 derives from council iter-1
|
|
|
21
21
|
verdict **CC-OQ1 (a)** — adopt the AgentHub pattern from
|
|
22
22
|
`claude-skills` (per-candidate git-worktree isolation) into the
|
|
23
23
|
existing `subagent-orchestration` skill **without** weakening the
|
|
24
|
-
[`non-destructive-by-default`](../../.agent-src.
|
|
24
|
+
[`non-destructive-by-default`](../../.agent-src.uncondensed/rules/non-destructive-by-default.md)
|
|
25
25
|
Hard Floor.
|
|
26
26
|
|
|
27
27
|
The AgentHub pattern in its native form is appealing: spawn N
|
|
@@ -49,13 +49,13 @@ variant** under three Hard-Floor-derived rules:
|
|
|
49
49
|
branch into the integration branch. The user invokes the merge
|
|
50
50
|
explicitly (e.g. `/finishing-a-development-branch`), or the
|
|
51
51
|
orchestrator hands back with a numbered-options block per
|
|
52
|
-
[`user-interaction`](../../.agent-src.
|
|
52
|
+
[`user-interaction`](../../.agent-src.uncondensed/rules/user-interaction.md).
|
|
53
53
|
2. **Ranked presentation.** Judge ranks candidates 1..N with a
|
|
54
54
|
one-line justification per rank. The judge does **not** apply
|
|
55
55
|
anything; ranking is the only output.
|
|
56
56
|
3. **Loser worktrees stay.** The orchestrator does not delete
|
|
57
57
|
losing worktrees automatically. Cleanup happens via
|
|
58
|
-
[`finishing-a-development-branch`](../../.agent-src.
|
|
58
|
+
[`finishing-a-development-branch`](../../.agent-src.uncondensed/skills/finishing-a-development-branch/SKILL.md)
|
|
59
59
|
on user request, after harvesting any salvageable partial idea.
|
|
60
60
|
|
|
61
61
|
Mode 7's chained-handoff variant is unchanged. The two variants
|
|
@@ -114,7 +114,7 @@ Both conditions must hold. Either alone is insufficient.
|
|
|
114
114
|
|
|
115
115
|
- `agents/roadmaps/road-to-better-skills-and-profiles.md` § A7
|
|
116
116
|
(council iter-1 CC-OQ1 verdict (a))
|
|
117
|
-
- `.agent-src.
|
|
118
|
-
- `.agent-src.
|
|
119
|
-
- `.agent-src.
|
|
120
|
-
- `.agent-src.
|
|
117
|
+
- `.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md` § Mode 7
|
|
118
|
+
- `.agent-src.uncondensed/skills/using-git-worktrees/SKILL.md` (mechanics layer)
|
|
119
|
+
- `.agent-src.uncondensed/rules/non-destructive-by-default.md` § Hard Floor catalog
|
|
120
|
+
- `.agent-src.uncondensed/skills/finishing-a-development-branch/SKILL.md` (cleanup path)
|
|
@@ -76,17 +76,17 @@ this — they are a single execution surface.
|
|
|
76
76
|
|
|
77
77
|
## Consequences
|
|
78
78
|
|
|
79
|
-
### (i) What stays under `.agent-src.
|
|
79
|
+
### (i) What stays under `.agent-src.uncondensed/` today
|
|
80
80
|
|
|
81
81
|
The complete video capability stays in the existing flat layout —
|
|
82
82
|
no path changes, no symlink relocation, no namespace prefix:
|
|
83
83
|
|
|
84
|
-
- `.agent-src.
|
|
85
|
-
- `.agent-src.
|
|
84
|
+
- `.agent-src.uncondensed/skills/{character-consistency,motion-choreographer,pixar-storyteller,scene-expander,video-director}/`
|
|
85
|
+
- `.agent-src.uncondensed/personas/{ai-video-technical-director,hollywood-director}.md`
|
|
86
86
|
(the third video persona, `pixar-storyboard-artist`, was folded
|
|
87
87
|
into `skills/pixar-storyteller/` per the persona-cap council pass
|
|
88
88
|
recorded in `persona-governance`)
|
|
89
|
-
- `.agent-src.
|
|
89
|
+
- `.agent-src.uncondensed/commands/video/{from-script,scene,storyboard,stitch}.md`
|
|
90
90
|
- `scripts/ai-video/` (the 5 adapter scripts + `lib/`)
|
|
91
91
|
- `agents/settings/policies/media/` (Phase 2 output — already structured as
|
|
92
92
|
a project-local policy directory, *not* a pack)
|
|
@@ -146,8 +146,8 @@ for ambiguity:
|
|
|
146
146
|
|
|
147
147
|
- The five video adapters (`gemini-veo`, `kling`, `openai-images`,
|
|
148
148
|
`higgsfield`, `sora`) — stay in `scripts/ai-video/`.
|
|
149
|
-
- The two remaining video personas — stay in `.agent-src.
|
|
150
|
-
- The `/video:*` command cluster — stays in `.agent-src.
|
|
149
|
+
- The two remaining video personas — stay in `.agent-src.uncondensed/personas/`.
|
|
150
|
+
- The `/video:*` command cluster — stays in `.agent-src.uncondensed/commands/video/`.
|
|
151
151
|
- The `media-governance-routing` rule + `agents/settings/policies/media/`
|
|
152
152
|
policy files — stay where Phase 2 placed them.
|
|
153
153
|
- The provider-lifecycle contract + the `provider-lifecycle-discipline`
|
|
@@ -142,7 +142,7 @@ matching `config/discovery/packs.yml` row in the same PR.
|
|
|
142
142
|
are accepted; the scanner emits `unassigned[]` warnings; CI logs but
|
|
143
143
|
does not fail.
|
|
144
144
|
- **Phase 4**: every artefact under
|
|
145
|
-
`.agent-src.
|
|
145
|
+
`.agent-src.uncondensed/{skills,rules,commands,templates}` either
|
|
146
146
|
declares the new keys, or sits in `config/discovery/unassigned-artefacts.yml`
|
|
147
147
|
with a one-line reason.
|
|
148
148
|
- **Phase 4+**: CI flips strict; missing annotation is a fail.
|
|
@@ -150,7 +150,7 @@ matching `config/discovery/packs.yml` row in the same PR.
|
|
|
150
150
|
### Trust-root allow-list (security-engineer council fold-in)
|
|
151
151
|
|
|
152
152
|
The scanner honours frontmatter only on files under the trusted roots:
|
|
153
|
-
`.augment/`, `.claude/`, `.agent-src.
|
|
153
|
+
`.augment/`, `.claude/`, `.agent-src.uncondensed/`, `.agent-src/`.
|
|
154
154
|
Files under `agents/`, `tmp/`, or any consumer-writable path **cannot**
|
|
155
155
|
claim ownership of a workspace or pack. Phase 2 enforces.
|
|
156
156
|
|
|
@@ -201,7 +201,7 @@ discovery-driven action.
|
|
|
201
201
|
|
|
202
202
|
The five required keys (`workspaces`, `packs`, `lifecycle`, `trust`,
|
|
203
203
|
`install`) are now **strictly enforced** across every artefact under
|
|
204
|
-
`.agent-src.
|
|
204
|
+
`.agent-src.uncondensed/{skills,rules,commands,templates}` by
|
|
205
205
|
[`scripts/lint_artefact_frontmatter.py`](../../scripts/lint_artefact_frontmatter.py),
|
|
206
206
|
wired into `task lint-artefact-frontmatter`, `task ci`, and the opt-in
|
|
207
207
|
combined pre-commit hook (`./agent-config hooks:install`). The migration
|
|
@@ -66,10 +66,10 @@ install-axis without a current consumer. Re-evaluate in Phase 5.
|
|
|
66
66
|
|
|
67
67
|
### Source-of-truth tree
|
|
68
68
|
|
|
69
|
-
The generator walks `.agent-src.
|
|
70
|
-
The Phase-2 roadmap text §Phase 2 says "the
|
|
69
|
+
The generator walks `.agent-src.uncondensed/`, **not** `.agent-src/`.
|
|
70
|
+
The Phase-2 roadmap text §Phase 2 says "the condensed canonical tree"
|
|
71
71
|
— that is a documentation slip. `augment-source-of-truth` rule states
|
|
72
|
-
that
|
|
72
|
+
that uncondensed is canonical; the condensed tree is a build output
|
|
73
73
|
and may be regenerated. Manifest pipelines that read build outputs are
|
|
74
74
|
fragile to bootstrap order.
|
|
75
75
|
|
|
@@ -36,7 +36,7 @@ TypeScript installer **without** moving a single file. The on-disk
|
|
|
36
36
|
source tree is still flat:
|
|
37
37
|
|
|
38
38
|
```text
|
|
39
|
-
.agent-src.
|
|
39
|
+
.agent-src.uncondensed/
|
|
40
40
|
rules/ # 72 entries
|
|
41
41
|
skills/ # 218 entries
|
|
42
42
|
commands/ # 129 entries
|
|
@@ -64,11 +64,11 @@ refs, cross-pack drift, hand-edited paths) all bite hardest here.
|
|
|
64
64
|
packages/
|
|
65
65
|
core/
|
|
66
66
|
installer/ # TS CLI (already there post-Phase 3)
|
|
67
|
-
.agent-src.
|
|
68
|
-
pack-php/.agent-src.
|
|
69
|
-
pack-laravel/.agent-src.
|
|
67
|
+
.agent-src.uncondensed/ # rules + kernel skills + scaffolds
|
|
68
|
+
pack-php/.agent-src.uncondensed/
|
|
69
|
+
pack-laravel/.agent-src.uncondensed/
|
|
70
70
|
…
|
|
71
|
-
pack-ai-video/.agent-src.
|
|
71
|
+
pack-ai-video/.agent-src.uncondensed/
|
|
72
72
|
```
|
|
73
73
|
|
|
74
74
|
No flag day: every commit between "before" and "after" the move builds
|
|
@@ -98,7 +98,7 @@ Implemented in [`scripts/plan_physical_move.py`](../../scripts/plan_physical_mov
|
|
|
98
98
|
6. **Quarantined scaffolds** (the 26 entries in
|
|
99
99
|
[`config/discovery/unassigned-artefacts.yml`](../../config/discovery/unassigned-artefacts.yml))
|
|
100
100
|
→ `packages/core/` with `unassigned scaffold:` reason recorded in the
|
|
101
|
-
move plan. The top-level `.agent-src.
|
|
101
|
+
move plan. The top-level `.agent-src.uncondensed/README.md` was added
|
|
102
102
|
here during dry-run.
|
|
103
103
|
7. **`primary pack: meta`** → `packages/core/` (package-internal
|
|
104
104
|
scaffolding, not a real pack).
|
|
@@ -135,7 +135,7 @@ installer behaviour change.
|
|
|
135
135
|
- Metadata-to-disk parity: a consumer can now `cd packages/pack-laravel`
|
|
136
136
|
and see exactly what `pack.laravel` ships, no manifest indirection.
|
|
137
137
|
- Phase 5 (trust) lands cleanly inside `packages/core/installer/` and
|
|
138
|
-
reads per-pack metadata from `packages/pack-*/.agent-src.
|
|
138
|
+
reads per-pack metadata from `packages/pack-*/.agent-src.uncondensed/`.
|
|
139
139
|
- Phase 6 (browser wizard) maps packs 1:1 to its left-nav.
|
|
140
140
|
- Cross-pack drift is now lintable (`task lint-pack-boundaries` in
|
|
141
141
|
Phase 4.4 of the roadmap).
|
|
@@ -172,11 +172,11 @@ installer behaviour change.
|
|
|
172
172
|
Four blocking items and two refinements raised by the council; each
|
|
173
173
|
resolved before `--apply` runs.
|
|
174
174
|
|
|
175
|
-
### B1 — Final source location of `.agent-src.
|
|
175
|
+
### B1 — Final source location of `.agent-src.uncondensed/`
|
|
176
176
|
|
|
177
177
|
The council asked whether the source tree nests inside `packages/core/`
|
|
178
178
|
(current design) or becomes a peer `pack-core/`. **Decision: keep
|
|
179
|
-
`packages/core/.agent-src.
|
|
179
|
+
`packages/core/.agent-src.uncondensed/`.** Three reasons:
|
|
180
180
|
|
|
181
181
|
1. `packages/core/` is the engine + installer + kernel rules +
|
|
182
182
|
scaffolding (templates, profiles, presets, contexts, user-types).
|
|
@@ -199,7 +199,7 @@ similarity) on every moved file. Verification script enforces this.
|
|
|
199
199
|
|
|
200
200
|
### B3 — Consumer-facing output contract
|
|
201
201
|
|
|
202
|
-
`task sync` writes `.agent-src/` (
|
|
202
|
+
`task sync` writes `.agent-src/` (condensed) and `.augment/` (overlay)
|
|
203
203
|
at repo root — **unchanged** location and structure. The byte-identity
|
|
204
204
|
contract covers exactly these two trees plus the discovery manifest.
|
|
205
205
|
What changes:
|
|
@@ -16,7 +16,7 @@ type: prospective
|
|
|
16
16
|
**Accepted** · 2026-05-21 · external AI Council pass on the Phase 5
|
|
17
17
|
roadmap (`claude-sonnet-4-5` + `gpt-4o`, `design` lens). Council
|
|
18
18
|
confirmed the closed-enum trust ladder, the per-pack safety-floor
|
|
19
|
-
rule, and the
|
|
19
|
+
rule, and the condenseor-injected HRR banner; refinement folded into
|
|
20
20
|
the lint script and the installer's confirm copy.
|
|
21
21
|
|
|
22
22
|
Session: [`agents/runtime/council/responses/phase-5-trust-safety.json`](../../agents/runtime/council/responses/phase-5-trust-safety.json) <!-- council-ref-allowed: ADR decision-trace -->
|
|
@@ -25,7 +25,7 @@ Companion artefacts:
|
|
|
25
25
|
- Contract: [`docs/contracts/trust-and-safety.md`](../contracts/trust-and-safety.md)
|
|
26
26
|
- Roadmap: [`agents/roadmaps/monorepo-phase-5-trust-safety-layer.md`](../../agents/roadmaps/monorepo-phase-5-trust-safety-layer.md)
|
|
27
27
|
- Lint: [`scripts/lint_trust_coherence.py`](../../scripts/lint_trust_coherence.py) + [`tests/test_lint_trust_coherence.py`](../../tests/test_lint_trust_coherence.py)
|
|
28
|
-
-
|
|
28
|
+
- Condenseor: [`scripts/condense.py`](../../scripts/condense.py) (`_inject_hrr_banner`)
|
|
29
29
|
- Installer: [`packages/core/installer/src/trust-escalation.ts`](../../packages/core/installer/src/trust-escalation.ts)
|
|
30
30
|
|
|
31
31
|
## Context
|
|
@@ -44,7 +44,7 @@ After Phase 4 we had the **metadata** end-to-end but **no enforcement**:
|
|
|
44
44
|
- Installer treated all packs identically — no surface for advisory
|
|
45
45
|
content, no confirm step before opting into legally-flavoured
|
|
46
46
|
finance / strategy material.
|
|
47
|
-
-
|
|
47
|
+
- Condenseor preserved frontmatter but did not propagate the
|
|
48
48
|
`human_review_required` signal into the compiled artefact, so the
|
|
49
49
|
runtime had no parser-stable hook to gate output on.
|
|
50
50
|
- Domain-specific safety floors (finance, founder-strategy,
|
|
@@ -70,10 +70,10 @@ Ship a four-piece trust & safety layer:
|
|
|
70
70
|
1. **Closed-enum trust ladder.** `core` · `professional` · `advisory`
|
|
71
71
|
· `restricted` · `experimental`. Authoritative table and meaning
|
|
72
72
|
live in [`trust-and-safety § 1`](../contracts/trust-and-safety.md#-1--trust-levels).
|
|
73
|
-
2. **HRR banner injection.** The
|
|
73
|
+
2. **HRR banner injection.** The condenseor scans frontmatter and
|
|
74
74
|
prepends `<!-- agent-config:human-review-banner -->\n> HUMAN REVIEW
|
|
75
75
|
REQUIRED · trust: <level> · owner: <domain>` to any artefact with
|
|
76
|
-
`trust.human_review_required: true`. Idempotent on re-
|
|
76
|
+
`trust.human_review_required: true`. Idempotent on re-condensation.
|
|
77
77
|
3. **Per-pack safety-floor rules.** `core` ships
|
|
78
78
|
`engineering-safety-floor.md`; `pack-finance-basic` ships
|
|
79
79
|
`finance-safety-floor.md`; `pack-founder-strategy` ships
|
|
@@ -97,7 +97,7 @@ Ship a four-piece trust & safety layer:
|
|
|
97
97
|
### Good
|
|
98
98
|
|
|
99
99
|
- **Single source of trust truth.** The frontmatter field is the
|
|
100
|
-
one input; the installer,
|
|
100
|
+
one input; the installer, condenseor, lint, and runtime all read
|
|
101
101
|
it. No parallel registry, no duplicated copy.
|
|
102
102
|
- **Banner is parser-stable.** The HTML-comment marker survives every
|
|
103
103
|
downstream surface (Augment, Claude, Cursor, Windsurf) because it is
|
|
@@ -101,8 +101,8 @@ Rationale:
|
|
|
101
101
|
`docs/contracts/explain-trace.schema.json`,
|
|
102
102
|
`docs/adrs/router/0001-three-tier-routing.md`,
|
|
103
103
|
`docs/adrs/smoke/0001-per-tier-smoke-scripts.md`.
|
|
104
|
-
- **Source rules.**
|
|
105
|
-
(`
|
|
104
|
+
- **Source rules.** Uncondensed rule sources referencing the path
|
|
105
|
+
(`telegraph-speak.md`, `git-history-discipline.md`) updated and
|
|
106
106
|
re-projected.
|
|
107
107
|
|
|
108
108
|
## Reversal cost
|
|
@@ -25,7 +25,7 @@ Companion artefacts:
|
|
|
25
25
|
- Wizard contract: [`docs/contracts/gui-wizard.md`](../contracts/gui-wizard.md)
|
|
26
26
|
- Predecessor ADR: [`ADR-007`](ADR-007-agent-discovery-scopes.md) — scope precedence, global-default amendment
|
|
27
27
|
- Perms entry-gate: [`scripts/lint_global_paths.py`](../../scripts/lint_global_paths.py)
|
|
28
|
-
- Payload schema: [`schemas/wizard-apply-payload.schema.json`](../../schemas/wizard-apply-payload.schema.json)
|
|
28
|
+
- Payload schema: [`internal/schemas/wizard-apply-payload.schema.json`](../../internal/schemas/wizard-apply-payload.schema.json)
|
|
29
29
|
|
|
30
30
|
## Context
|
|
31
31
|
|
|
@@ -65,7 +65,7 @@ fanning out from there.
|
|
|
65
65
|
|
|
66
66
|
The single project-local exception is `agents/overrides/`, which
|
|
67
67
|
remains the canonical place to override or extend a shared skill /
|
|
68
|
-
rule / command per [override-management](../../.agent-src.
|
|
68
|
+
rule / command per [override-management](../../.agent-src.uncondensed/skills/override-management/SKILL.md).
|
|
69
69
|
|
|
70
70
|
The maintainer-side dev experience is preserved by the
|
|
71
71
|
`AGENT_CONFIG_DEV_MODE=1` environment gate documented in
|
|
@@ -25,7 +25,7 @@ Companion artefacts:
|
|
|
25
25
|
- Roadmap: [`agents/roadmaps/road-to-internal-ai-os-deployment.md`](../../agents/roadmaps/road-to-internal-ai-os-deployment.md)
|
|
26
26
|
- Artefacts: [`packages/core/deploy/`](../../packages/core/deploy/)
|
|
27
27
|
- Env contract: [`docs/deploy/env-vars.md`](../deploy/env-vars.md)
|
|
28
|
-
- Council question (drafted, not invoked — no keys): [`agents/tmp/council-question-deployment-shape.md`](../../agents/tmp/council-question-deployment-shape.md)
|
|
28
|
+
- Council question (drafted, not invoked — no keys): [`agents/tmp/council-question-deployment-shape.md`](../../agents/tmp/old/council-question-deployment-shape.md)
|
|
29
29
|
- Predecessor ADR: [`ADR-016`](ADR-016-installer-architecture.md) — installer architecture (agent-mode protocol the GUI server wraps).
|
|
30
30
|
|
|
31
31
|
## Context
|
|
@@ -64,7 +64,7 @@ their own chart using this Compose as the reference until v2 ships.
|
|
|
64
64
|
The GUI server (`packages/core/installer/src/gui/server.ts`) is the
|
|
65
65
|
only long-running process. The Python install supervisor is spawned
|
|
66
66
|
per-install, not a sidecar. The Compose image stays Node-only to keep
|
|
67
|
-
the budget under 600 MB
|
|
67
|
+
the budget under 600 MB condensed and the surface area minimal.
|
|
68
68
|
|
|
69
69
|
If Phase 2+ needs a separate identity-broker process, it lands in a
|
|
70
70
|
separate service in the same Compose; the agent-config container stays
|
|
@@ -141,7 +141,7 @@ orchestrator-agnostic.
|
|
|
141
141
|
## Open questions (council-deferred)
|
|
142
142
|
|
|
143
143
|
The accompanying council question file
|
|
144
|
-
[`agents/tmp/council-question-deployment-shape.md`](../../agents/tmp/council-question-deployment-shape.md)
|
|
144
|
+
[`agents/tmp/council-question-deployment-shape.md`](../../agents/tmp/old/council-question-deployment-shape.md)
|
|
145
145
|
has not yet been run (no provider keys configured). A maintainer with
|
|
146
146
|
keys should run it and either ratify or supersede this ADR.
|
|
147
147
|
|
|
@@ -31,7 +31,7 @@ Companion artefacts:
|
|
|
31
31
|
|
|
32
32
|
- Roadmap: [`agents/roadmaps/road-to-employee-product-and-external-proof.md`](../../agents/roadmaps/road-to-employee-product-and-external-proof.md)
|
|
33
33
|
- Council question: [`agents/decisions/open-questions/daily-workspace-shape.md`](../../agents/decisions/open-questions/daily-workspace-shape.md)
|
|
34
|
-
- Council verdict: `agents/runtime/council/responses/daily-workspace-shape.json` (gitignored)
|
|
34
|
+
- Council verdict: `agents/runtime/council/responses/daily-workspace-shape.json` (gitignored) <!-- council-ref-allowed: ADR decision trace -->
|
|
35
35
|
- Predecessor ADRs: [`ADR-014`](ADR-014-gui-framework-choice.md) (installer chrome), [`ADR-016`](ADR-016-installer-architecture.md) (installer architecture), [`ADR-020`](ADR-020-global-only-consumer-scope.md) (consumer scope).
|
|
36
36
|
|
|
37
37
|
## Context
|
|
@@ -57,7 +57,7 @@ of narrative + bullets in the current convention):
|
|
|
57
57
|
|---|---:|---:|---:|
|
|
58
58
|
| **Token budget per release** | ~2.8k (141 lines × ~80 chars) | ~1.1k (38 commits × ~120 chars) | ~2.6k (same as current; bullets generated, paragraph hand-written) |
|
|
59
59
|
| **Maintainer minutes per release** | 5–15 (write narrative; auto-split runs in `task release`) | 0 direct + ~30/month policing commit messages | 5–10 (paragraph only) |
|
|
60
|
-
| **Information density per line** | high — narrative
|
|
60
|
+
| **Information density per line** | high — narrative condenses 5–10 bullets of context | low — every infrastructure commit becomes a line | high — same as current |
|
|
61
61
|
| **Parseability for downstream agents** | high — `### Features` / `### Fixes` / `### BREAKING` are semantic anchors | medium — same headings, but no narrative anchor to disambiguate scope churn | high |
|
|
62
62
|
| **Hands-off failure mode** | era over-cap → auto-split fires | commit-message drift pollutes the log → no recovery without rewriting commits | narrative drift → degrades to release-please equivalent |
|
|
63
63
|
|
|
@@ -123,7 +123,7 @@ entries over a flat commit dump.
|
|
|
123
123
|
|
|
124
124
|
- [`docs/contracts/CHANGELOG-conventions.md`](../contracts/CHANGELOG-conventions.md) — convention being confirmed.
|
|
125
125
|
- [`agents/roadmaps/archive/road-to-changelog-era-auto-split.md`](../../agents/roadmaps/archive/road-to-changelog-era-auto-split.md) — closes Phase 4.
|
|
126
|
-
- [`agents/runtime/council/responses/changelog-era-split-2026-05-25.json`](../../agents/runtime/council/responses/changelog-era-split-2026-05-25.json) — the originating council synthesis.
|
|
126
|
+
- [`agents/runtime/council/responses/changelog-era-split-2026-05-25.json`](../../agents/runtime/council/responses/changelog-era-split-2026-05-25.json) — the originating council synthesis. <!-- council-ref-allowed: ADR decision trace -->
|
|
127
127
|
- `scripts/_lib/changelog_eras.py` — shared cap + splitter (Tier 2 output).
|
|
128
128
|
- `scripts/release.py:818` — `plan.changelog_body` → GitHub Release notes wire.
|
|
129
129
|
- `tests/test_changelog_eras.py`, `tests/test_changelog_split.py` — gate + splitter coverage.
|
|
@@ -15,7 +15,7 @@ review_date: 2027-05-25
|
|
|
15
15
|
## Status
|
|
16
16
|
|
|
17
17
|
**Accepted** · 2026-05-25. Encodes the AI Council verdict from
|
|
18
|
-
[`root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md)
|
|
18
|
+
[`root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md) <!-- council-ref-allowed: ADR decision trace -->
|
|
19
19
|
and opens
|
|
20
20
|
[`road-to-root-layout-cleanup.md`](../../agents/roadmaps/archive/road-to-root-layout-cleanup.md) (archived; complete).
|
|
21
21
|
Time-boxed: review on **2027-05-25** or earlier if any trigger below fires.
|
|
@@ -48,7 +48,7 @@ conditional follow-up gated by evidence the package does not yet have.
|
|
|
48
48
|
Re-audit of `bench/`, `evals/`, `workers/`, `user-types/` against the
|
|
49
49
|
installer / projector / CI:
|
|
50
50
|
|
|
51
|
-
| Dir | `scripts/install.py` | `scripts/
|
|
51
|
+
| Dir | `scripts/install.py` | `scripts/condense.py` projection | `.github/workflows/*` | Verdict |
|
|
52
52
|
|---|---|---|---|---|
|
|
53
53
|
| `bench/` | — | — | `bench-drift.yml` (path filter) | **movable** |
|
|
54
54
|
| `evals/` | — | — | — | **movable** |
|
|
@@ -91,7 +91,7 @@ Four audits must complete and pass before Phase 3 opens:
|
|
|
91
91
|
`scripts/`, `templates/`, `config/`, `schemas/` references.
|
|
92
92
|
2. **Symlink-mobility test** — verify Cursor / Claude / Windsurf
|
|
93
93
|
honor symlinked projections (`.cursor/` → `./projections/.cursor/`).
|
|
94
|
-
3. **Hash-sequencing audit** — confirm `.
|
|
94
|
+
3. **Hash-sequencing audit** — confirm `.condensation-hashes.json`
|
|
95
95
|
uses paths that survive `.agent-src/` relocation (or document the
|
|
96
96
|
regeneration migration).
|
|
97
97
|
4. **CI-path audit** — every hardcoded path in
|
|
@@ -131,17 +131,17 @@ blocker.
|
|
|
131
131
|
|---|---|
|
|
132
132
|
| Move everything into `./src/` (original request) | `./src/` is the TS app per ADR-012/016. Collision. |
|
|
133
133
|
| Option 2 — `./tooling/` umbrella with `templates/` / `config/` / `schemas/` | Council: cost underestimated (duplicate-then-deprecate + 2-month window + major bump); installer paths in those dirs are unaudited. |
|
|
134
|
-
| Option 3 — full category-coded migration | Council hard-reject: projection mobility unproven;
|
|
134
|
+
| Option 3 — full category-coded migration | Council hard-reject: projection mobility unproven; condensation-hash sequencing risk; unshippable without symlink test. |
|
|
135
135
|
| Option 4 — `MAP.md` documentation | Council: adds 51st entry; documentation-as-apology; AGENTS.md already serves this role. |
|
|
136
136
|
| Skip Phase 1, jump to multi-workspace prototype | Loses the cheap visible win; Phase 2 audits unfunded; risks scope creep into Phase 3. |
|
|
137
137
|
|
|
138
138
|
## References
|
|
139
139
|
|
|
140
|
-
- [`agents/runtime/council/questions/root-cleanup-organizing-principle-2026-05-25.md`](../../agents/runtime/council/questions/root-cleanup-organizing-principle-2026-05-25.md) — council brief.
|
|
141
|
-
- [`agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md) — full synthesis.
|
|
140
|
+
- [`agents/runtime/council/questions/root-cleanup-organizing-principle-2026-05-25.md`](../../agents/runtime/council/questions/root-cleanup-organizing-principle-2026-05-25.md) — council brief. <!-- council-ref-allowed: ADR decision trace -->
|
|
141
|
+
- [`agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md) — full synthesis. <!-- council-ref-allowed: ADR decision trace -->
|
|
142
142
|
- [`agents/roadmaps/archive/road-to-root-layout-cleanup.md`](../../agents/roadmaps/archive/road-to-root-layout-cleanup.md) — execution roadmap (archived; Phase 1 ✅, Phase 2 ✅, Phase 3 closed).
|
|
143
143
|
- [`agents/evidence/audits/2026-05-root-layout-phase2/`](../../agents/evidence/audits/2026-05-root-layout-phase2/) — Phase 2 audit verdict bundle.
|
|
144
144
|
- [`ADR-029`](ADR-029-multi-workspace-deferred.md) — Phase 3 close-out (multi-workspace deferred indefinitely).
|
|
145
145
|
- [`ADR-012`](ADR-012-typescript-cli-shell.md), [`ADR-016`](ADR-016-installer-architecture.md) — `./src/` is the TS app.
|
|
146
146
|
- [`ADR-019`](ADR-019-router-json-dist-location.md) — `router.json` lives in `./dist/`.
|
|
147
|
-
- `scripts/install.py:52` (`USER_TYPES_DIR`), `scripts/
|
|
147
|
+
- `scripts/install.py:52` (`USER_TYPES_DIR`), `scripts/condense.py:1106` (`AUGMENT_SYMLINK_DIRS`) — evidence pinning `user-types/` to root.
|
|
@@ -118,5 +118,5 @@ Phase 3 becomes eligible when **all** of these hold:
|
|
|
118
118
|
full audit bundle (4 verdict files + README).
|
|
119
119
|
- [`agents/roadmaps/archive/road-to-root-layout-cleanup.md`](../../agents/roadmaps/archive/road-to-root-layout-cleanup.md) —
|
|
120
120
|
execution roadmap, archived (Phase 1 ✅, Phase 2 ✅, Phase 3 closed via this ADR).
|
|
121
|
-
- [`agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md)
|
|
122
|
-
original council synthesis that proposed the multi-workspace shape.
|
|
121
|
+
- [`agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md) <!-- council-ref-allowed: ADR decision trace -->
|
|
122
|
+
— original council synthesis that proposed the multi-workspace shape.
|