@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
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "2a"
|
|
4
|
-
description: "Editing .augment/ or .agent-src.
|
|
4
|
+
description: "Editing .augment/ or .agent-src.uncondensed/ — keep files project-agnostic; sync counts and cross-refs on add/rename/delete"
|
|
5
5
|
source: package
|
|
6
6
|
triggers:
|
|
7
7
|
- path_prefix: ".augment/"
|
|
8
|
-
- path_prefix: ".agent-src.
|
|
8
|
+
- path_prefix: ".agent-src.uncondensed/"
|
|
9
9
|
- keyword: "portable"
|
|
10
10
|
- keyword: "rename"
|
|
11
11
|
- keyword: "delete"
|
|
@@ -14,8 +14,8 @@ routes_to:
|
|
|
14
14
|
- "skill:agent-docs-writing"
|
|
15
15
|
validator_ignore:
|
|
16
16
|
- type: "substring"
|
|
17
|
-
pattern: ".agent-src.
|
|
18
|
-
reason: "Rule scopes the portability gate to the
|
|
17
|
+
pattern: ".agent-src.uncondensed/"
|
|
18
|
+
reason: "Rule scopes the portability gate to the uncondensed authoring tree."
|
|
19
19
|
workspaces:
|
|
20
20
|
- agent-config-maintainer
|
|
21
21
|
packs:
|
|
@@ -32,7 +32,7 @@ install:
|
|
|
32
32
|
|
|
33
33
|
# Augment Edit Discipline
|
|
34
34
|
|
|
35
|
-
**Iron Law (portability).** Files inside `.augment/` and `.agent-src.
|
|
35
|
+
**Iron Law (portability).** Files inside `.augment/` and `.agent-src.uncondensed/` MUST stay project-agnostic — no project names, domains, stacks.
|
|
36
36
|
|
|
37
37
|
**Iron Law (sync).** On any add / rename / delete of skill / rule / command / guideline, update counts and cross-references in the same edit.
|
|
38
38
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
type: "auto"
|
|
3
3
|
tier: "1"
|
|
4
|
-
description: "Editing files in .agent-src/ or .augment/ — source of truth is .agent-src.
|
|
4
|
+
description: "Editing files in .agent-src/ or .augment/ — source of truth is .agent-src.uncondensed/; never edit generated dirs directly"
|
|
5
5
|
source: package
|
|
6
6
|
load_context:
|
|
7
7
|
- ../contexts/communication/rules-auto/augment-source-of-truth-mechanics.md
|
|
@@ -12,7 +12,7 @@ triggers:
|
|
|
12
12
|
- path_prefix: ".cursor/"
|
|
13
13
|
validator_ignore:
|
|
14
14
|
- type: "substring"
|
|
15
|
-
pattern: ".agent-src.
|
|
15
|
+
pattern: ".agent-src.uncondensed/"
|
|
16
16
|
reason: "Rule documents the source-of-truth boundary; mentioning the path is its purpose."
|
|
17
17
|
workspaces:
|
|
18
18
|
- agent-config-maintainer
|
|
@@ -30,14 +30,14 @@ install:
|
|
|
30
30
|
|
|
31
31
|
# Source of Truth
|
|
32
32
|
|
|
33
|
-
`.agent-src.
|
|
33
|
+
`.agent-src.uncondensed/` is the **single source of truth**. The condensed
|
|
34
34
|
output ships as `.agent-src/`. In the package repo, `.augment/` is a local
|
|
35
35
|
projection of `.agent-src/` for Augment Code (rules copied, rest symlinked).
|
|
36
36
|
Consumer projects still see `.augment/` as the installed runtime tree.
|
|
37
37
|
|
|
38
38
|
Never edit any of these generated layers directly:
|
|
39
39
|
|
|
40
|
-
- `.agent-src/` —
|
|
40
|
+
- `.agent-src/` — condensed output shipped in the package
|
|
41
41
|
- `.augment/` — local projection (gitignored in the package repo; installer
|
|
42
42
|
output in consumer projects)
|
|
43
43
|
- `.claude/`, `.cursor/`, `.clinerules/`, `.windsurfrules` — tool projections
|
|
@@ -46,36 +46,36 @@ Never edit any of these generated layers directly:
|
|
|
46
46
|
|
|
47
47
|
```
|
|
48
48
|
NEVER CREATE OR EDIT FILES IN .agent-src/ OR .augment/ DIRECTLY — NOT EVEN "JUST A SMALL FIX".
|
|
49
|
-
ALWAYS WORK IN .agent-src.
|
|
49
|
+
ALWAYS WORK IN .agent-src.uncondensed/ — THEN CONDENSE VIA THE /condense COMMAND.
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
**There are ZERO exceptions to this rule.** Even if:
|
|
53
53
|
|
|
54
|
-
- You "know" the
|
|
54
|
+
- You "know" the condensed content is correct
|
|
55
55
|
- It's "just adding a missing section"
|
|
56
|
-
- It's "faster to edit the
|
|
56
|
+
- It's "faster to edit the condensed file directly"
|
|
57
57
|
- The fix is "trivially obvious"
|
|
58
58
|
|
|
59
|
-
**STOP. Edit `.agent-src.
|
|
59
|
+
**STOP. Edit `.agent-src.uncondensed/` first. Always.**
|
|
60
60
|
|
|
61
|
-
Direct edits to `.agent-src/` break
|
|
62
|
-
("Verify
|
|
61
|
+
Direct edits to `.agent-src/` break condensation hashes, cause CI failures
|
|
62
|
+
("Verify condensation hashes" step), and create drift between source and output.
|
|
63
63
|
|
|
64
|
-
**
|
|
64
|
+
**Condensation is ONLY done via the `/condense` command.** The command handles
|
|
65
65
|
hashing, sync verification, and quality checks automatically.
|
|
66
66
|
|
|
67
67
|
## Pre-review consistency checkpoints
|
|
68
68
|
|
|
69
69
|
Before asking for review or creating a PR, verify derived outputs are not stale:
|
|
70
70
|
|
|
71
|
-
1. Run `bash scripts/
|
|
72
|
-
2. If stale files exist: run `/
|
|
71
|
+
1. Run `bash scripts/condense.sh --changed` — check if `.agent-src.uncondensed/` has changes not yet condensed
|
|
72
|
+
2. If stale files exist: run `/condense` before pushing
|
|
73
73
|
3. Before merge: verify derived outputs (`.agent-src/`, `.augment/`, `.claude/skills/`) are regenerated
|
|
74
74
|
4. Do NOT leave `.agent-src/` stale across review cycles
|
|
75
75
|
|
|
76
|
-
## Mechanics — workflow,
|
|
76
|
+
## Mechanics — workflow, condensation rules, commands, symlinks, quick reference
|
|
77
77
|
|
|
78
|
-
The authoring workflow, what
|
|
78
|
+
The authoring workflow, what condensation does (and never touches), the
|
|
79
79
|
commands workflow with required frontmatter, the multi-agent symlink
|
|
80
80
|
mapping, and the per-task quick-reference table live in
|
|
81
81
|
[`contexts/communication/rules-auto/augment-source-of-truth-mechanics.md`](../contexts/communication/rules-auto/augment-source-of-truth-mechanics.md).
|
|
@@ -25,7 +25,7 @@ install:
|
|
|
25
25
|
|
|
26
26
|
# Commit Conventions
|
|
27
27
|
|
|
28
|
-
**Iron Law.** Use Conventional Commits (`feat:`, `fix:`, `chore:` …); branches `<type>/<short-slug>`; never invent your own format.
|
|
28
|
+
**Iron Law.** Use Conventional Commits (`feat:`, `fix:`, `chore:` …); branches `<type>/<short-slug>`; never invent your own format. Subjects + branch names stay emoji-free per [`no-decorative-emojis-in-git-surfaces`](no-decorative-emojis-in-git-surfaces.md); body emojis allowed only with an in-artifact legend.
|
|
29
29
|
|
|
30
30
|
Body migrated to `skill:conventional-commits-writing` (per P4 of `road-to-kernel-and-router.md`).
|
|
31
31
|
Trigger-set above activates this routing under the `balanced` and `full` profiles.
|
|
@@ -48,6 +48,16 @@ Anything else → no commit. Hard Floor (bulk deletions, infra changes) still fi
|
|
|
48
48
|
|
|
49
49
|
Quoted commit phrases (chat-log paste, log excerpt, roadmap snippet) are **not** permission — see [`commit-mechanics § Speech-act check`](../contexts/authority/commit-mechanics.md).
|
|
50
50
|
|
|
51
|
+
## Always split into logical chunks — never ask how
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
COMMIT AUTHORIZED → SPLIT INTO LOGICAL CHUNKS BY DEFAULT.
|
|
55
|
+
NEVER ASK "ONE COMMIT OR MULTIPLE?", "HOW SHOULD I SPLIT?",
|
|
56
|
+
"WHICH CHUNK FIRST?". THE AGENT PICKS THE SPLIT.
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
One chunk per concern (scope / refactor / rules / config / cleanup), foundation-first. Generated files ride with their source chunk. State the split inline, execute. Full mechanics + carve-outs: [`commit-mechanics § Always split into logical chunks`](../contexts/authority/commit-mechanics.md).
|
|
60
|
+
|
|
51
61
|
## NEVER write commit steps into roadmaps unsolicited
|
|
52
62
|
|
|
53
63
|
When **creating** a roadmap (`/roadmap-create`, `/feature-roadmap`, any roadmap-producing flow) — do **not** include commit steps unless the user explicitly requested them. Commits are a delivery decision; roadmaps plan **work**.
|
|
@@ -11,10 +11,10 @@ triggers:
|
|
|
11
11
|
- keyword: "mobile track"
|
|
12
12
|
- keyword: "ml track"
|
|
13
13
|
- keyword: "blockchain track"
|
|
14
|
-
- path_prefix: ".agent-src.
|
|
14
|
+
- path_prefix: ".agent-src.uncondensed/skills/"
|
|
15
15
|
validator_ignore:
|
|
16
16
|
- type: "substring"
|
|
17
|
-
pattern: ".agent-src.
|
|
17
|
+
pattern: ".agent-src.uncondensed/"
|
|
18
18
|
reason: "Rule names the authoring tree as the gated-entry location for new domain plates."
|
|
19
19
|
workspaces:
|
|
20
20
|
- agent-config-maintainer
|
|
@@ -51,7 +51,7 @@ ALL THREE PASS, OR THE ROADMAP MARKS THE DOMAIN GATED.
|
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
The three gates fire before any skill, guideline, command, or rule from the
|
|
54
|
-
domain enters `.agent-src.
|
|
54
|
+
domain enters `.agent-src.uncondensed/`. A council session may inform the
|
|
55
55
|
decision but cannot replace the gate evidence.
|
|
56
56
|
|
|
57
57
|
## Gate 1 — Demand signal
|
|
@@ -11,8 +11,8 @@ triggers:
|
|
|
11
11
|
- intent: "low-impact council dispatch"
|
|
12
12
|
validator_ignore:
|
|
13
13
|
- type: "substring"
|
|
14
|
-
pattern: ".agent-src.
|
|
15
|
-
reason: "
|
|
14
|
+
pattern: ".agent-src.uncondensed/"
|
|
15
|
+
reason: "Condenseor injects a back-pointer to the uncondensed source for full failure-modes detail."
|
|
16
16
|
workspaces:
|
|
17
17
|
- agent-config-maintainer
|
|
18
18
|
packs:
|
|
@@ -43,7 +43,7 @@ Markers (from `scripts/ai_council/low_impact.py`):
|
|
|
43
43
|
- **Split** — `> Low-impact council split — escalating to user (<m1>: X / <m2>: Y):`
|
|
44
44
|
- **Aborted** — `> Low-impact council aborted (token cap) — escalating to user:`
|
|
45
45
|
|
|
46
|
-
Verbatim = first non-whitespace line, English (no translation), no emoji prefix, no merged numbered-options. Marker is the only audit signal that distinguishes fast-path from local deliberation. See `.agent-src.
|
|
46
|
+
Verbatim = first non-whitespace line, English (no translation), no emoji prefix, no merged numbered-options. Marker is the only audit signal that distinguishes fast-path from local deliberation. See `.agent-src.uncondensed/rules/fast-path-marker-visibility.md` for full failure modes.
|
|
47
47
|
|
|
48
48
|
## Failure modes
|
|
49
49
|
|
|
@@ -79,7 +79,7 @@ Each finance deliverable surfaces, in this order:
|
|
|
79
79
|
1. **Assumptions block** — every input value the model uses, sourced or marked `assumption`.
|
|
80
80
|
2. **Sensitivity** — at least one variable swept (±20% or ±1 σ); single-point estimates without sensitivity are forbidden for valuation and runway.
|
|
81
81
|
3. **Confidence band** — `high` / `medium` / `low` per the surrounding council / skill conventions, with the reason for the band (data quality, model fit, time horizon).
|
|
82
|
-
4. **Counter-case** — one sentence on what would invalidate the conclusion ("if growth halves, runway
|
|
82
|
+
4. **Counter-case** — one sentence on what would invalidate the conclusion ("if growth halves, runway condenses to 7 months").
|
|
83
83
|
|
|
84
84
|
## Human review escalation
|
|
85
85
|
|
|
@@ -4,9 +4,9 @@ tier: "2a"
|
|
|
4
4
|
description: "Editing a generic skill/rule/command — block single-stack mandates; use language-agnostic procedures with carve-out pointers"
|
|
5
5
|
source: package
|
|
6
6
|
triggers:
|
|
7
|
-
- path_prefix: ".agent-src.
|
|
8
|
-
- path_prefix: ".agent-src.
|
|
9
|
-
- path_prefix: ".agent-src.
|
|
7
|
+
- path_prefix: ".agent-src.uncondensed/skills/"
|
|
8
|
+
- path_prefix: ".agent-src.uncondensed/rules/"
|
|
9
|
+
- path_prefix: ".agent-src.uncondensed/commands/"
|
|
10
10
|
- keyword: "FormRequest"
|
|
11
11
|
- keyword: "PHPStan"
|
|
12
12
|
- keyword: "php artisan"
|
|
@@ -24,8 +24,8 @@ applies_to_user_types:
|
|
|
24
24
|
- "maintainer"
|
|
25
25
|
validator_ignore:
|
|
26
26
|
- type: "substring"
|
|
27
|
-
pattern: ".agent-src.
|
|
28
|
-
reason: "Rule's subject is generic artifacts under .agent-src.
|
|
27
|
+
pattern: ".agent-src.uncondensed/"
|
|
28
|
+
reason: "Rule's subject is generic artifacts under .agent-src.uncondensed/; every body link points there by design."
|
|
29
29
|
- type: "substring"
|
|
30
30
|
pattern: "scripts/lint_framework_leakage"
|
|
31
31
|
reason: "Rule cites the enforcing linter script by name in body and enforcement section."
|
|
@@ -62,9 +62,9 @@ into surfaces the agent must trigger on regardless of project stack.
|
|
|
62
62
|
|
|
63
63
|
This rule fires on edits under:
|
|
64
64
|
|
|
65
|
-
- `.agent-src.
|
|
66
|
-
- `.agent-src.
|
|
67
|
-
- `.agent-src.
|
|
65
|
+
- `.agent-src.uncondensed/skills/`
|
|
66
|
+
- `.agent-src.uncondensed/rules/`
|
|
67
|
+
- `.agent-src.uncondensed/commands/`
|
|
68
68
|
|
|
69
69
|
**Exempt** (file or directory name matches — these are correctly
|
|
70
70
|
framework-specific): `laravel*`, `symfony*`, `nextjs*`, `react-*`,
|
|
@@ -91,7 +91,7 @@ If either stop fires and resolution is not immediate → tag the state (`git tag
|
|
|
91
91
|
|
|
92
92
|
## Why this rule exists
|
|
93
93
|
|
|
94
|
-
Interactive rebase + fixup loops generate disproportionate token cost on every iteration: re-running CI per replayed commit, resolving the same content conflict in three derived files (`.
|
|
94
|
+
Interactive rebase + fixup loops generate disproportionate token cost on every iteration: re-running CI per replayed commit, resolving the same content conflict in three derived files (`.condensation-hashes.json`, `dist/router.json`, `.windsurfrules`), losing the working tree to a stash that silently re-introduces older state. A single conflict can burn the budget of an entire feature.
|
|
95
95
|
|
|
96
96
|
A previous session squashed a pushed branch, the push hook failed at the token boundary, the session ended — and the next session saw local and origin pointing at different SHAs for the same logical work. A blind `git pull --rebase` cascaded into conflicts across every derived file. Recovery required forensic SHA-archaeology. The pre/post-rewrite stops make that sequence structurally impossible.
|
|
97
97
|
|
|
@@ -11,7 +11,7 @@ triggers:
|
|
|
11
11
|
- keyword: "refactor"
|
|
12
12
|
validator_ignore:
|
|
13
13
|
- type: "substring"
|
|
14
|
-
pattern: ".agent-src.
|
|
14
|
+
pattern: ".agent-src.uncondensed/"
|
|
15
15
|
reason: "Rule cites the authoring tree when describing where examples live."
|
|
16
16
|
workspaces:
|
|
17
17
|
- engineering
|
|
@@ -117,5 +117,5 @@ When the request is to create or significantly rewrite a skill, rule, command,
|
|
|
117
117
|
or guideline, the "fit the existing architecture" check above is handled by
|
|
118
118
|
[`artifact-drafting-protocol`](artifact-drafting-protocol.md)'s Phase B
|
|
119
119
|
(Research). Follow that protocol instead of improvising a one-shot check — it
|
|
120
|
-
scans `.agent-src.
|
|
120
|
+
scans `.agent-src.uncondensed/` for overlap and reports candidates to extend
|
|
121
121
|
before creating a new file.
|
|
@@ -6,7 +6,7 @@ alwaysApply: true
|
|
|
6
6
|
source: package
|
|
7
7
|
validator_ignore:
|
|
8
8
|
- type: "substring"
|
|
9
|
-
pattern: ".agent-src.
|
|
9
|
+
pattern: ".agent-src.uncondensed/"
|
|
10
10
|
reason: "Rule scopes the .md-English mandate to the authoring tree."
|
|
11
11
|
workspaces:
|
|
12
12
|
- agent-config-maintainer
|
|
@@ -72,7 +72,7 @@ Examples + wrong-vs-correct: [`language-and-tone-examples`](../docs/guidelines/a
|
|
|
72
72
|
|
|
73
73
|
## `.md` files — ALWAYS English
|
|
74
74
|
|
|
75
|
-
Every text inside `.md` under `.augment/`, `.agent-src/`, `.agent-src.
|
|
75
|
+
Every text inside `.md` under `.augment/`, `.agent-src/`, `.agent-src.uncondensed/`, `agents/`: headings, paragraphs, bullets, option labels, prompts, placeholders, ASCII labels, table headers / content. Agent translates at runtime.
|
|
76
76
|
|
|
77
77
|
**Labeled-anchor exception** — quoting German inside English prose is forbidden. Either translate, OR use a labeled `DE: … · EN: …` anchor block (only allowed location for German prose).
|
|
78
78
|
|
|
@@ -25,8 +25,8 @@ validator_ignore:
|
|
|
25
25
|
pattern: "../../agents/"
|
|
26
26
|
reason: "Routing rule whose subject matter is the project-local agents/settings/policies/media/ tree; every body link points there by design."
|
|
27
27
|
- type: "substring"
|
|
28
|
-
pattern: ".agent-src.
|
|
29
|
-
reason: "Rule contrasts project-local placement with the .agent-src.
|
|
28
|
+
pattern: ".agent-src.uncondensed/"
|
|
29
|
+
reason: "Rule contrasts project-local placement with the .agent-src.uncondensed/rules/ alternative — mentioning the path is the argument."
|
|
30
30
|
workspaces:
|
|
31
31
|
- agent-config-maintainer
|
|
32
32
|
packs:
|
|
@@ -67,12 +67,12 @@ Any trigger match → agent loads into context:
|
|
|
67
67
|
|
|
68
68
|
Each policy carries own trigger block → within active context agent narrows from superset to policies whose specific patterns actually fired (e.g. prompt naming public figure → `public-figures.md` + `disclosure.md`; `--no-disclosure` → `disclosure.md` standalone).
|
|
69
69
|
|
|
70
|
-
## Why project-local, not `.agent-src.
|
|
70
|
+
## Why project-local, not `.agent-src.uncondensed/rules/`
|
|
71
71
|
|
|
72
|
-
Seven media policies live under [`agents/settings/policies/media/`](../../agents/settings/policies/media/), not as `.agent-src.
|
|
72
|
+
Seven media policies live under [`agents/settings/policies/media/`](../../agents/settings/policies/media/), not as `.agent-src.uncondensed/rules/domain-safety-media-*.md`, for three reasons:
|
|
73
73
|
|
|
74
74
|
1. **Consumed by skills + adapters**, not surfaced as standalone always-loaded prose. Cost non-trivial (7 × ~80 lines = ~560 lines always-context if hoisted to rules), and most sessions never touch video / image / voice surface.
|
|
75
|
-
2. **Enforcement model project-local** — working precedent (`/ghostwriter:*` mandatory footer in `write-engine.md`) + audit log (session transcripts) are project artifacts. Rules under `.agent-src.
|
|
75
|
+
2. **Enforcement model project-local** — working precedent (`/ghostwriter:*` mandatory footer in `write-engine.md`) + audit log (session transcripts) are project artifacts. Rules under `.agent-src.uncondensed/` are tool-portable governance; these policies are domain-specific bindings.
|
|
76
76
|
3. **Extraction to reusable domain pack explicitly deferred** until second non-video domain (audio, image, docs, exports) lands with overlapping execution surfaces. Until then, one-domain abstraction structurally premature — policies stay project-local, routing rule on-demand bridge.
|
|
77
77
|
|
|
78
78
|
This routing rule is the bridge: sits in always-loaded rule set so trigger keywords surface project-local policies into context on demand, without paying full always-loaded cost.
|
|
@@ -62,4 +62,5 @@ re-fetch to verify. Other writing commands SHOULD adopt the same pass.
|
|
|
62
62
|
|
|
63
63
|
[`/create-pr`](../commands/create-pr.md) ·
|
|
64
64
|
[`commit-conventions`](commit-conventions.md) ·
|
|
65
|
+
[`no-decorative-emojis-in-git-surfaces`](no-decorative-emojis-in-git-surfaces.md) — sibling rule covering decorative emojis in the same surfaces ·
|
|
65
66
|
[`scope-control`](scope-control.md).
|
|
@@ -75,6 +75,9 @@ Silent, before any numbered-options block. Any "yes" → don't ask:
|
|
|
75
75
|
8. Mandate active + "weiter? / continue?" — IL 4, pick next item.
|
|
76
76
|
9. Prereq for user-authorized action? IL 5, execute silently.
|
|
77
77
|
10. Destination (branch / PR) already named? IL 6, never re-ask.
|
|
78
|
+
11. Cleanup of gitignored / auto-pruned / TTL-managed artefact? Self-managing — state inline, never offer.
|
|
79
|
+
12. Numbered option contains a commit-message body, "message preview", or "Vorschlag falls Du committen willst"? Disguised commit ask — `commit-policy` violation, drop it.
|
|
80
|
+
13. Commit authorized + asking "one commit or multiple?", "how should I split?", "which chunk first?"? Forbidden — `commit-policy § Always split into logical chunks`. Pick the split, state inline, execute.
|
|
78
81
|
|
|
79
82
|
Pick dominant path, state inline assumption, hand back. Genuine ambiguity → [`ask-when-uncertain`](ask-when-uncertain.md).
|
|
80
83
|
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: "auto"
|
|
3
|
+
tier: "3"
|
|
4
|
+
alwaysApply: false
|
|
5
|
+
description: "Generating PR/issue/commit titles or PR/issue comments — forbids decorative emojis; allowed in PR/issue descriptions + commit bodies only when matched by an in-artifact legend"
|
|
6
|
+
source: package
|
|
7
|
+
triggers:
|
|
8
|
+
- intent: "PR title"
|
|
9
|
+
- intent: "PR body"
|
|
10
|
+
- intent: "commit message"
|
|
11
|
+
- intent: "issue title"
|
|
12
|
+
- intent: "post PR comment"
|
|
13
|
+
- keyword: "gh pr create"
|
|
14
|
+
- keyword: "git commit"
|
|
15
|
+
workspaces:
|
|
16
|
+
- agent-config-maintainer
|
|
17
|
+
- engineering
|
|
18
|
+
packs:
|
|
19
|
+
- meta
|
|
20
|
+
lifecycle: active
|
|
21
|
+
trust:
|
|
22
|
+
level: core
|
|
23
|
+
confidence: high
|
|
24
|
+
human_review_required: false
|
|
25
|
+
install:
|
|
26
|
+
default: true
|
|
27
|
+
removable: false
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
# No Decorative Emojis in Git Surfaces
|
|
31
|
+
|
|
32
|
+
## Iron Law
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
NEVER ADD DECORATIVE EMOJIS TO PR / ISSUE / COMMIT TITLES OR
|
|
36
|
+
TO PR / ISSUE COMMENTS. NEVER ADD UNIVERSAL-BLACKLIST EMOJIS
|
|
37
|
+
(🤖 🚀 🎉 ✨ 🔥 💡 👍 ❤️) ANYWHERE — TITLE OR BODY.
|
|
38
|
+
DECORATIVE EMOJIS IN PR / ISSUE DESCRIPTIONS OR COMMIT BODIES
|
|
39
|
+
ARE ALLOWED ONLY WHEN A LEGEND IN THE SAME ARTIFACT DEFINES
|
|
40
|
+
EVERY EMOJI USED. NO LEGEND → NO EMOJI.
|
|
41
|
+
EXCEPTION: USER EXPLICITLY ASKED FOR IT THIS TURN.
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Decorative = visual flair, ranking, mood, "look how fancy". Functional emojis below stay allowed.
|
|
45
|
+
|
|
46
|
+
## Surfaces — what this gates
|
|
47
|
+
|
|
48
|
+
Always blocked (titles + free-standing comments):
|
|
49
|
+
|
|
50
|
+
- PR titles (`gh pr create --title`, `octokit.pulls.create`, PATCH).
|
|
51
|
+
- Issue titles (`gh issue create`, `octokit.issues.create`, PATCH).
|
|
52
|
+
- Commit subject (first line of `git commit -m` / message file).
|
|
53
|
+
- Branch names.
|
|
54
|
+
- Standalone PR / issue comments (`gh pr comment`, `gh issue comment`,
|
|
55
|
+
`octokit.issues.createComment`) — covers everything `no-pr-progress-comments`
|
|
56
|
+
lets through (review-replies, user-invoked comment flows).
|
|
57
|
+
|
|
58
|
+
Body-only, legend-gated:
|
|
59
|
+
|
|
60
|
+
- PR / issue descriptions (body of create / PATCH payload).
|
|
61
|
+
- Commit body (lines below the blank-line subject separator).
|
|
62
|
+
|
|
63
|
+
## Universal blacklist — forbidden even with a legend
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
🤖 🚀 🎉 ✨ 🔥 💡 👍 ❤️ 🤗 😊 (and skin-tone / variant forms)
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
"Look how fancy" / empathy classes from `direct-answers`. Self-attribution (🤖) is the punkpeye PR (#6865 title-emoji spam) pattern. No legend rescues them.
|
|
70
|
+
|
|
71
|
+
## Legend carve-out — when body emojis ARE allowed
|
|
72
|
+
|
|
73
|
+
All three must hold for the same artifact:
|
|
74
|
+
|
|
75
|
+
1. Body contains a `Legend:` (or `Legende:`) block on its own line defining every decorative emoji used elsewhere in the body.
|
|
76
|
+
2. Emojis carry **information** (language tag, OS marker, hosting class) — not pure decoration. Example punkpeye-#6865 body:
|
|
77
|
+
`📇 TypeScript · ☁️ Cloud · 🏠 Local · 🍎 macOS · 🪟 Windows · 🐧 Linux`.
|
|
78
|
+
3. No universal-blacklist emoji appears (above list always wins).
|
|
79
|
+
|
|
80
|
+
Body emojis without a legend → strip before posting / committing.
|
|
81
|
+
|
|
82
|
+
## Whitelist — always allowed, no legend
|
|
83
|
+
|
|
84
|
+
- CLI / agent-status markers: `❌` `✅` `⚠️` (literal status).
|
|
85
|
+
- Mode markers from `role-mode-adherence`.
|
|
86
|
+
- Roadmap checkbox glyphs (`[x]` `[~]` `[-]`) in fenced code or quoted roadmap excerpts — not emojis, no carve-out needed.
|
|
87
|
+
|
|
88
|
+
## Server-side re-injection
|
|
89
|
+
|
|
90
|
+
Host AI client or tool wrapper re-injects 🤖 / 🎉 into a title or comment after creation (analog to the `Pull Request opened by …` injection in `no-attribution-footers`) → same mitigation: re-fetch after create, regex-strip, PATCH if changed, re-fetch to verify.
|
|
91
|
+
|
|
92
|
+
## Failure modes — what counts as a violation
|
|
93
|
+
|
|
94
|
+
- `feat: 🚀 ship the unified setup wizard` — emoji in commit subject.
|
|
95
|
+
- PR title `🤖 Update dependencies` — title-emoji spam (punkpeye #6865).
|
|
96
|
+
- Comment body `🎉 All checks green now!` — decorative comment.
|
|
97
|
+
- PR body with `Status: 🟢 Ready` — no legend, no carve-out.
|
|
98
|
+
- Branch `feat/🔥-new-thing` — emoji in ref name.
|
|
99
|
+
- Body legend present but body also uses 🤖 — universal blacklist wins.
|
|
100
|
+
|
|
101
|
+
## See also
|
|
102
|
+
|
|
103
|
+
- [`no-attribution-footers`](no-attribution-footers.md) — sibling rule on
|
|
104
|
+
the same surfaces; covers the `🤖 Generated with …` footer class.
|
|
105
|
+
- [`no-pr-progress-comments`](no-pr-progress-comments.md) — gates *whether*
|
|
106
|
+
to post a comment at all; this rule gates the *form* of any comment
|
|
107
|
+
that does get posted.
|
|
108
|
+
- [`commit-conventions`](commit-conventions.md) — Conventional Commits
|
|
109
|
+
format; this rule narrows the allowed character set in the subject.
|
|
110
|
+
- [`direct-answers`](direct-answers.md) § Emoji Scope — chat-reply analog;
|
|
111
|
+
same emoji classes, different surface.
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: "auto"
|
|
3
|
+
tier: "2a"
|
|
4
|
+
alwaysApply: false
|
|
5
|
+
description: "Posting comments on an open PR — refuses unsolicited progress / status / CI-fix narration unless personal.pr_progress_comments is true"
|
|
6
|
+
source: package
|
|
7
|
+
triggers:
|
|
8
|
+
- intent: "post PR comment"
|
|
9
|
+
- intent: "PR status update"
|
|
10
|
+
- intent: "CI fix progress"
|
|
11
|
+
- keyword: "gh pr comment"
|
|
12
|
+
- keyword: "PullRequestComment"
|
|
13
|
+
workspaces:
|
|
14
|
+
- agent-config-maintainer
|
|
15
|
+
- engineering
|
|
16
|
+
packs:
|
|
17
|
+
- meta
|
|
18
|
+
lifecycle: active
|
|
19
|
+
trust:
|
|
20
|
+
level: core
|
|
21
|
+
confidence: high
|
|
22
|
+
human_review_required: false
|
|
23
|
+
install:
|
|
24
|
+
default: true
|
|
25
|
+
removable: false
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
# No Unsolicited PR Progress Comments
|
|
29
|
+
|
|
30
|
+
## Iron Law
|
|
31
|
+
|
|
32
|
+
```
|
|
33
|
+
NEVER POST UNSOLICITED PROGRESS / STATUS / CI-FIX COMMENTS ON A PR
|
|
34
|
+
WHEN `personal.pr_progress_comments` IS FALSE (DEFAULT).
|
|
35
|
+
EXCEPTION: USER-INVOKED FLOWS ALWAYS RUN.
|
|
36
|
+
EXCEPTION: USER EXPLICITLY ASKED FOR IT THIS TURN.
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Reading `.agent-settings.yml`:
|
|
40
|
+
|
|
41
|
+
- Missing key / not set → treat as `false`.
|
|
42
|
+
- `personal.pr_progress_comments: false` (default) → gate fires.
|
|
43
|
+
- `personal.pr_progress_comments: true` → gate inert, agent may comment.
|
|
44
|
+
|
|
45
|
+
## What this gates — and what it does NOT
|
|
46
|
+
|
|
47
|
+
**Gated** (do not post when the setting is `false`):
|
|
48
|
+
|
|
49
|
+
- "CI fix iteration #N" status comments narrating what the agent did.
|
|
50
|
+
- "Blocked on X" status notices the agent posts unprompted.
|
|
51
|
+
- "All checks green now" celebration comments.
|
|
52
|
+
- Any `gh pr comment` / `octokit.pulls.createReview` / equivalent the
|
|
53
|
+
agent decides to fire mid-loop without an explicit ask.
|
|
54
|
+
|
|
55
|
+
**Not gated** (always allowed regardless of the setting):
|
|
56
|
+
|
|
57
|
+
- The PR body / description in [`/create-pr`](../commands/create-pr.md) and
|
|
58
|
+
in PATCH-after-create strip passes — that text *is* the PR.
|
|
59
|
+
- Replies to individual review comments via
|
|
60
|
+
[`/fix:pr-comments`](../commands/fix/pr-comments.md),
|
|
61
|
+
[`/fix:pr-developer-comments`](../commands/fix/pr-developer-comments.md),
|
|
62
|
+
and [`/fix:pr-bot-comments`](../commands/fix/pr-bot-comments.md) —
|
|
63
|
+
the user invoked the command, that is the explicit ask.
|
|
64
|
+
- Comments the user explicitly requested this turn ("post a comment
|
|
65
|
+
on PR #244 explaining the workflow-scope block").
|
|
66
|
+
- Comments from a slash-command flow the user invoked
|
|
67
|
+
(`/council:pr`, `/code-review --comment`, etc.).
|
|
68
|
+
|
|
69
|
+
If unsure whether the planned comment qualifies as gated:
|
|
70
|
+
**treat it as gated**. The user can flip the setting once if they
|
|
71
|
+
want progress narration; a missed unsolicited comment is recoverable,
|
|
72
|
+
a noisy PR thread is not.
|
|
73
|
+
|
|
74
|
+
## What to do instead when the gate fires
|
|
75
|
+
|
|
76
|
+
State the progress in the **chat reply**, not on the PR. Examples:
|
|
77
|
+
|
|
78
|
+
- "Fixed the schema lint; force-pushed `b17c4ef8`. Node Tests still
|
|
79
|
+
blocked on the workflow-scope edit (diff in working tree, needs
|
|
80
|
+
maintainer push)."
|
|
81
|
+
- "CI cycle 3/3 green except for Node Tests; same blocker as before."
|
|
82
|
+
|
|
83
|
+
The chat reply reaches the user with the same information. The PR
|
|
84
|
+
stays clean for reviewers.
|
|
85
|
+
|
|
86
|
+
## Failure modes — what counts as a violation
|
|
87
|
+
|
|
88
|
+
- Posting "CI status update" comments during an autonomous CI-fix loop.
|
|
89
|
+
- Re-running `gh pr comment` after a previous unsolicited comment was
|
|
90
|
+
posted (compounding the noise).
|
|
91
|
+
- Narrating the diff of the next push in a PR comment — diffs belong
|
|
92
|
+
in commit messages.
|
|
93
|
+
- Posting "I noticed you opened this PR — here's my analysis" without
|
|
94
|
+
a `/code-review` invocation.
|
|
95
|
+
|
|
96
|
+
## Carve-out: surfacing safety-critical info
|
|
97
|
+
|
|
98
|
+
If the agent uncovers a security / data-loss / production-impact
|
|
99
|
+
issue that the reviewer needs to see **before** they read the diff
|
|
100
|
+
and posting a chat reply alone risks the message being missed, treat
|
|
101
|
+
this as an explicit safety surface and:
|
|
102
|
+
|
|
103
|
+
1. Post the comment **and** state in the chat reply that the gate was
|
|
104
|
+
bypassed for safety.
|
|
105
|
+
2. Cite the rule + the carve-out in the comment body so the reviewer
|
|
106
|
+
knows why the agent broke the default silence.
|
|
107
|
+
|
|
108
|
+
Routine CI status, refactor progress, and "this might interest you"
|
|
109
|
+
notes do **not** clear this carve-out.
|
|
110
|
+
|
|
111
|
+
## See also
|
|
112
|
+
|
|
113
|
+
- [`/create-pr`](../commands/create-pr.md) — PR body / description path (not gated).
|
|
114
|
+
- [`/fix:pr-comments`](../commands/fix/pr-comments.md) — review-reply path (not gated).
|
|
115
|
+
- [`no-attribution-footers`](no-attribution-footers.md) — sibling rule on PR-comment hygiene.
|
|
116
|
+
- [`no-decorative-emojis-in-git-surfaces`](no-decorative-emojis-in-git-surfaces.md) — sibling rule gating decorative emojis in any comment that does get posted.
|
|
117
|
+
- [`scope-control`](scope-control.md) — git-ops permission gate (PR creation).
|
|
118
|
+
- `personal.pr_progress_comments` in `config/agent-settings.template.yml`.
|
|
@@ -15,7 +15,7 @@ routes_to:
|
|
|
15
15
|
- "skill:ai-council"
|
|
16
16
|
validator_ignore:
|
|
17
17
|
- type: "substring"
|
|
18
|
-
pattern: ".agent-src.
|
|
18
|
+
pattern: ".agent-src.uncondensed/"
|
|
19
19
|
reason: "Rule contrasts the authoring tree with transient layers."
|
|
20
20
|
workspaces:
|
|
21
21
|
- agent-config-maintainer
|
|
@@ -71,7 +71,7 @@ These paths must not appear inside a stable artifact:
|
|
|
71
71
|
`agents/runtime/council/responses/<file>.json`,
|
|
72
72
|
`agents/runtime/council/sessions/<file>.json` or `<timestamp>/...`
|
|
73
73
|
|
|
74
|
-
Stable artifact = any file under `.agent-src.
|
|
74
|
+
Stable artifact = any file under `.agent-src.uncondensed/{rules,
|
|
75
75
|
skills,commands,contexts,templates,personas}/`, `agents/settings/contexts/`,
|
|
76
76
|
`docs/guidelines/`, `docs/contracts/`, `docs/architecture.md`,
|
|
77
77
|
`docs/customization.md`, `docs/getting-started.md`, `docs/catalog.md`,
|
|
@@ -145,6 +145,6 @@ Failure modes:
|
|
|
145
145
|
- [`roadmap-progress-sync`](roadmap-progress-sync.md) — sync dashboard
|
|
146
146
|
on roadmap touch
|
|
147
147
|
- [`augment-source-of-truth`](augment-source-of-truth.md) — edit
|
|
148
|
-
`.agent-src.
|
|
148
|
+
`.agent-src.uncondensed/`
|
|
149
149
|
- [`ai-council`](../skills/ai-council/SKILL.md) — output path
|
|
150
150
|
convention and convergence-summary format
|
|
@@ -47,7 +47,7 @@ Standing "just keep going" + next step crosses the floor → STOP, surface what'
|
|
|
47
47
|
|
|
48
48
|
## Not in scope — deterministic regeneration
|
|
49
49
|
|
|
50
|
-
Output regenerated from a tracked source (
|
|
50
|
+
Output regenerated from a tracked source (condensation, code-gen, formatter passes, lock-file rebuilds) is reversible from source — **not destructive**. Lives in [`autonomous-execution § Trivial`](autonomous-execution.md#trivial--just-act-do-not-ask). Per-file diff approval is theater.
|
|
51
51
|
|
|
52
52
|
## Bulk deletions during WIP — allowed if task-connected
|
|
53
53
|
|
|
@@ -4,7 +4,7 @@ tier: "2a"
|
|
|
4
4
|
description: "Creating/editing/proposing personas — enforce per-domain cap (≤ 2 specialists), ≥ 1 skill citation, deprecation path"
|
|
5
5
|
source: package
|
|
6
6
|
triggers:
|
|
7
|
-
- path_prefix: ".agent-src.
|
|
7
|
+
- path_prefix: ".agent-src.uncondensed/personas/"
|
|
8
8
|
- path_prefix: ".agent-src/personas/"
|
|
9
9
|
- keyword: "persona"
|
|
10
10
|
- keyword: "personas"
|
|
@@ -22,8 +22,8 @@ validator_ignore:
|
|
|
22
22
|
pattern: "../../docs/"
|
|
23
23
|
reason: "Rule routes to docs/contracts/persona-schema.md and docs/personas.md — the canonical persona catalog and schema live there by design."
|
|
24
24
|
- type: "substring"
|
|
25
|
-
pattern: ".agent-src.
|
|
26
|
-
reason: "Rule documents the persona authoring tree (.agent-src.
|
|
25
|
+
pattern: ".agent-src.uncondensed/"
|
|
26
|
+
reason: "Rule documents the persona authoring tree (.agent-src.uncondensed/personas/) as the deprecation-path operand."
|
|
27
27
|
workspaces:
|
|
28
28
|
- agent-config-maintainer
|
|
29
29
|
packs:
|