@event4u/agent-config 2.6.0 → 2.7.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 (132) hide show
  1. package/.agent-src/commands/agent-handoff.md +1 -0
  2. package/.agent-src/commands/agent-status.md +1 -0
  3. package/.agent-src/commands/agents/audit.md +1 -0
  4. package/.agent-src/commands/agents/init.md +1 -0
  5. package/.agent-src/commands/agents/optimize.md +1 -0
  6. package/.agent-src/commands/agents.md +1 -0
  7. package/.agent-src/commands/analyze-reference-repo.md +1 -0
  8. package/.agent-src/commands/bug-fix.md +1 -0
  9. package/.agent-src/commands/bug-investigate.md +1 -0
  10. package/.agent-src/commands/challenge-me/vision.md +1 -0
  11. package/.agent-src/commands/challenge-me/with-docs.md +1 -0
  12. package/.agent-src/commands/challenge-me.md +1 -0
  13. package/.agent-src/commands/chat-history/import.md +1 -0
  14. package/.agent-src/commands/chat-history/learn.md +1 -0
  15. package/.agent-src/commands/chat-history/show.md +1 -0
  16. package/.agent-src/commands/chat-history.md +1 -0
  17. package/.agent-src/commands/check-current-md.md +1 -0
  18. package/.agent-src/commands/commit/in-chunks.md +1 -0
  19. package/.agent-src/commands/commit.md +1 -0
  20. package/.agent-src/commands/compress.md +1 -0
  21. package/.agent-src/commands/context/create.md +1 -0
  22. package/.agent-src/commands/context/refactor.md +1 -0
  23. package/.agent-src/commands/context.md +1 -0
  24. package/.agent-src/commands/cost-report.md +1 -0
  25. package/.agent-src/commands/council/default.md +1 -0
  26. package/.agent-src/commands/council/design.md +1 -0
  27. package/.agent-src/commands/council/optimize.md +1 -0
  28. package/.agent-src/commands/council/pr.md +1 -0
  29. package/.agent-src/commands/council.md +1 -0
  30. package/.agent-src/commands/create-pr/description-only.md +1 -0
  31. package/.agent-src/commands/create-pr.md +1 -0
  32. package/.agent-src/commands/e2e-heal.md +1 -0
  33. package/.agent-src/commands/e2e-plan.md +1 -0
  34. package/.agent-src/commands/estimate-ticket.md +1 -0
  35. package/.agent-src/commands/feature/dev.md +1 -0
  36. package/.agent-src/commands/feature/explore.md +1 -0
  37. package/.agent-src/commands/feature/plan.md +1 -0
  38. package/.agent-src/commands/feature/refactor.md +1 -0
  39. package/.agent-src/commands/feature/roadmap.md +1 -0
  40. package/.agent-src/commands/feature.md +1 -0
  41. package/.agent-src/commands/fix/ci.md +1 -0
  42. package/.agent-src/commands/fix/portability.md +1 -0
  43. package/.agent-src/commands/fix/pr-bot-comments.md +1 -0
  44. package/.agent-src/commands/fix/pr-comments.md +1 -0
  45. package/.agent-src/commands/fix/pr-developer-comments.md +1 -0
  46. package/.agent-src/commands/fix/refs.md +1 -0
  47. package/.agent-src/commands/fix/seeder.md +1 -0
  48. package/.agent-src/commands/fix.md +1 -0
  49. package/.agent-src/commands/grill-me.md +1 -0
  50. package/.agent-src/commands/implement-ticket.md +1 -0
  51. package/.agent-src/commands/jira-ticket.md +1 -0
  52. package/.agent-src/commands/judge/on-diff.md +1 -0
  53. package/.agent-src/commands/judge/solo.md +1 -0
  54. package/.agent-src/commands/judge/steps.md +1 -0
  55. package/.agent-src/commands/judge.md +1 -0
  56. package/.agent-src/commands/memory/add.md +1 -0
  57. package/.agent-src/commands/memory/load.md +1 -0
  58. package/.agent-src/commands/memory/mine-session.md +1 -0
  59. package/.agent-src/commands/memory/promote.md +1 -0
  60. package/.agent-src/commands/memory/propose.md +1 -0
  61. package/.agent-src/commands/memory.md +1 -0
  62. package/.agent-src/commands/mode.md +1 -0
  63. package/.agent-src/commands/module/create.md +1 -0
  64. package/.agent-src/commands/module/explore.md +1 -0
  65. package/.agent-src/commands/module.md +1 -0
  66. package/.agent-src/commands/onboard.md +1 -0
  67. package/.agent-src/commands/optimize/agents-dir.md +1 -0
  68. package/.agent-src/commands/optimize/augmentignore.md +1 -0
  69. package/.agent-src/commands/optimize/rtk.md +1 -0
  70. package/.agent-src/commands/optimize/skills.md +1 -0
  71. package/.agent-src/commands/optimize-prompt.md +1 -0
  72. package/.agent-src/commands/optimize.md +1 -0
  73. package/.agent-src/commands/orchestrate.md +1 -0
  74. package/.agent-src/commands/override/create.md +1 -0
  75. package/.agent-src/commands/override/manage.md +1 -0
  76. package/.agent-src/commands/override.md +1 -0
  77. package/.agent-src/commands/package-reset.md +1 -0
  78. package/.agent-src/commands/package-test.md +1 -0
  79. package/.agent-src/commands/prepare-for-review.md +1 -0
  80. package/.agent-src/commands/project-analyze.md +1 -0
  81. package/.agent-src/commands/project-health.md +1 -0
  82. package/.agent-src/commands/quality-fix.md +1 -0
  83. package/.agent-src/commands/refine-ticket.md +1 -0
  84. package/.agent-src/commands/research/deep.md +1 -0
  85. package/.agent-src/commands/research/report.md +1 -0
  86. package/.agent-src/commands/research.md +1 -0
  87. package/.agent-src/commands/review-changes.md +1 -0
  88. package/.agent-src/commands/review-routing.md +1 -0
  89. package/.agent-src/commands/roadmap/ai-council.md +1 -0
  90. package/.agent-src/commands/roadmap/create.md +1 -0
  91. package/.agent-src/commands/roadmap/process-full.md +1 -0
  92. package/.agent-src/commands/roadmap/process-phase.md +1 -0
  93. package/.agent-src/commands/roadmap/process-step.md +1 -0
  94. package/.agent-src/commands/roadmap.md +1 -0
  95. package/.agent-src/commands/rule-compliance-audit.md +1 -0
  96. package/.agent-src/commands/set-cost-profile.md +1 -0
  97. package/.agent-src/commands/sync-agent-settings.md +1 -0
  98. package/.agent-src/commands/sync-gitignore/fix.md +1 -0
  99. package/.agent-src/commands/sync-gitignore.md +1 -0
  100. package/.agent-src/commands/tests/create.md +1 -0
  101. package/.agent-src/commands/tests/execute.md +1 -0
  102. package/.agent-src/commands/tests.md +1 -0
  103. package/.agent-src/commands/threat-model.md +1 -0
  104. package/.agent-src/commands/update-form-request-messages.md +1 -0
  105. package/.agent-src/commands/upstream-contribute.md +1 -0
  106. package/.agent-src/commands/work.md +1 -0
  107. package/.claude-plugin/marketplace.json +1 -1
  108. package/AGENTS.md +4 -4
  109. package/CHANGELOG.md +56 -2121
  110. package/README.md +58 -32
  111. package/config/gitignore-block.txt +5 -0
  112. package/docs/architecture/augment-projection.md +70 -0
  113. package/docs/architecture/claude-bundle.md +77 -0
  114. package/docs/architecture/compression.md +67 -0
  115. package/docs/architecture/multi-tool-projection.md +72 -0
  116. package/docs/architecture.md +30 -53
  117. package/docs/archive/CHANGELOG-pre-2.2.0.md +2138 -0
  118. package/docs/contracts/CHANGELOG-conventions.md +121 -0
  119. package/docs/contracts/command-surface-tiers.md +140 -0
  120. package/docs/contracts/mcp-cloud-scope.md +193 -21
  121. package/docs/contracts/mcp-phase-1-scope.md +1 -0
  122. package/docs/decisions/ADR-007-agent-discovery-scopes.md +67 -0
  123. package/docs/setup/enterprise-and-offline.md +201 -0
  124. package/docs/setup/per-ide/augment.md +37 -25
  125. package/package.json +1 -1
  126. package/scripts/_bootstrap_tier_frontmatter.py +151 -0
  127. package/scripts/agent-config +146 -83
  128. package/scripts/hermetic-install.sh +235 -0
  129. package/scripts/install.py +8 -1
  130. package/scripts/lint_command_tiers.py +115 -0
  131. package/scripts/mcp_server/__init__.py +5 -0
  132. package/scripts/schemas/command.schema.json +5 -0
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: prepare-for-review
3
+ tier: 1
3
4
  skills: [git-workflow, quality-tools]
4
5
  description: Prepare a PR branch for local review — updates main and merges the full branch chain so the branch is up to date
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: project-analyze
3
+ tier: 1
3
4
  skills: [project-analyzer]
4
5
  description: Full project analysis — detect stack, inventory modules, audit docs, create missing contexts
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: project-health
3
+ tier: 1
3
4
  skills: [quality-tools]
4
5
  description: Quick project health check — show status of docs, modules, contexts, and roadmaps without creating anything
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: quality-fix
3
+ tier: 1
3
4
  skills: [quality-tools]
4
5
  description: Run quality pipeline (PHP and/or JS/TS) and fix all errors — auto-detects language from changed files
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: refine-ticket
3
+ tier: 1
3
4
  skills: [refine-ticket]
4
5
  description: Refine a Jira/Linear ticket before planning — rewritten ticket + Top-5 risks + persona voices, orchestrates validate-feature-fit and threat-modeling, ends with a close-prompt
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: research:deep
3
+ tier: 2
3
4
  cluster: research
4
5
  sub: deep
5
6
  description: "Read `outline.yaml`, research each item in batches, write per-item JSON validated against the project-local research-schema. No Python runtime, no `~/.claude/` paths."
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: research:report
3
+ tier: 2
3
4
  cluster: research
4
5
  sub: report
5
6
  description: "Summarise per-item JSON results from `/research:deep` into `report.md`. Agent renders directly + emits an optional `jq` template for deterministic regeneration. No Python runtime."
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: research
3
+ tier: 2
3
4
  cluster: research
4
5
  description: "Preliminary research scaffolder — pick objects, define fields, emit `outline.yaml` + `fields.yaml` for downstream deep research. Use for surveys, benchmarks, tech selection, competitive scans."
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: review-changes
3
+ tier: 1
3
4
  skills: [code-review, subagent-orchestration, judge-bug-hunter, judge-security-auditor, judge-test-coverage, judge-code-quality, architecture-review-lens, git-workflow]
4
5
  description: Self-review local changes before creating a PR — dispatches to five specialized judges (bug, security, tests, quality, architecture) and consolidates verdicts
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: review-routing
3
+ tier: 2
3
4
  skills: [review-routing, reviewer-awareness]
4
5
  description: Compute reviewer roles and matched historical bug patterns for the current diff, using project-local ownership-map.yml and historical-bug-patterns.yml
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: roadmap:ai-council
3
+ tier: 2
3
4
  cluster: roadmap
4
5
  sub: ai-council
5
6
  skills: [ai-council, agent-docs-writing, roadmap-management]
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: roadmap:create
3
+ tier: 2
3
4
  cluster: roadmap
4
5
  sub: create
5
6
  skills: [agent-docs-writing]
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: roadmap:process-full
3
+ tier: 2
3
4
  cluster: roadmap
4
5
  sub: process-full
5
6
  skills: [agent-docs-writing, ai-council, roadmap-management]
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: roadmap:process-phase
3
+ tier: 2
3
4
  cluster: roadmap
4
5
  sub: process-phase
5
6
  skills: [agent-docs-writing, ai-council, roadmap-management]
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: roadmap:process-step
3
+ tier: 2
3
4
  cluster: roadmap
4
5
  sub: process-step
5
6
  skills: [agent-docs-writing, ai-council, roadmap-management]
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: roadmap
3
+ tier: 1
3
4
  description: Roadmap orchestrator — routes to create (authoring) and process-step / process-phase / process-full (autonomous execution).
4
5
  cluster: roadmap
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: rule-compliance-audit
3
+ tier: 1
3
4
  description: Audit rule trigger quality, simulate activation, detect overlaps, and find never-activating rules
4
5
  disable-model-invocation: true
5
6
  suggestion:
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: set-cost-profile
3
+ tier: 1
3
4
  description: Change the cost_profile in .agent-settings.yml — shows each profile's meaning and applies the selection
4
5
  skills: [file-editor]
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: sync-agent-settings
3
+ tier: 1
3
4
  description: Sync `.agent-settings.yml` against the current template + profile — adds new sections/keys, preserves user values, shows a diff before writing
4
5
  disable-model-invocation: true
5
6
  suggestion:
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: sync-gitignore:fix
3
+ tier: 2
3
4
  cluster: sync-gitignore
4
5
  sub: fix
5
6
  description: Scrub legacy pre-`/agents/` patterns from the consumer's .gitignore (inside or outside the managed block) and re-sync the canonical entries
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: sync-gitignore
3
+ tier: 1
3
4
  cluster: sync-gitignore
4
5
  description: Sync the `event4u/agent-config` block in the consumer project's .gitignore — adds missing entries, preserves user-added lines, shows a diff before writing
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: tests:create
3
+ tier: 2
3
4
  cluster: tests
4
5
  sub: create
5
6
  skills: [pest-testing]
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: tests:execute
3
+ tier: 2
3
4
  cluster: tests
4
5
  sub: execute
5
6
  skills: [pest-testing]
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: tests
3
+ tier: 2
3
4
  description: Tests orchestrator — routes to create, execute
4
5
  cluster: tests
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: threat-model
3
+ tier: 1
3
4
  skills: [threat-modeling, authz-review, security-sensitive-stop]
4
5
  description: Run a pre-implementation threat model on a proposed change — enumerates abuse cases, trust boundaries, and authorization gaps before the first line of code is written
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: update-form-request-messages
3
+ tier: 2
3
4
  skills: [laravel-validation]
4
5
  description: Sync the messages() method of a FormRequest class — add missing entries, link them to language keys, and clean up stale ones
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: upstream-contribute
3
+ tier: 1
3
4
  skills: [upstream-contribute, skill-writing, learning-to-rule-or-skill]
4
5
  description: Contribute a learning, skill, rule, or fix from a consumer project back to the shared agent-config package
5
6
  disable-model-invocation: true
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: work
3
+ tier: 0
3
4
  skills: [refine-prompt, command-routing]
4
5
  description: Drive a free-form prompt end-to-end through refine → score → plan → implement → test → verify → report — Option-A loop over the `work_engine` Python engine, confidence-band gated, no auto-git.
5
6
  disable-model-invocation: true
@@ -6,7 +6,7 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
9
- "version": "2.6.0",
9
+ "version": "2.7.0",
10
10
  "keywords": [
11
11
  "agent-config",
12
12
  "skills",
package/AGENTS.md CHANGED
@@ -18,16 +18,16 @@ task ci # full pipeline — green before PR
18
18
 
19
19
  - **Package self-orientation** (beta) — identity, four-wing cognition map, repo layout, tech stack, key-rules table, telemetry, command-suggester: [`docs/contracts/package-self-orientation.md`](docs/contracts/package-self-orientation.md).
20
20
  - **Kernel + Router** (beta) — 9 always-loaded Iron-Law rules, tier-1 / tier-2 routing, cost profiles, per-rule char caps enforced by `task lint-rule-budget`: [`kernel-membership`](docs/contracts/kernel-membership.md) + [`rule-router`](docs/contracts/rule-router.md).
21
- - **Multi-tool projection** — Augment, Claude Code, Cursor, Cline, Windsurf, Gemini CLI, Claude.ai bundle pipeline that ships from `.agent-src/` to consumer surfaces: [`docs/architecture.md`](docs/architecture.md#cloud-bundle-pipeline).
22
- - **Editing this repo** — Iron-Law rules (portability, source-of-truth, skill-quality) and the Thin-Root contract (caps · pointer-ratio · triage block) governing AGENTS.md: [`augment-portability`](.agent-src/rules/augment-portability.md), [`augment-source-of-truth`](.agent-src/rules/augment-source-of-truth.md), [`skill-quality`](.agent-src/rules/skill-quality.md), [`agents-md-thin-root`](.agent-src/skills/agents-md-thin-root/SKILL.md).
23
- - **Consumer story + architecture deep-dive** install story + ship pipeline: [`README.md`](README.md), [`docs/architecture.md`](docs/architecture.md).
21
+ - **Content pipelines** — A [compression](docs/architecture/compression.md), B [Augment projection](docs/architecture/augment-projection.md), C [multi-tool projection](docs/architecture/multi-tool-projection.md), D [Claude.ai bundle](docs/architecture/claude-bundle.md). Index: [`docs/architecture.md`](docs/architecture.md).
22
+ - **Editing this repo** — Iron-Law rules (portability, source-of-truth, skill-quality) + Thin-Root contract: [`augment-portability`](.agent-src/rules/augment-portability.md), [`augment-source-of-truth`](.agent-src/rules/augment-source-of-truth.md), [`skill-quality`](.agent-src/rules/skill-quality.md), [`agents-md-thin-root`](.agent-src/skills/agents-md-thin-root/SKILL.md).
23
+ - **Consumer story** — `npm install` + `scripts/install.sh` + `.agent-settings.yml` opt-in flags, sandbox/offline install paths, verified-offline manifest: [`README.md`](README.md).
24
24
  - **Personas** — 11 review-lens cast (6 core · 5 specialist), `personas:` vs `/mode` axes, citation map, override pattern: [`docs/personas.md`](docs/personas.md), schema [`docs/contracts/persona-schema.md`](docs/contracts/persona-schema.md) (beta).
25
25
 
26
26
  ## Emergency triage — read this when nothing else is reachable
27
27
 
28
28
  1. **What is this repo?** — `event4u/agent-config`, a governed skill / rule / command suite for AI coding tools (no application runtime).
29
29
  2. **What language?** — All `.md` content is English; agents mirror the user's language at runtime.
30
- 3. **Where do I edit?** — `.agent-src.uncompressed/` only. Never `.agent-src/`, `.augment/`, `.claude/`, `.cursor/`, `.clinerules/`, `.windsurfrules`.
30
+ 3. **Where do I edit?** — `.agent-src.uncompressed/` only. Never the generated trees.
31
31
  4. **Lint / test / sync entry point?** — `task ci` (full pipeline). Subsets: `task sync`, `task generate-tools`, `task lint-skills`, `task test`.
32
32
  5. **Where do the always-active rules live?** — `.agent-src/rules/` (kernel = 9 Iron-Law rules; tier-1 / tier-2 routed via `.agent-src/router.json`).
33
33