@event4u/agent-config 1.24.0 → 1.25.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.
Files changed (72) hide show
  1. package/.agent-src/commands/review-routing.md +7 -10
  2. package/.agent-src/contexts/authority/kernel-rule-edits.md +48 -0
  3. package/.agent-src/contexts/authority/scope-mechanics.md +15 -0
  4. package/.agent-src/contexts/contracts/consumer-agents-md-guide.md +127 -0
  5. package/.agent-src/contexts/contracts/emergency-triage-block.md +53 -0
  6. package/.agent-src/rules/analysis-skill-routing.md +1 -1
  7. package/.agent-src/rules/artifact-drafting-protocol.md +1 -1
  8. package/.agent-src/rules/artifact-engagement-recording.md +1 -1
  9. package/.agent-src/rules/augment-source-of-truth.md +1 -1
  10. package/.agent-src/rules/autonomous-execution.md +1 -1
  11. package/.agent-src/rules/caveman-speak.md +1 -1
  12. package/.agent-src/rules/cli-output-handling.md +1 -1
  13. package/.agent-src/rules/command-suggestion-policy.md +1 -1
  14. package/.agent-src/rules/docs-sync.md +1 -1
  15. package/.agent-src/rules/guidelines.md +1 -1
  16. package/.agent-src/rules/improve-before-implement.md +1 -1
  17. package/.agent-src/rules/invite-challenge.md +1 -1
  18. package/.agent-src/rules/minimal-safe-diff.md +1 -1
  19. package/.agent-src/rules/model-recommendation.md +1 -1
  20. package/.agent-src/rules/no-attribution-footers.md +1 -1
  21. package/.agent-src/rules/no-roadmap-references.md +56 -20
  22. package/.agent-src/rules/onboarding-gate.md +1 -1
  23. package/.agent-src/rules/package-ci-checks.md +1 -1
  24. package/.agent-src/rules/reviewer-awareness.md +9 -2
  25. package/.agent-src/rules/roadmap-progress-sync.md +1 -1
  26. package/.agent-src/rules/scope-control.md +6 -0
  27. package/.agent-src/rules/security-sensitive-stop.md +1 -1
  28. package/.agent-src/rules/size-enforcement.md +1 -1
  29. package/.agent-src/rules/token-optimizer-maintenance.md +1 -1
  30. package/.agent-src/rules/ui-audit-gate.md +1 -1
  31. package/.agent-src/skills/adr-create/SKILL.md +2 -1
  32. package/.agent-src/skills/agents-md-thin-root/SKILL.md +125 -0
  33. package/.agent-src/skills/ai-council/SKILL.md +9 -7
  34. package/.agent-src/skills/review-routing/SKILL.md +3 -4
  35. package/.agent-src/templates/AGENTS.md +18 -148
  36. package/.agent-src/templates/copilot-instructions.md +41 -17
  37. package/.agent-src/templates/github-workflows/pr-risk-review.yml +1 -1
  38. package/.agent-src/templates/scripts/pr_review_routing.py +1 -1
  39. package/.claude-plugin/marketplace.json +2 -1
  40. package/AGENTS.md +18 -216
  41. package/CHANGELOG.md +44 -0
  42. package/README.md +2 -2
  43. package/docs/architecture.md +13 -7
  44. package/docs/catalog.md +26 -27
  45. package/docs/contracts/agents-md-tech-stack.md +74 -0
  46. package/docs/contracts/linear-ai-rules-inclusion.md +1 -1
  47. package/docs/contracts/package-self-orientation.md +135 -0
  48. package/docs/contracts/rule-classification.md +4 -4
  49. package/docs/decisions/ADR-004-rule-governance-pruning.md +240 -0
  50. package/docs/getting-started.md +1 -1
  51. package/docs/guidelines/agent-infra/review-routing-data-format.md +1 -2
  52. package/package.json +1 -1
  53. package/scripts/_p4_migrate.py +5 -5
  54. package/scripts/audit_auto_rules.py +159 -0
  55. package/scripts/audit_likelihood.py +148 -0
  56. package/scripts/audit_overlap.py +145 -0
  57. package/scripts/build_rule_trigger_matrix.py +3 -5
  58. package/scripts/check_augment_description_cap.py +79 -0
  59. package/scripts/check_council_references.py +3 -3
  60. package/scripts/check_kernel_rule_bundle.py +151 -0
  61. package/scripts/check_references.py +21 -1
  62. package/scripts/compile_router.py +3 -0
  63. package/scripts/install.sh +0 -1
  64. package/scripts/lint_agents_md.py +168 -0
  65. package/scripts/measure_augment_budget.py +208 -0
  66. package/scripts/schemas/rule.schema.json +2 -1
  67. package/scripts/skill_linter.py +10 -4
  68. package/scripts/spotcheck_thin_root.py +134 -0
  69. package/scripts/update_counts.py +6 -10
  70. package/.agent-src/rules/no-council-references.md +0 -76
  71. package/.agent-src/rules/review-routing-awareness.md +0 -19
  72. package/.agent-src/templates/copilot-review-instructions.md +0 -76
package/.agent-src/templates/copilot-review-instructions.md DELETED
@@ -1,76 +0,0 @@
1
- # Copilot Code Review — Repository-Specific Suppressions
2
-
3
- > Read by GitHub Copilot Code Review (PR bot) when reviewing this repo.
4
- > Companion to `.github/copilot-instructions.md`. **This file is the
5
- > path-resolution suppression floor** — it carries the rules Copilot
6
- > needs to *not* flag, sharply scoped to the agent-config layout.
7
-
8
- ## Why this file exists
9
-
10
- The repo ships agent-config rules, skills, commands, and contexts under
11
- `.augment/`, `.agent-src/`, and (during authoring) `.agent-src.uncompressed/`.
12
- Cross-references inside those trees are valid via the **delivered**
13
- `.augment/` layout — not via raw git checkout. Copilot's static checker
14
- walks the git tree, so it sees broken paths where there are none.
15
-
16
- This is **intentional, not a bug**. The installer (`scripts/install.sh`)
17
- projects `.agent-src/` → `.augment/` and creates the symlinks that make
18
- the paths resolve at agent runtime.
19
-
20
- ## ✅ Known False Positives — Do NOT Flag
21
-
22
- ### Relative cross-references inside markdown rules / skills / commands
23
-
24
- ```markdown
25
- [link](../docs/guidelines/foo.md)
26
- [link](../contexts/bar.md)
27
- [link](../docs/guidelines/baz.md)
28
- ```
29
-
30
- These resolve from the file's delivered location (e.g.
31
- `.augment/rules/<rule>.md`). Even when the file is symlinked into
32
- `.claude/rules/`, `.cursor/rules/`, or `.clinerules/`, the relative
33
- form is correct by construction.
34
-
35
- ### `path_prefix:` triggers containing `.agent-src.uncompressed/`
36
-
37
- ```yaml
38
- triggers:
39
- - path_prefix: ".agent-src.uncompressed/rules/"
40
- ```
41
-
42
- This is a **literal match string** for the host's router — *not* a file
43
- reference. Source-of-truth meta-rules (`augment-source-of-truth`,
44
- `augment-portability`, `skill-quality`, `docs-sync`,
45
- `rule-type-governance`) legitimately match against the authoring tree.
46
-
47
- ### Symlinked rule / skill / command files
48
-
49
- Targets resolve into `.augment/rules/`, `.augment/skills/`,
50
- `.augment/commands/` via installer-managed symlinks. Missing-file
51
- reports under `.claude/`, `.cursor/`, `.clinerules/` are renderer
52
- artifacts, not real bugs.
53
-
54
- ### Body-link forms `../docs/guidelines/...`
55
-
56
- Single-up form is the post-rewrite shape produced by
57
- `scripts/compress.py`. The compressed `.agent-src/rules/` tree is one
58
- level deeper than the source `.agent-src.uncompressed/rules/`, so the
59
- rewriter collapses `../../docs/...` to `../docs/...`. Both forms are
60
- expected — one in source, one in compressed output.
61
-
62
- ## ✅ What TO flag
63
-
64
- - Code defects, security issues, broken tests, type errors — normal
65
- review.
66
- - New `.agent-src.uncompressed/` substrings introduced into
67
- `.agent-src/rules/` body content (the `check-compressed-paths` task
68
- already gates this — flag it as a regression if it slips through).
69
- - Rule frontmatter with `load_context:` entries that don't follow the
70
- logical-name convention (`contexts/<area>/<file>.md`).
71
-
72
- ## Pointer
73
-
74
- The full architecture is in `docs/architecture.md` § "Path resolution
75
- and Copilot integration". The compressed-path validator is
76
- `scripts/check_compressed_paths.py`, wired into `task ci`.