@event4u/agent-config 9.13.0 → 9.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +113 -67
- package/README.md +9 -1
- package/dist/agent-src/commands/agents/audit.md +7 -7
- package/dist/agent-src/commands/agents/optimize.md +1 -1
- package/dist/agent-src/commands/analyze/reference-repo.md +1 -1
- package/dist/agent-src/commands/chat-history.md +1 -0
- package/dist/agent-src/commands/context.md +1 -0
- package/dist/agent-src/commands/council.md +1 -1
- package/dist/agent-src/commands/ghostwriter.md +1 -1
- package/dist/agent-src/commands/memory.md +2 -1
- package/dist/agent-src/commands/module.md +1 -0
- package/dist/agent-src/commands/optimize/agents-dir.md +1 -1
- package/dist/agent-src/commands/optimize/deep.md +150 -0
- package/dist/agent-src/commands/optimize/skills.md +5 -5
- package/dist/agent-src/commands/optimize.md +12 -6
- package/dist/agent-src/commands/override.md +1 -0
- package/dist/agent-src/commands/prediction-pool.md +4 -4
- package/dist/agent-src/commands/research/deep.md +1 -1
- package/dist/agent-src/commands/roadmap.md +2 -1
- package/dist/agent-src/commands/rule-compliance-audit.md +1 -1
- package/dist/agent-src/commands/tdd.md +1 -0
- package/dist/agent-src/commands/tests.md +1 -0
- package/dist/agent-src/commands/upstream-contribute.md +5 -5
- package/dist/agent-src/commands/video/from-script.md +1 -1
- package/dist/agent-src/commands/video/from-song.md +1 -1
- package/dist/agent-src/commands/video/scene.md +1 -1
- package/dist/agent-src/commands/video/stitch.md +1 -1
- package/dist/agent-src/commands/video/storyboard.md +1 -1
- package/dist/agent-src/commands/worktree/create.md +2 -1
- package/dist/agent-src/contexts/augment-infrastructure.md +1 -1
- package/dist/agent-src/contexts/contracts/artifact-engagement-flow.md +5 -5
- package/dist/agent-src/contexts/contracts/command-suggestion-flow.md +3 -3
- package/dist/agent-src/contexts/contracts/emergency-triage-block.md +2 -2
- package/dist/agent-src/contexts/execution/roadmap-process-loop.md +4 -3
- package/dist/agent-src/contexts/execution/subagent-routing.md +19 -0
- package/dist/agent-src/contexts/override-system.md +1 -1
- package/dist/agent-src/ghostwriter/fictional-fixture-v1.md +1 -1
- package/dist/agent-src/rules/augment-edit-discipline.md +1 -1
- package/dist/agent-src/rules/autonomous-execution.md +2 -1
- package/dist/agent-src/rules/brand-consistency.md +1 -0
- package/dist/agent-src/rules/brand-source-of-truth.md +1 -0
- package/dist/agent-src/rules/code-comment-discipline.md +2 -0
- package/dist/agent-src/rules/communication-through-line.md +1 -0
- package/dist/agent-src/rules/content-quoting-floor.md +1 -0
- package/dist/agent-src/rules/cross-source-consistency.md +0 -1
- package/dist/agent-src/rules/downstream-changes.md +1 -0
- package/dist/agent-src/rules/external-code-graph-interop.md +1 -0
- package/dist/agent-src/rules/external-reference-deep-dive.md +1 -0
- package/dist/agent-src/rules/fast-path-marker-visibility.md +1 -0
- package/dist/agent-src/rules/finance-safety-floor.md +0 -1
- package/dist/agent-src/rules/icon-consistency.md +1 -0
- package/dist/agent-src/rules/image-likeness-and-rights.md +1 -0
- package/dist/agent-src/rules/improve-before-implement.md +1 -1
- package/dist/agent-src/rules/invite-challenge.md +1 -0
- package/dist/agent-src/rules/lethal-trifecta-guard.md +1 -0
- package/dist/agent-src/rules/low-impact-corpus-privacy-floor.md +1 -0
- package/dist/agent-src/rules/markdown-safe-codeblocks.md +1 -0
- package/dist/agent-src/rules/media-governance-routing.md +4 -3
- package/dist/agent-src/rules/media-sync-ground-truth.md +1 -0
- package/dist/agent-src/rules/no-attribution-footers.md +1 -0
- package/dist/agent-src/rules/no-decorative-emojis-in-git-surfaces.md +1 -0
- package/dist/agent-src/rules/no-pr-progress-comments.md +1 -0
- package/dist/agent-src/rules/onboarding-gate.md +1 -0
- package/dist/agent-src/rules/output-discipline.md +1 -0
- package/dist/agent-src/rules/prefer-enums-over-literals.md +1 -0
- package/dist/agent-src/rules/preservation-guard.md +1 -0
- package/dist/agent-src/rules/question-not-instruction.md +1 -0
- package/dist/agent-src/rules/roadmap-ci-steps-policy.md +1 -0
- package/dist/agent-src/rules/role-mode-adherence.md +1 -0
- package/dist/agent-src/rules/runtime-safety.md +1 -0
- package/dist/agent-src/rules/security-sensitive-stop.md +1 -0
- package/dist/agent-src/rules/session-canary.md +9 -2
- package/dist/agent-src/rules/source-confidentiality.md +1 -0
- package/dist/agent-src/rules/source-of-truth.md +1 -0
- package/dist/agent-src/rules/spreadsheet-source-quality.md +1 -0
- package/dist/agent-src/rules/think-before-action.md +1 -0
- package/dist/agent-src/rules/token-budget-discipline.md +1 -0
- package/dist/agent-src/rules/token-efficiency.md +1 -0
- package/dist/agent-src/rules/token-optimizer-maintenance.md +5 -5
- package/dist/agent-src/rules/tool-safety.md +1 -0
- package/dist/agent-src/rules/untrusted-input-defense.md +2 -0
- package/dist/agent-src/rules/user-interaction.md +1 -0
- package/dist/agent-src/rules/user-interrupt-priority.md +1 -0
- package/dist/agent-src/skills/adr-create/SKILL.md +1 -1
- package/dist/agent-src/skills/check-refs/SKILL.md +1 -1
- package/dist/agent-src/skills/competitive-positioning/SKILL.md +1 -1
- package/dist/agent-src/skills/condense-memory/SKILL.md +1 -1
- package/dist/agent-src/skills/context-authoring/SKILL.md +1 -1
- package/dist/agent-src/skills/copilot-agents-optimization/SKILL.md +1 -1
- package/dist/agent-src/skills/description-assist/SKILL.md +1 -1
- package/dist/agent-src/skills/github-ci/SKILL.md +1 -0
- package/dist/agent-src/skills/guideline-writing/SKILL.md +1 -1
- package/dist/agent-src/skills/lint-skills/SKILL.md +1 -1
- package/dist/agent-src/skills/readme-reviewer/SKILL.md +1 -1
- package/dist/agent-src/skills/roadmap-management/SKILL.md +8 -1
- package/dist/agent-src/skills/roadmap-writing/SKILL.md +1 -1
- package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +1 -1
- package/dist/agent-src/skills/skill-writing/SKILL.md +4 -4
- package/dist/agent-src/skills/token-optimizer/SKILL.md +4 -4
- package/dist/agent-src/skills/upstream-contribute/SKILL.md +6 -6
- package/dist/agent-src/skills/using-git-worktrees/SKILL.md +25 -0
- package/dist/agent-src/templates/AGENTS.md +1 -1
- package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
- package/dist/agent-src/templates/command.md +1 -1
- package/dist/agent-src/templates/copilot-instructions.md +3 -3
- package/dist/agent-src/templates/rule.md +2 -2
- package/dist/agent-src/templates/scripts/work_engine/orchestration.ts +1 -1
- package/dist/agent-src/templates/skill-archive-note.md +5 -5
- package/dist/agent-src/templates/skill.md +1 -1
- package/dist/cli/agent-config.js +66 -19
- package/dist/cli/agent-config.js.map +1 -1
- package/dist/cli/main.js +9 -4
- package/dist/cli/main.js.map +1 -1
- package/dist/cli/python/workspace_drive.js +2 -0
- package/dist/cli/python/workspace_drive.js.map +1 -1
- package/dist/cli/python/workspace_drive_health.js +2 -0
- package/dist/cli/python/workspace_drive_health.js.map +1 -1
- package/dist/cli/python/workspace_hosts.js +2 -0
- package/dist/cli/python/workspace_hosts.js.map +1 -1
- package/dist/cli/python/workspace_sessions.js +2 -0
- package/dist/cli/python/workspace_sessions.js.map +1 -1
- package/dist/cli/registry.js +1 -0
- package/dist/cli/registry.js.map +1 -1
- package/dist/cli-delegate/{chunk-A3HJ6NTI.js → chunk-63WSP6YZ.js} +2 -1
- package/dist/cli-delegate/{chunk-EJYIGZ3T.js → chunk-BKO2AZ7Z.js} +1 -1
- package/dist/cli-delegate/{chunk-QFKQLQ7X.js → chunk-H574KOUH.js} +340 -462
- package/dist/cli-delegate/chunk-NXFWFAYV.js +339 -0
- package/dist/cli-delegate/{chunk-TEGJU2JX.js → chunk-ZXXJLL5K.js} +2 -2
- package/dist/cli-delegate/cmd_conformance.js +29 -23
- package/dist/cli-delegate/cmd_doctor.js +3 -3
- package/dist/cli-delegate/cmd_export.js +4 -4
- package/dist/cli-delegate/cmd_preflight.js +2 -2
- package/dist/cli-delegate/cmd_prune.js +4 -4
- package/dist/cli-delegate/cmd_settings_migrate.js +4 -4
- package/dist/cli-delegate/cmd_sync.js +4 -4
- package/dist/cli-delegate/cmd_uninstall.js +4 -4
- package/dist/cli-delegate/cmd_validate.js +4 -4
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +163 -103
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +3 -3
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +6 -5
- package/dist/discovery/trust-report.md +3 -3
- package/dist/discovery/workspaces.json +5 -4
- package/dist/hooks/dispatch.js +729 -430
- package/dist/install/install.mjs +700 -625
- package/dist/install/rule_scope.js +18 -2
- package/dist/install/rule_scope.js.map +1 -1
- package/dist/mcp/registry-manifest.json +3 -3
- package/dist/mcp/server.json +2 -2
- package/dist/mcp/server.mjs +564 -424
- package/dist/router.json +1 -1
- package/dist/scripts/_lib/claude_settings_hooks.js +30 -5
- package/dist/scripts/_lib/claude_settings_hooks.js.map +1 -1
- package/dist/scripts/_lib/scoped_projection.js +223 -0
- package/dist/scripts/_lib/scoped_projection.js.map +1 -0
- package/dist/scripts/_lib/surface_tiers.js +125 -0
- package/dist/scripts/_lib/surface_tiers.js.map +1 -0
- package/dist/scripts/_lib/token_count.js +166 -0
- package/dist/scripts/_lib/token_count.js.map +1 -0
- package/dist/scripts/_lib/trigger_eval_floors.js +8 -0
- package/dist/scripts/_lib/trigger_eval_floors.js.map +1 -1
- package/dist/scripts/condense.js +139 -9
- package/dist/scripts/condense.js.map +1 -1
- package/dist/scripts/project_thin_rules.js +450 -0
- package/dist/scripts/project_thin_rules.js.map +1 -0
- package/dist/server/routes/workspace.js +2 -0
- package/dist/server/routes/workspace.js.map +1 -1
- package/dist/server/schemas/settings.js +9 -3
- package/dist/server/schemas/settings.js.map +1 -1
- package/dist/ui/assets/index-DJY_vQVn.js +40 -0
- package/dist/ui/assets/index-DJY_vQVn.js.map +1 -0
- package/dist/ui/index.html +1 -1
- package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +1 -1
- package/package.json +11 -11
- package/src/agent-src/templates/AGENTS.md +1 -1
- package/src/agent-src/templates/scripts/work_engine/orchestration.ts +1 -1
- package/src/config/agent-settings.template.yml +59 -11
- package/src/config/ci-local-parity.yml +8 -0
- package/src/config/discovery/unassigned-artefacts.yml +23 -25
- package/src/config/evaluator-budgets.json +35 -5
- package/src/config/gate-coverage.yml +147 -0
- package/src/config/gate-violation-baselines.json +25 -0
- package/src/install/rule_scope.ts +27 -2
- package/src/scripts/_cli/cmd_conformance.ts +13 -24
- package/src/scripts/_dispatch.bash +10 -0
- package/src/scripts/_lib/claude_settings_hooks.ts +30 -4
- package/src/scripts/_lib/exec_evidence.ts +5 -0
- package/src/scripts/_lib/gate_baseline.ts +213 -0
- package/src/scripts/_lib/scoped_projection.ts +262 -0
- package/src/scripts/_lib/tier_budget_routing.ts +234 -0
- package/src/scripts/_lib/tool_adapter_registry.ts +8 -1
- package/src/scripts/_lib/trigger_eval_floors.ts +9 -0
- package/src/scripts/_lib/trigger_routers.ts +17 -5
- package/src/scripts/adr/regenerate_index.ts +4 -3
- package/src/scripts/ai-video/lib/parse-blueprint.sh +1 -1
- package/src/scripts/ai_council/compile_corpus.ts +1 -1
- package/src/scripts/audit_cloud_compatibility.ts +37 -2
- package/src/scripts/audit_initial_context.ts +53 -19
- package/src/scripts/audit_likelihood.ts +31 -2
- package/src/scripts/audit_user_type_axis.ts +58 -11
- package/src/scripts/bench_hook_latency.ts +172 -41
- package/src/scripts/build_mcp_catalog.ts +12 -1
- package/src/scripts/check_always_budget.ts +122 -11
- package/src/scripts/check_artefact_count_messaging.ts +128 -15
- package/src/scripts/check_augment_description_cap.ts +24 -3
- package/src/scripts/check_ci_strict_superset.ts +150 -0
- package/src/scripts/check_cluster_patterns.ts +100 -0
- package/src/scripts/check_consumer_scope_flip.ts +26 -4
- package/src/scripts/check_evaluator_budgets.ts +198 -19
- package/src/scripts/check_gate_coverage.ts +337 -1
- package/src/scripts/check_generator_output_coverage.ts +2 -1
- package/src/scripts/check_iron_law_prominence.ts +1 -1
- package/src/scripts/check_kernel_rule_bundle.ts +1 -1
- package/src/scripts/check_no_new_legacy_path.ts +167 -3
- package/src/scripts/check_pack_size.ts +18 -4
- package/src/scripts/check_portability.ts +37 -7
- package/src/scripts/check_references.ts +19 -3
- package/src/scripts/check_release_pr_shape.ts +13 -0
- package/src/scripts/check_token_regression.ts +9 -2
- package/src/scripts/condense.ts +155 -12
- package/src/scripts/cost/budget.mjs +63 -2
- package/src/scripts/count_scoped_projection.ts +104 -0
- package/src/scripts/evaluator_umbrella.sh +34 -1
- package/src/scripts/generate_capability_matrix.ts +8 -0
- package/src/scripts/generate_router_coverage_from_matrix.ts +155 -0
- package/src/scripts/hook_manifest.yaml +17 -3
- package/src/scripts/hooks/block_config_weakening.ts +337 -0
- package/src/scripts/hooks/concern_registry.ts +2 -0
- package/src/scripts/hooks/probe_throttle.ts +75 -0
- package/src/scripts/install-hooks.sh +24 -2
- package/src/scripts/install.ts +15 -92
- package/src/scripts/lint_agents_md.ts +9 -3
- package/src/scripts/lint_archived_skills.ts +1 -1
- package/src/scripts/lint_artefact_frontmatter.ts +185 -37
- package/src/scripts/lint_command_routing.ts +21 -52
- package/src/scripts/lint_command_verbs.ts +47 -28
- package/src/scripts/lint_context_spine_usage.ts +38 -12
- package/src/scripts/lint_framework_leakage.ts +25 -6
- package/src/scripts/lint_handoffs.ts +49 -2
- package/src/scripts/lint_media_policy_linkage.ts +62 -30
- package/src/scripts/lint_namespace.ts +92 -7
- package/src/scripts/lint_new_skill_gate.ts +39 -31
- package/src/scripts/lint_originality_shingles.ts +7 -1
- package/src/scripts/lint_override_kernel_guard.ts +21 -3
- package/src/scripts/lint_pack_boundaries.ts +461 -91
- package/src/scripts/lint_pack_dependencies.ts +24 -57
- package/src/scripts/lint_persona_governance.ts +1 -1
- package/src/scripts/lint_role_experiences.ts +34 -5
- package/src/scripts/lint_trigger_precision.ts +142 -0
- package/src/scripts/mcp_server/consumer_tool_catalog.json +12 -201
- package/src/scripts/mcp_server/tools.ts +1 -1
- package/src/scripts/prepack-check.mjs +40 -1
- package/src/scripts/prepack_router_targets.d.mts +7 -0
- package/src/scripts/prepack_router_targets.mjs +93 -0
- package/src/scripts/print_required_checks.ts +72 -18
- package/src/scripts/profile_staleness_hook.ts +12 -0
- package/src/scripts/record_evaluator_measurements.mjs +105 -0
- package/src/scripts/recruit_preflight.sh +1 -1
- package/src/scripts/release.ts +105 -1
- package/src/scripts/router_target_paths.d.mts +4 -0
- package/src/scripts/router_target_paths.mjs +69 -0
- package/src/scripts/router_telemetry.ts +52 -1
- package/src/scripts/routing_doctor.ts +485 -0
- package/src/scripts/rule_trigger_eval.ts +403 -0
- package/src/scripts/schemas/rule.schema.json +5 -1
- package/src/scripts/session_canary_hook.ts +96 -5
- package/src/scripts/skill_linter.ts +90 -42
- package/src/scripts/smoke/skills.sh +1 -1
- package/src/scripts/sweep_dead_scan_roots.ts +356 -10
- package/src/scripts/trigger_coverage.ts +13 -2
- package/src/scripts/update_counts.ts +91 -12
- package/src/scripts/validate_telegraph_carveouts.ts +1 -1
- package/src/scripts/wrapper_freshness_hook.ts +14 -0
- package/src/server/schemas/settings.ts +19 -5
- package/dist/cli-delegate/chunk-TJIAM5FW.js +0 -133
- package/dist/ui/assets/index-BpSQt5vm.js +0 -40
- package/dist/ui/assets/index-BpSQt5vm.js.map +0 -1
|
@@ -26,6 +26,7 @@ validator_ignore:
|
|
|
26
26
|
- type: "substring"
|
|
27
27
|
pattern: ".agent-src.uncondensed/"
|
|
28
28
|
reason: "Rule contrasts project-local placement with the .agent-src.uncondensed/rules/ alternative — mentioning the path is the argument."
|
|
29
|
+
self_contained: true
|
|
29
30
|
workspaces: [agent-config-maintainer, engineering, gtm]
|
|
30
31
|
packs: [ai-image, ai-video]
|
|
31
32
|
enforced_by:
|
|
@@ -58,12 +59,12 @@ When any trigger above matches in the user prompt or in a tool invocation, the a
|
|
|
58
59
|
|
|
59
60
|
Each policy carries its own trigger block, so within the active context the agent narrows from this superset to the policies whose specific patterns actually fired (e.g., a prompt naming a public figure activates `public-figures.md` and `disclosure.md`; a prompt requesting `--no-disclosure` activates `disclosure.md` standalone).
|
|
60
61
|
|
|
61
|
-
## Why project-local, not
|
|
62
|
+
## Why project-local, not `src/rules/`
|
|
62
63
|
|
|
63
|
-
The seven media policies live under [`agents/settings/policies/media/`](../../agents/settings/policies/media/), not as
|
|
64
|
+
The seven media policies live under [`agents/settings/policies/media/`](../../agents/settings/policies/media/), not as `src/rules/domain-safety-media-*.md`, for three reasons:
|
|
64
65
|
|
|
65
66
|
1. **They are consumed by skills and adapters**, not surfaced as standalone always-loaded prose. The cost is non-trivial (7 × ~80 lines = ~560 lines into the always-context if hoisted to rules), and most sessions never touch a video / image / voice surface.
|
|
66
|
-
2. **The enforcement model is project-local** — the working precedent (`/ghostwriter:*` mandatory footer in `write-engine.md`) and the audit log (session transcripts) are project artifacts. Rules under
|
|
67
|
+
2. **The enforcement model is project-local** — the working precedent (`/ghostwriter:*` mandatory footer in `write-engine.md`) and the audit log (session transcripts) are project artifacts. Rules under `src/rules/` are tool-portable governance; these policies are domain-specific bindings.
|
|
67
68
|
3. **Extraction to a reusable domain pack is explicitly deferred** until a second non-video domain (audio, image, docs, exports) lands with overlapping execution surfaces. Until then, a one-domain abstraction is structurally premature — the policies stay project-local and the routing rule is the on-demand bridge.
|
|
68
69
|
|
|
69
70
|
This routing rule is the bridge: it sits in the always-loaded rule set so the trigger keywords surface the project-local policies into context on demand, without paying the full always-loaded cost.
|
|
@@ -5,6 +5,7 @@ alwaysApply: false
|
|
|
5
5
|
description: "PR/issue/comment/commit bodies — no 'Generated with' / 'Co-authored by' / 'opened by' attribution footers"
|
|
6
6
|
triggers:
|
|
7
7
|
- keyword: "co-authored"
|
|
8
|
+
self_contained: true
|
|
8
9
|
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
9
10
|
packs: [meta]
|
|
10
11
|
---
|
|
@@ -6,6 +6,7 @@ triggers:
|
|
|
6
6
|
- phrase: "first turn"
|
|
7
7
|
- keyword: "onboarding"
|
|
8
8
|
- path_prefix: ".agent-settings.yml"
|
|
9
|
+
self_contained: true
|
|
9
10
|
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
10
11
|
packs: [meta]
|
|
11
12
|
enforced_by:
|
|
@@ -9,6 +9,7 @@ validator_ignore:
|
|
|
9
9
|
- type: "substring"
|
|
10
10
|
pattern: ".agent-src.uncondensed/"
|
|
11
11
|
reason: "Rule references the authoring tree as the operand of condensation/preservation."
|
|
12
|
+
self_contained: true
|
|
12
13
|
workspaces: [agent-config-maintainer]
|
|
13
14
|
packs: [meta]
|
|
14
15
|
enforced_by:
|
|
@@ -24,6 +24,7 @@ validator_ignore:
|
|
|
24
24
|
- type: "substring"
|
|
25
25
|
pattern: ".agent-settings.yml"
|
|
26
26
|
reason: "Rule reads quality.local_auto_run from .agent-settings.yml; naming the file is the contract."
|
|
27
|
+
self_contained: true
|
|
27
28
|
workspaces: [agent-config-maintainer, engineering]
|
|
28
29
|
packs: [meta]
|
|
29
30
|
roles: [planner]
|
|
@@ -6,6 +6,7 @@ alwaysApply: false
|
|
|
6
6
|
triggers:
|
|
7
7
|
- keyword: "active_role"
|
|
8
8
|
- keyword: "role-mode"
|
|
9
|
+
self_contained: true
|
|
9
10
|
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
10
11
|
packs: [meta]
|
|
11
12
|
---
|
|
@@ -14,6 +14,7 @@ validator_ignore:
|
|
|
14
14
|
- type: "substring"
|
|
15
15
|
pattern: "../../docs/"
|
|
16
16
|
reason: "See-also routes to docs/threat-model.md — the canonical attack-surface doc lives there by design."
|
|
17
|
+
self_contained: true
|
|
17
18
|
workspaces: [engineering]
|
|
18
19
|
packs: [engineering-base]
|
|
19
20
|
enforced_by:
|
|
@@ -7,6 +7,7 @@ triggers:
|
|
|
7
7
|
- keyword: "canary"
|
|
8
8
|
- keyword: "canary_name"
|
|
9
9
|
- phrase: "session canary"
|
|
10
|
+
self_contained: true
|
|
10
11
|
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
11
12
|
packs: [meta]
|
|
12
13
|
enforced_by:
|
|
@@ -21,7 +22,12 @@ two small, always-expected reply markers whose **silent disappearance** tells
|
|
|
21
22
|
the user the conversation is degrading and it is time for a fresh session —
|
|
22
23
|
long before the agent visibly starts making mistakes.
|
|
23
24
|
|
|
24
|
-
|
|
25
|
+
The canary is a **personal, user-global** concern — the name resolves through
|
|
26
|
+
three layers, first non-empty wins: project `.agent-settings.yml` →
|
|
27
|
+
`personal.canary_name` (override only) · user-global
|
|
28
|
+
`settings/.agent-settings.yml` → `personal.canary_name` · user-global
|
|
29
|
+
`settings/.agent-user.yml` → `identity.name` (the name the setup wizard
|
|
30
|
+
already collects — never duplicate it per project). No name on any layer →
|
|
25
31
|
rule is inert.
|
|
26
32
|
|
|
27
33
|
## The Iron Law
|
|
@@ -55,7 +61,8 @@ name it and suggest a fresh session or `/agent-handoff`, per
|
|
|
55
61
|
|
|
56
62
|
## When NOT to fire
|
|
57
63
|
|
|
58
|
-
- `personal.canary_name`
|
|
64
|
+
- No name on any layer (`personal.canary_name` project + user-global, global
|
|
65
|
+
`identity.name`) — fully inert, no greeting.
|
|
59
66
|
- Intermediate replies inside an ongoing task (greeting only at task start).
|
|
60
67
|
- The greeting never substitutes for substance — it prefixes the answer, it is
|
|
61
68
|
not the answer.
|
|
@@ -14,6 +14,7 @@ validator_ignore:
|
|
|
14
14
|
- type: "substring"
|
|
15
15
|
pattern: "external_sources_denylist"
|
|
16
16
|
reason: "Rule names the linter/denylist asset that necessarily holds the tokens."
|
|
17
|
+
self_contained: true
|
|
17
18
|
workspaces: [agent-config-maintainer]
|
|
18
19
|
packs: [meta]
|
|
19
20
|
enforced_by:
|
|
@@ -8,6 +8,7 @@ load_context:
|
|
|
8
8
|
triggers:
|
|
9
9
|
- keyword: "minimize tool calls"
|
|
10
10
|
- phrase: "fetching logs"
|
|
11
|
+
self_contained: true
|
|
11
12
|
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
12
13
|
packs: [meta]
|
|
13
14
|
---
|
|
@@ -34,10 +34,10 @@ THE CI LINK VALIDATOR IS A BACKSTOP, NOT A SUBSTITUTE FOR CARE.
|
|
|
34
34
|
|
|
35
35
|
About to edit any of:
|
|
36
36
|
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
37
|
+
- `src/rules/cli-output-handling.md`
|
|
38
|
+
- `src/rules/token-efficiency.md`
|
|
39
|
+
- `src/rules/direct-answers.md`
|
|
40
|
+
- `src/skills/rtk-output-filtering/SKILL.md`
|
|
41
41
|
- `src/domains/meta/agent-handoff/command.md`
|
|
42
42
|
- Any other asset cited by
|
|
43
43
|
[`token-optimizer`](../skills/token-optimizer/SKILL.md) (catalog
|
|
@@ -52,7 +52,7 @@ If the edit touches:
|
|
|
52
52
|
- **The asset's path / location** (rename, move, deletion)
|
|
53
53
|
|
|
54
54
|
then in the same commit, update the matching row in
|
|
55
|
-
|
|
55
|
+
`src/skills/token-optimizer/SKILL.md` —
|
|
56
56
|
the catalog table AND the relevant tree leaf.
|
|
57
57
|
|
|
58
58
|
## Out of scope
|
|
@@ -10,6 +10,7 @@ triggers:
|
|
|
10
10
|
- keyword: "recommendation"
|
|
11
11
|
- phrase: "what do you recommend"
|
|
12
12
|
- phrase: "was empfiehlst du"
|
|
13
|
+
self_contained: true
|
|
13
14
|
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
14
15
|
packs: [meta]
|
|
15
16
|
---
|
|
@@ -15,6 +15,7 @@ triggers:
|
|
|
15
15
|
- command: "implement-ticket"
|
|
16
16
|
load_context:
|
|
17
17
|
- ../contexts/execution/interrupt-examples.md
|
|
18
|
+
self_contained: true
|
|
18
19
|
workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
|
|
19
20
|
packs: [meta]
|
|
20
21
|
---
|
|
@@ -170,7 +170,7 @@ the area's contract from the README in
|
|
|
170
170
|
|
|
171
171
|
### 6. Validate
|
|
172
172
|
|
|
173
|
-
- Flat: `./scripts-run src/scripts/adr/regenerate_index --check` exits 0.
|
|
173
|
+
- Flat: `./scripts-run src/scripts/adr/regenerate_index --dir docs/decisions/ --check` exits 0.
|
|
174
174
|
- Per-area: `./scripts-run src/scripts/audit_adr_coverage --check` exits 0.
|
|
175
175
|
- The project's CI / quality pipeline passes — locally only when
|
|
176
176
|
`quality.local_auto_run: true`; under the default (`false` / missing)
|
|
@@ -27,7 +27,7 @@ gaps:
|
|
|
27
27
|
Use this skill when:
|
|
28
28
|
|
|
29
29
|
- A skill, rule, command, guideline, or context has been renamed or deleted
|
|
30
|
-
- Linking a newly added artifact from elsewhere in
|
|
30
|
+
- Linking a newly added artifact from elsewhere in `src/`
|
|
31
31
|
- Preparing a PR that touches cross-references between agent artifacts
|
|
32
32
|
- CI's `check-refs` job failed and the broken reference needs to be located
|
|
33
33
|
|
|
@@ -114,7 +114,7 @@ to [`upstream-contribute`](../upstream-contribute/SKILL.md).
|
|
|
114
114
|
**WHEN NOT to use this**
|
|
115
115
|
|
|
116
116
|
- The peer repo needs a generic walk-through first — route to
|
|
117
|
-
[`analyze-reference-repo`](
|
|
117
|
+
[`analyze-reference-repo`](../../commands/analyze/reference-repo.md);
|
|
118
118
|
this skill consumes its output, never duplicates it.
|
|
119
119
|
- The decision is to contribute back upstream — route to
|
|
120
120
|
[`upstream-contribute`](../upstream-contribute/SKILL.md).
|
|
@@ -102,7 +102,7 @@ CLI exit codes:
|
|
|
102
102
|
- **Denylist false positive** — a sensitive-looking filename outside the denylist surface (project-specific naming) will still pass `assert_safe()`. The denylist is necessary but not sufficient; the maintainer is responsible for never feeding secrets to the condenseor.
|
|
103
103
|
- **Frontmatter ordering with existing keys** — if the target already has frontmatter, the condenseor preserves existing keys, drops any prior `original_sha256:` / `condensed_at:` entries, and appends the new pair. Other agents reading the file should treat the SHA + timestamp pair as the canonical condensation marker, not the file size.
|
|
104
104
|
- **Negative savings on pointer-heavy files** — a `templates/AGENTS.md` that already follows Thin-Root (≥ 40 % pointers, ≥ 60-char *why*-clauses) has little prose left to drop; condensation may net near-zero or even add bytes via frontmatter. Run [`agents-md-thin-root`](../agents-md-thin-root/SKILL.md) first to maximise pointer share, then measure whether this skill still pays.
|
|
105
|
-
- **Generated-tree drift** — condensing
|
|
105
|
+
- **Generated-tree drift** — condensing `src/agent-src/templates/AGENTS.md` does NOT propagate to `.augment/`, `.claude/`, etc. until the package's sync + generate-tools scripts run (`scripts/condense.sh --sync` + `scripts/condense.ts --generate-tools`). Always regenerate after condensing a templated file.
|
|
106
106
|
|
|
107
107
|
## Measurement — when to condense
|
|
108
108
|
|
|
@@ -43,7 +43,7 @@ Do NOT use when:
|
|
|
43
43
|
| `deployment-order.md` | Migration strategy, feature flags, rollback plan | `migration-safety`, `judge-bug-hunter`, release reviewers |
|
|
44
44
|
| `observability.md` | Error tracking, log channels, metrics, known alerts | deploy reviewers, `bug-analyzer`, incident mode |
|
|
45
45
|
|
|
46
|
-
The templates ship in
|
|
46
|
+
The templates ship in `src/agent-src/templates/contexts/` and are
|
|
47
47
|
copied into `agents/settings/contexts/` by the installer.
|
|
48
48
|
|
|
49
49
|
## Procedure: context-authoring
|
|
@@ -185,7 +185,7 @@ it as "redundant" and never trim its bullets. The patterns it covers:
|
|
|
185
185
|
(`../docs/guidelines/foo.md`, `../contexts/bar.md`) — paths resolve
|
|
186
186
|
from the file's delivered location, not from the symlink in
|
|
187
187
|
`.claude/rules/` etc. (per `road-to-path-fixes.md` Strategy A).
|
|
188
|
-
- `path_prefix:` triggers containing
|
|
188
|
+
- `path_prefix:` triggers containing `src/` —
|
|
189
189
|
literal match patterns, not file refs (per Modified Option 1,
|
|
190
190
|
P2.2).
|
|
191
191
|
- Symlinked rule files under `.claude/rules/`, `.cursor/rules/`,
|
|
@@ -63,7 +63,7 @@ Report which checks pass / fail in one compact line — **not** a long essay.
|
|
|
63
63
|
|
|
64
64
|
If the target is a skill, check for a trigger-eval report:
|
|
65
65
|
|
|
66
|
-
*
|
|
66
|
+
* `src/skills/{name}/evals/triggers.json` — the expected-trigger corpus
|
|
67
67
|
* `evals/last-run.json` — the most recent runner output (see
|
|
68
68
|
[`scripts/skill_trigger_eval.ts`](../../../scripts/skill_trigger_eval.ts))
|
|
69
69
|
|
|
@@ -63,6 +63,7 @@ Read `.github/workflows/` to discover the actual job matrix. Common patterns:
|
|
|
63
63
|
- Use **concurrency groups** to prevent duplicate runs: `group: ${{ github.workflow }}-${{ github.ref }}`
|
|
64
64
|
- Use **`fail-fast: false`** in matrix strategies for independent job execution.
|
|
65
65
|
- Extract shared logic into **reusable workflows** (`module-deploy.yaml` pattern).
|
|
66
|
+
- A job with **`container:`** MUST run `git config --global --add safe.directory "$GITHUB_WORKSPACE"` immediately after `actions/checkout` — the checkout is owned by a different UID than the container user, so without it every git-backed step dies with `fatal: detected dubious ownership`.
|
|
66
67
|
|
|
67
68
|
### Composer auth
|
|
68
69
|
|
|
@@ -48,7 +48,7 @@ Creating or materially rewriting a guideline **must** go through Understand
|
|
|
48
48
|
* **Understand** — which skills or rules will cite this guideline? If the
|
|
49
49
|
answer is "none", the guideline has no home — stop.
|
|
50
50
|
* **Research** — **inspect** `docs/guidelines/` for overlap and grep
|
|
51
|
-
|
|
51
|
+
`src/` for pages that already cover the topic.
|
|
52
52
|
**Analyze** 1–2 peer guidelines in the same topic folder for tone.
|
|
53
53
|
* **Draft** — propose location (topic folder + filename) and outline. Only
|
|
54
54
|
fill bodies once the outline is confirmed.
|
|
@@ -24,7 +24,7 @@ packs:
|
|
|
24
24
|
|
|
25
25
|
Use this skill when:
|
|
26
26
|
|
|
27
|
-
- Validating the shape of every skill and rule in
|
|
27
|
+
- Validating the shape of every skill and rule in `src/`
|
|
28
28
|
- Verifying execution metadata (`execution.type`, `handler`, `command`) is well-formed
|
|
29
29
|
- Checking locally before opening a PR that CI's skill-lint job will pass
|
|
30
30
|
- Investigating a reported linter failure on a specific skill or rule
|
|
@@ -206,7 +206,7 @@ Compare the README's claims to the live repository:
|
|
|
206
206
|
| # | Severity | Section | Issue | Fix |
|
|
207
207
|
|---|---|---|---|---|
|
|
208
208
|
| 1 | ❌ Critical | Install | Command `X` does not exist | Replace with `Y` |
|
|
209
|
-
| 2 | ❌ Critical | Profile grid | Link
|
|
209
|
+
| 2 | ❌ Critical | Profile grid | Link `src/agent-src/profiles/` 404s | Repoint to `packages/core/src/agent-src/profiles/` |
|
|
210
210
|
| 3 | ⚠️ Major | Badges | "Skills: 218" — live count is 207 | Update badge or note drift |
|
|
211
211
|
| 4 | ⚠️ Major | Usage | Example uses deprecated API | Update to current API |
|
|
212
212
|
| 5 | ℹ️ Minor | Structure | Requirements buried below usage | Move above install |
|
|
@@ -147,6 +147,11 @@ Every roadmap follows this structure:
|
|
|
147
147
|
- Never remove completed steps — they serve as history.
|
|
148
148
|
- **Status is binary: `ready` (default, implicit) or `draft`.** New roadmaps are created **ready** unless the user explicitly says otherwise — `ready` is implicit and need not be written. A roadmap that is still being authored, awaiting upstream decisions, or capturing options without a worked plan declares `status: draft` in YAML frontmatter at the top of the file. Drafts are hidden from `agents/roadmaps-progress.md` until the flag is removed or flipped to `ready`. There are no other status values; legacy banners (`**Status: directional**`, `Status: capture-only`, `mode: feedback`) are removed.
|
|
149
149
|
|
|
150
|
+
### Awaiting evidence — a blocker entry, never a new glyph
|
|
151
|
+
|
|
152
|
+
- Waiting on **evidence that has not arrived** (soak still running, benchmark unfunded, adopter absent) is neither `[~]` nor `[-]`. Signal it with a structured `## Blockers` entry — five-field shape in [`templates/roadmaps.md` rule 20](../../agent-src/templates/roadmaps.md) — whose `Resolved when:` names the decidable signal ending the wait. The item stays `- [ ]` and points at it: `<!-- blocked-by: <id> -->`.
|
|
153
|
+
- **No new glyph.** `[ ]` + `blocked-by:` = open, awaiting named evidence (stays active) · `[~]` = deferred by decision (bars archival, Iron Law 3) · `[-]` = cancelled with a reason (does not bar it). A fifth state buys nothing the entry above does not already carry.
|
|
154
|
+
|
|
150
155
|
### Phases
|
|
151
156
|
|
|
152
157
|
- Group related steps into phases (e.g. "Preparation", "Migration", "Cleanup").
|
|
@@ -488,7 +493,9 @@ owner, blocked scope, and full instructions. Authoring shape:
|
|
|
488
493
|
[`templates/roadmaps.md` rule 20](../../agent-src/templates/roadmaps.md);
|
|
489
494
|
authoring guidance: [`roadmap-writing § 5b`](../roadmap-writing/SKILL.md).
|
|
490
495
|
Clearing a blocker flips its `Status: resolved` and regenerates the
|
|
491
|
-
dashboard in the same reply, same cadence as a checkbox flip.
|
|
496
|
+
dashboard in the same reply, same cadence as a checkbox flip. The
|
|
497
|
+
blocker entry is also the canonical **awaiting-evidence** signal —
|
|
498
|
+
see [§ Awaiting evidence](#awaiting-evidence--a-blocker-entry-never-a-new-glyph).
|
|
492
499
|
|
|
493
500
|
## Rubric pass (optional, surfacing-only)
|
|
494
501
|
|
|
@@ -57,7 +57,7 @@ or supersession before opening a new one.
|
|
|
57
57
|
### 1. Read the canonical template first
|
|
58
58
|
|
|
59
59
|
The structure, frontmatter, lifecycle, and complexity-tier rules live
|
|
60
|
-
in [
|
|
60
|
+
in [`src/agent-src/templates/roadmaps.md`](../../templates/roadmaps.md).
|
|
61
61
|
Read it before authoring. Do not restate its rules in the roadmap
|
|
62
62
|
body — link the template if a phase needs to override one.
|
|
63
63
|
|
|
@@ -154,7 +154,7 @@ Ask the user:
|
|
|
154
154
|
1. Read `project.upstream_repo` and `project.improvement_pr_branch_prefix` from `.agent-settings.yml`
|
|
155
155
|
2. If `project.upstream_repo` is empty → ask user for the target repo
|
|
156
156
|
3. Create branch: `{prefix}{learning-slug}` from `main`
|
|
157
|
-
4. Commit changes to
|
|
157
|
+
4. Commit changes to `src/` AND `.augment/`
|
|
158
158
|
5. Push branch
|
|
159
159
|
6. Create PR with title: `improve(agent): {short description}`
|
|
160
160
|
7. Use the agent-improvement PR template if it exists
|
|
@@ -68,8 +68,8 @@ Ask: **"Does the model need this to do its job correctly?"**
|
|
|
68
68
|
|
|
69
69
|
### Skills and commands share the `.claude/skills/` namespace
|
|
70
70
|
|
|
71
|
-
Skills in
|
|
72
|
-
|
|
71
|
+
Skills in `src/skills/{name}/SKILL.md` AND commands in
|
|
72
|
+
`src/domains/{domain}/{name}/command.md` both project into
|
|
73
73
|
`.claude/skills/` (see `scripts/condense.ts` →
|
|
74
74
|
`generate_claude_skills` + `generate_claude_commands`). Claude treats
|
|
75
75
|
the whole directory as native skills.
|
|
@@ -111,7 +111,7 @@ Do NOT create a skill or rule for:
|
|
|
111
111
|
### 0. Inspect, then run the Drafting Protocol
|
|
112
112
|
|
|
113
113
|
Before writing, **inspect** the landscape: grep
|
|
114
|
-
|
|
114
|
+
`src/skills/` and `src/rules/` for duplicates or
|
|
115
115
|
near-matches, and **analyze** 1–2 gold-standard peers (e.g. `pest-testing`,
|
|
116
116
|
`php-coder`) to anchor shape and tone. If requirements are unclear or
|
|
117
117
|
incomplete, stop and ask — do not assume.
|
|
@@ -308,7 +308,7 @@ asks for it.
|
|
|
308
308
|
**Workspace layout** (all under `.gitignore`):
|
|
309
309
|
|
|
310
310
|
```
|
|
311
|
-
|
|
311
|
+
src/skills/{name}/evals/
|
|
312
312
|
triggers.json # tracked — routing eval (§ 1c)
|
|
313
313
|
evals.json # tracked — behavior eval definitions
|
|
314
314
|
runs/ # gitignored — per-iteration outputs
|
|
@@ -79,11 +79,11 @@ INTENT
|
|
|
79
79
|
|
|
80
80
|
| Asset | Path | Trigger keywords | What it does |
|
|
81
81
|
|---|---|---|---|
|
|
82
|
-
| `cli-output-handling` |
|
|
83
|
-
| `rtk-output-filtering` |
|
|
84
|
-
| `token-efficiency` |
|
|
82
|
+
| `cli-output-handling` | `src/rules/cli-output-handling.md` | `verbose`, `tail`, `grep`, `CLI` | Wrap-tail-grep contract for any verbose command |
|
|
83
|
+
| `rtk-output-filtering` | `src/skills/rtk-output-filtering/SKILL.md` | `rtk`, `verbose`, `filter`, `wrap` | Project-local rtk filters; wrapper command |
|
|
84
|
+
| `token-efficiency` | `src/rules/token-efficiency.md` | `redirect`, `verbose`, `concise`, `tool` | Batch + parallelize tool calls; brevity floor |
|
|
85
85
|
| `agent-handoff` | `src/domains/meta/agent-handoff/command.md` | `handoff`, `fresh`, `chat`, `context` | Context envelope for fresh-chat continuation |
|
|
86
|
-
| `direct-answers` |
|
|
86
|
+
| `direct-answers` | `src/rules/direct-answers.md` | `brevity`, `flattery`, `severity`, `tiered` | Iron-Law brevity floor (kernel) |
|
|
87
87
|
| `markitdown` | upstream: github.com/microsoft/markitdown | `PDF`, `DOCX`, `HTML`, `convert` | Document → markdown converter (authoritative-link only) |
|
|
88
88
|
| `/cost:report` | TBD — an internal roadmap (local-only) § P1.2` | `cost`, `model spend`, `budget` | Per-session cost telemetry (planned) |
|
|
89
89
|
| `api-cost-levers` | `docs/guidelines/agent-infra/api-cost-levers.md` | `cache`, `caching`, `batch`, `tiering`, `effort` | Anthropic billing levers: prompt caching, Batch API, model tiering, effort/output right-sizing |
|
|
@@ -79,12 +79,12 @@ Before ANY upstream work (branch, files, PR), ask the user:
|
|
|
79
79
|
|
|
80
80
|
### 1. Determine contribution type
|
|
81
81
|
|
|
82
|
-
| Type |
|
|
82
|
+
| Type | Source path | Condensed path |
|
|
83
83
|
|---|---|---|
|
|
84
|
-
| **New skill** |
|
|
85
|
-
| **New rule** |
|
|
86
|
-
| **New command** |
|
|
87
|
-
| **New guideline** |
|
|
84
|
+
| **New skill** | `src/skills/{name}/SKILL.md` | `.augment/skills/{name}/SKILL.md` |
|
|
85
|
+
| **New rule** | `src/rules/{name}.md` | `.augment/rules/{name}.md` |
|
|
86
|
+
| **New command** | `src/domains/{domain}/{name}/command.md` | `.augment/commands/{name}.md` |
|
|
87
|
+
| **New guideline** | `docs/guidelines/{category}/{name}.md` | `.augment/guidelines/{category}/{name}.md` |
|
|
88
88
|
| **Update to existing** | Same path as original | Same path as original |
|
|
89
89
|
|
|
90
90
|
### 2. Apply locally as override (immediate benefit)
|
|
@@ -151,7 +151,7 @@ git checkout -b feat/skills/{name} # or fix/rules/{name}, etc.
|
|
|
151
151
|
|
|
152
152
|
Create both files:
|
|
153
153
|
|
|
154
|
-
- **
|
|
154
|
+
- **Source version** → `src/{type}/{name}` (full, verbose, human-readable)
|
|
155
155
|
- **Condensed version** → `.augment/{type}/{name}` (token-efficient, preserving all code blocks,
|
|
156
156
|
headings, frontmatter, validation, gotchas)
|
|
157
157
|
|
|
@@ -125,6 +125,27 @@ cd .worktrees/<branch-name>
|
|
|
125
125
|
Branch names must match the project convention — see
|
|
126
126
|
`commit-conventions` rule.
|
|
127
127
|
|
|
128
|
+
### 4b. Seed the worktree — allow / deny list
|
|
129
|
+
|
|
130
|
+
`git worktree add` checks out **tracked files only**. Everything
|
|
131
|
+
gitignored — dependencies, generated projections, build output, local
|
|
132
|
+
config — is absent. Seeding the wrong subset is the recurring
|
|
133
|
+
worktree-trap family: a gate then fails (or falsely passes) for a
|
|
134
|
+
reason the change did not cause.
|
|
135
|
+
|
|
136
|
+
| Artefact | Action | Why |
|
|
137
|
+
|---|---|---|
|
|
138
|
+
| The dependency tree the § 5 install would produce (`vendor/`, `node_modules/`, `.venv/`, `target/`, …) | **symlink** from the primary checkout, or run the § 5 install | Absent ⇒ every gate that shells to a local binary dies on its first import. A **partial** tree (only the binary shim directory) is worse than none — it produces a scatter of spurious failures. Symlink or install fully; never half. |
|
|
139
|
+
| Generated agent projections (`.augment/`, other tool trees) | **copy** from the primary checkout, or regenerate before running gates | Several gates read the projection tree. Absent ⇒ the gate reports "produced by regeneration but absent before" — red for a reason the contributor did not cause. |
|
|
140
|
+
| Build output (`dist/`, compiled artefacts) | **regenerate**, never copy a stale tree | A stale copy makes a byte-identity check report generator drift that does not exist. |
|
|
141
|
+
| Local settings (`.agent-settings.yml`, `.agent-settings.local.yml`) | **NEVER copy** | Gitignored, machine-local, and deliberately absent in CI. **Absent IS the CI shape** — copying it makes local gate results diverge from the gate that actually decides. A worktree that carries it is testing a configuration no pipeline runs. |
|
|
142
|
+
| Secrets, `.env`, credential files | **NEVER copy** | Same reasoning, plus leak surface. |
|
|
143
|
+
|
|
144
|
+
The list is encoded here, in the flow, on purpose: a separate committed
|
|
145
|
+
manifest is warranted only when a **flow-external** tool needs to read
|
|
146
|
+
it. Tools that seed their own throwaway worktrees already handle their
|
|
147
|
+
own dependency link inline and need no manifest.
|
|
148
|
+
|
|
128
149
|
### 5. Install dependencies + verify baseline
|
|
129
150
|
|
|
130
151
|
Auto-detect from manifest files:
|
|
@@ -167,6 +188,10 @@ starting a new worktree on the same branch.
|
|
|
167
188
|
from manifest files.
|
|
168
189
|
* **Skipping baseline** — failing tests pre-existed; later blamed on
|
|
169
190
|
your own changes.
|
|
191
|
+
* **Copying local settings in** — the worktree then passes gates the
|
|
192
|
+
pipeline fails (§ 4b deny list). Absent is correct.
|
|
193
|
+
* **Partial dependency tree** — a `.bin`-only symlink yields a scatter
|
|
194
|
+
of spurious failures; bisect in a clean scratch worktree instead.
|
|
170
195
|
|
|
171
196
|
## Output format
|
|
172
197
|
|
|
@@ -30,5 +30,5 @@
|
|
|
30
30
|
2. **What language?** — Project-specific; agents mirror the user's language at runtime.
|
|
31
31
|
3. **Where do I edit agent-config?** — Do not edit `.augment/` or `dist/agent-src/` here; they are installed artifacts. Project edits live in `agents/` and project source.
|
|
32
32
|
4. **Lint / test / sync entry point?** — Project-specific (see project README); agent-config reinstalls via `composer update event4u/agent-config` or `npm update @event4u/agent-config`.
|
|
33
|
-
5. **Where do the always-active rules live?** — `dist/agent-src/rules/` (kernel = 9 Iron-Law rules; tier-1 / tier-2 routed via `dist/
|
|
33
|
+
5. **Where do the always-active rules live?** — `dist/agent-src/rules/` (kernel = 9 Iron-Law rules; tier-1 / tier-2 routed via `dist/router.json`).
|
|
34
34
|
6. **Per-module agent docs?** — If `modules.enabled: true`, each module under `modules.root_paths` may carry its own `{agent_folder}/` (default `agents/`). See `module-management` skill.
|
|
@@ -39,7 +39,7 @@ schema_version: 1
|
|
|
39
39
|
# CI guard: a release bump of `package.json` must update this value
|
|
40
40
|
# in lockstep — see scripts/check_template_pin_drift.ts (road-to-
|
|
41
41
|
# portable-runtime-and-update-check P3.3).
|
|
42
|
-
agent_config_version: "9.
|
|
42
|
+
agent_config_version: "9.15.0"
|
|
43
43
|
|
|
44
44
|
# --- Project identity ---
|
|
45
45
|
project:
|
|
@@ -49,7 +49,7 @@ suggestion:
|
|
|
49
49
|
|
|
50
50
|
{One-line summary of what this command does.}
|
|
51
51
|
|
|
52
|
-
**Source of truth:**
|
|
52
|
+
**Source of truth:** `src/` — never read or edit `dist/agent-src/` or `.augment/` directly.
|
|
53
53
|
|
|
54
54
|
## Steps
|
|
55
55
|
|