@event4u/agent-config 1.23.0 → 1.25.0

package/.agent-src/commands/analyze-reference-repo.md

@@ -192,4 +192,7 @@ Never create the roadmap without explicit confirmation.
 - Skill: `project-analyzer` — base analysis workflow.
 - Skill: `learning-to-rule-or-skill` — turn adopt items into content.
 - Skill: `upstream-contribute` — push learnings back to this package.
+- Skill: `markitdown` — preferred ingestion path when the reference
+  ships PDFs, DOCX, XLSX, PPTX, EPUB, images, or audio. Never read a
+  binary office format raw — convert first, then analyze.
 - Roadmaps: `agents/roadmaps/` — consumers of findings (e.g. `archive/road-to-anthropic-alignment.md`).

package/.agent-src/commands/review-routing.md

@@ -1,6 +1,6 @@
 ---
 name: review-routing
-skills: [review-routing, reviewer-awareness, review-routing-awareness]
+skills: [review-routing, reviewer-awareness]
 description: Compute reviewer roles and matched historical bug patterns for the current diff, using project-local ownership-map.yml and historical-bug-patterns.yml
 disable-model-invocation: true
 suggestion:
@@ -18,10 +18,9 @@ reviewer roles plus any matched historical bug patterns — so the author
 knows *who* to request and *what* to test before opening a PR.
 
 Dispatches to [`review-routing`](../skills/review-routing/SKILL.md) for
-the core resolution logic. The rules
-[`reviewer-awareness`](../rules/reviewer-awareness.md) and
-[`review-routing-awareness`](../rules/review-routing-awareness.md) govern
-the output format and data handling.
+the core resolution logic. The rule
+[`reviewer-awareness`](../rules/reviewer-awareness.md) governs reviewer
+choice, routing, and data handling.
 
 ### 1. Gather the diff
 
@@ -73,7 +72,7 @@ After the block, ask:
 ```
 
 - On **1**: hand off to
-  [`create-pr-description`](../skills/create-pr-description/SKILL.md).
+  [`create-pr-description`](../skills/create-pr:description-only/SKILL.md).
 - On **2**: respect CODEOWNERS — request the *roles* resolved to people
   by the consumer's own mapping, never invent usernames.
 - On **3**: the user wants to curate the map first. Stop.
@@ -104,12 +103,10 @@ After the block, ask:
 ## See also
 
 - [`review-routing`](../skills/review-routing/SKILL.md) — the resolver
-- [`reviewer-awareness`](../rules/reviewer-awareness.md) — role vocabulary
-- [`review-routing-awareness`](../rules/review-routing-awareness.md) —
-  data-source rules
+- [`reviewer-awareness`](../rules/reviewer-awareness.md) — role vocabulary + data-source rules
 - [`review-routing-data-format`](../docs/guidelines/agent-infra/review-routing-data-format.md)
   — YAML schemas
-- [`create-pr-description`](../skills/create-pr-description/SKILL.md) —
+- [`create-pr-description`](../skills/create-pr:description-only/SKILL.md) —
   consumes the routing block
 - [`verify-before-complete`](../rules/verify-before-complete.md) —
   consumes the `required_test` list

package/.agent-src/commands/roadmap/process-full.md

@@ -28,7 +28,8 @@ with the **scope delta below**.
 ## Scope delta
 
 - **Working set:** every open step across every phase, in document
-  order.
+  order. **Horizon markers do not narrow the working set** — see
+  Iron Law below.
 - **Stop after:** the entire roadmap reaches `count_open == 0`, or a
   halt condition fires (Hard-Floor, council-off + ambiguity,
   security-sensitive, scope-out-of-roadmap, test/quality red).
@@ -40,10 +41,49 @@ with the **scope delta below**.
   archival check from
   [`roadmap-process-loop § 6`](../../contexts/execution/roadmap-process-loop.md#6-final-report-and-archival).
 
+## Iron Law — Full is Full
+
+```
+/roadmap:process-full PROCESSES EVERY OPEN STEP IN THE FILE.
+HORIZON MARKERS, "OUT-OF-HORIZON" LABELS, "GATED ON PHASE X"
+NOTES, AND PHASE-INTERNAL "OPTIONAL" TAGS DO NOT NARROW THE
+WORKING SET. ONLY THE FIVE HALT CONDITIONS STOP THE RUN.
+```
+
+Roadmaps frequently carry a "Horizon (N-week visible plate)" section
+or "(out-of-horizon, gated on Phase N)" sub-headings as an authoring
+device. Those are **archival annotations**, not execution gates.
+`/roadmap:process-full` ignores them by construction. If the user
+wants horizon-respecting execution, they invoke `/roadmap:process-phase`
+(scope = single phase) or `/roadmap:process-step` (scope = single
+step) instead.
+
+## Iron Law — Real-time dashboard
+
+```
+EVERY DONE STEP FLIPS [ ] → [x] BEFORE THE LOOP MOVES TO THE NEXT STEP.
+DASHBOARD REGENERATES IN THE SAME REPLY THAT FLIPPED THE BOX.
+NO BATCH FLIP AT THE ARCHIVE COMMIT. NO "I'LL DO IT AT THE END."
+```
+
+`/roadmap:process-full` is the worst offender for batching because it
+runs continuously across many steps. Flipping all 13 boxes in the
+single archive commit defeats the dashboard's purpose — the user
+loses progress visibility for the entire run. Per Iron Law 2 of
+[`roadmap-progress-sync`](../../rules/roadmap-progress-sync.md): the
+flip + regen pair is atomic with the step's work, executed inside
+[`roadmap-process-loop § 5`](../../contexts/execution/roadmap-process-loop.md#5-step-loop)
+step 5.
+
 ## Rules
 
 - **No silent acceleration past a halt.** Every halt condition stops
   the run; the user resumes on the next turn.
+- **No silent stop at a horizon marker.** Encountering "out-of-horizon",
+  "gated on Phase N", "deferred", or any equivalent annotation is
+  **not** a halt condition. Continue.
+- **No silent batch flip.** Each step's checkbox flips in the same
+  reply that lands its work — never deferred to the archive commit.
 - **Phase quality pipeline runs at every phase boundary** when cadence
   is `per_phase` or `per_step`. `end_of_roadmap` skips per-phase and
   runs only at the final archival check.

package/.agent-src/contexts/authority/kernel-rule-edits.md

@@ -0,0 +1,48 @@
+# Kernel-Rule Edits — Slow-Rollout Guarantee
+
+Loaded by [`scope-control`](../../rules/scope-control.md). Codifies the
+soak-time guarantee for edits to always-loaded (kernel) rules under
+`.agent-src.uncompressed/rules/`.
+
+**Size budget:** ≤ 1,500 chars.
+
+## The guarantee
+
+Each kernel-rule edit ships in **its own PR**, with **≥ 24 h between
+merges** of consecutive kernel-rule PRs. Autonomous mandate, roadmap
+authorization, and standing "just keep going" directives **do not lift
+this** — it is a behaviour-soak guarantee, not a governance preference.
+
+The 24 h window exists so that a regression introduced by the first
+edit (a rule that stops firing, an Iron Law that loses rhetorical
+weight, a trigger that swallows a sibling rule's domain) surfaces in
+real interactions before the second edit lands and confounds the
+diagnosis.
+
+## Trigger
+
+A PR is a "kernel-rule edit" iff it modifies any file in
+`.agent-src.uncompressed/rules/` that is in the locked kernel set
+(see [`docs/contracts/kernel-membership.md`](../../../docs/contracts/kernel-membership.md)).
+
+The CI guard (Phase 4.2 of the always-budget-relief roadmap) fails
+any PR that touches **> 1** kernel rule in the same diff. Override is
+a single PR label: `bundled-always-rules-acknowledged` — the maintainer
+records why the bundle is necessary in the PR body.
+
+## Out of scope
+
+- Auto-tier rules. Auto rules load on demand; the soak rationale does
+  not apply with the same force.
+- Context files cited by kernel rules. Context edits are reversible
+  cheaply and do not change rule firing surface.
+- Whitespace / typo / link fixes inside a single kernel rule. Same-rule
+  cosmetic edits are not subject to the 24 h window — they ship as a
+  normal PR.
+
+## Source
+
+- Roadmap Phase 4: always-budget-relief roadmap § Phase 4 (transient — see `agents/roadmaps/archive/`).
+- Lesson: PR #36 (2026-05-04) compressed the rollout schedule under
+  autonomous mandate; the slow-rollout note was deferred until this
+  ADR pass.

package/.agent-src/contexts/authority/scope-mechanics.md

@@ -58,6 +58,21 @@ Then present numbered options (`user-interaction`) with "stay on the
 current branch" as the default. The user decides. Do not branch
 first and explain later.
 
+## Branch-base inventory — ALWAYS before starting work
+
+Before the first commit on related work, scan: `git branch --show-current` (is this branch shaped for the task?), `gh pr list --state open --limit 10` (overlapping open PR?), `git branch --sort=-committerdate | head -10` (in-flight branch to extend?).
+
+A plausible base beyond the current branch exists → STOP and ask with numbered options:
+
+1. Branch off the **current branch** — stacked PR.
+2. Branch off **`main`** — independent PR.
+3. **Continue on the current branch** — extend the in-flight PR.
+4. **Cancel**.
+
+User decides. Default: **3** when the current branch's name and scope match the task; otherwise **2**. Never improvise the base.
+
+**Failure mode — diverging stacked PRs.** Skipping the inventory and committing to the wrong base creates two PRs that should have been one stack: merge conflicts when the parent lands, rebase / force-push churn, duplicate review effort. The 30-second inventory cost up front beats hours of rebase reconciliation later.
+
 ## Decline = silence — context
 
 The right moment to ask is **before** the work starts (writing the

package/.agent-src/contexts/contracts/consumer-agents-md-guide.md

@@ -0,0 +1,127 @@
+# Consumer `AGENTS.md` — fill-out guide
+
+> Outboard target for the placeholder sections that used to live verbatim
+> in the consumer-template `AGENTS.md`. The template is now Thin-Root; this
+> guide carries the prose / examples / `<!-- … -->` hints that the
+> consumer copies in only when they need them.
+
+After installing `event4u/agent-config`, the consumer project gets:
+
+- `AGENTS.md` at project root — Thin-Root, points here.
+- `.augment/`, `.agent-src/`, `.claude/`, `.cursor/`, `.clinerules/`,
+  `.windsurfrules` — installed artifacts, never hand-edited.
+- `agents/` — project docs / roadmaps / sessions / overrides.
+- `.agent-settings.yml` — project config consumed by skills.
+
+## Recommended `AGENTS.md` shape
+
+The installed Thin-Root carries: project name + description, layer table,
+five-question emergency triage block, pointers to this guide. Copy any of
+the sections below into AGENTS.md only when the project actually needs
+the content there (e.g. an unusual stack note that no `agents/` doc
+covers). Default: leave AGENTS.md thin and put detail under `agents/`.
+
+## Tech-stack section (optional copy-in)
+
+```markdown
+## Tech Stack
+
+- **Language:** {{primary_language}}
+- **Framework:** {{framework}}        # Laravel 11 / Next.js 15 / Rails 7 / Django 5
+- **Database:** {{database}}          # PostgreSQL / MySQL / MariaDB / SQLite
+- **Testing:** {{test_framework}}     # Pest / PHPUnit / Jest / Vitest / pytest
+- **Code style:** {{code_style_tool}} # ECS / PHPStan / Ruff / ESLint
+```
+
+## Development-setup section (optional copy-in)
+
+```markdown
+## Development Setup
+
+​```bash
+{{dev_start_command}}    # make start / docker compose up / npm run dev / php artisan serve
+{{dev_test_command}}     # make test / docker compose exec app bash / npm test / php artisan test
+​```
+
+### Environment files
+
+| File | Purpose |
+|---|---|
+| `.env` | Main environment |
+| `.env.local` | Local overrides |
+| `.env.testing` | Testing environment |
+```
+
+## Project-structure section (optional copy-in)
+
+```markdown
+## Project Structure
+
+{{project_structure_notes}}   # Where new features go, module/component
+                              # boundaries, namespace conventions.
+```
+
+## Testing section (optional copy-in)
+
+```markdown
+## Testing
+
+{{testing_notes}}             # Framework quirks, how to run all/targeted
+                              # tests, test data strategy (seeders /
+                              # factories / fixtures), performance-critical
+                              # suites.
+```
+
+## Quality-tools section (optional copy-in)
+
+```markdown
+## Quality Tools
+
+{{quality_tools_notes}}       # Which linters/formatters run, whether
+                              # they auto-fix or report only, CI
+                              # enforcement level.
+```
+
+## Recommended entry flow
+
+Two entrypoints share the same engine and Option-A loop; pick by input shape:
+
+| You have | Command | Envelope |
+|---|---|---|
+| Ticket id, URL, or pasted ticket payload | [`/implement-ticket`](.augment/commands/implement-ticket.md) | `input.kind="ticket"` |
+| Free-form goal, no ticket | [`/work`](.augment/commands/work.md) | `input.kind="prompt"` |
+
+Both drive the linear flow `refine → memory → analyze → plan → implement
+→ test → verify → report` with block-on-ambiguity semantics and no
+auto-git.
+
+`/work` adds a confidence-band gate at `refine`: the
+[`refine-prompt`](.augment/skills/refine-prompt/SKILL.md) skill scores
+the prompt on five dimensions and the engine proceeds **silently** on
+`high`, halts with an **assumptions report** on `medium`, or halts with
+**one clarifying question** on `low` (per the `ask-when-uncertain` Iron
+Law). UI-shaped prompts route through the product UI track (`directive_set`
+`ui` / `ui-trivial` / `mixed`) — `audit → design → apply → review →
+polish` with a hard audit gate before any `apply`.
+
+Persona comes from `.agent-settings.yml` (`roles.active_role`). Use
+`/commit` and `/create-pr` explicitly after the delivery report. The
+two flows are mutually exclusive at the state-file level: one
+`.work-state.json` carries one envelope at a time; the engine refuses to
+switch mid-flight.
+
+## Multi-agent support
+
+| Tool | Rules | Skills | How |
+|---|---|---|---|
+| **Augment Code** | `.augment/rules/` | `.augment/skills/` | Native (source) |
+| **Claude Code** | `.claude/rules/` | `.claude/skills/` | Symlinks + Agent Skills standard |
+| **Cursor** | `.cursor/rules/` | — | Symlinks |
+| **Cline** | `.clinerules/` | — | Symlinks |
+| **Windsurf** | `.windsurfrules` | — | Concatenated file |
+| **Gemini CLI** | `GEMINI.md` | — | Symlink → AGENTS.md |
+
+Reinstall agent-config: `composer update event4u/agent-config` (PHP) or
+`npm update @event4u/agent-config` (JS). Don't run package-internal
+`task` commands from a consumer project; they only work in the
+agent-config repo itself.

package/.agent-src/contexts/contracts/emergency-triage-block.md

@@ -0,0 +1,53 @@
+# Emergency Triage Block — canonical source
+
+> Canonical content of the **Emergency Triage** block referenced by the
+> `agents-md-thin-root` skill. Both the package-root `AGENTS.md` and
+> `.agent-src.uncompressed/templates/AGENTS.md` (consumer template)
+> embed this block verbatim. Drift is caught by the `lint-agents-md`
+> task in the package's CI pipeline.
+
+The block exists so a host agent can answer five basic questions from
+the root file alone when network access, context-engine retrieval, or
+linked-file fetches are degraded. Each answer fits on one line.
+
+## Package-root variant
+
+Use this variant in `AGENTS.md` at the package root.
+
+```
+## Emergency triage — read this when nothing else is reachable
+
+1. **What is this repo?** — `event4u/agent-config`, a governed skill / rule / command suite for AI coding tools (no application runtime).
+2. **What language?** — All `.md` content is English; agents mirror the user's language at runtime.
+3. **Where do I edit?** — `.agent-src.uncompressed/` only. Never `.agent-src/`, `.augment/`, `.claude/`, `.cursor/`, `.clinerules/`, `.windsurfrules`.
+4. **Lint / test / sync entry point?** — `task ci` (full pipeline). Subsets: `task sync`, `task generate-tools`, `task lint-skills`, `task test`.
+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`).
+```
+
+## Consumer-template variant
+
+Use this variant in `.agent-src.uncompressed/templates/AGENTS.md`. The
+consumer's `AGENTS.md` lands at the consumer-project root after install.
+
+```
+## Emergency triage — read this when nothing else is reachable
+
+1. **What is this repo?** — Consumer project; agent-config is installed as a shared skill / rule / command suite at `.augment/` and `.agent-src/`.
+2. **What language?** — Project-specific; agents mirror the user's language at runtime.
+3. **Where do I edit agent-config?** — Do not edit `.augment/` or `.agent-src/` here; they are installed artifacts. Project edits live in `agents/` and project source.
+4. **Lint / test / sync entry point?** — Project-specific (see project README); agent-config itself reinstalls via `composer update event4u/agent-config` or `npm update @event4u/agent-config`.
+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`).
+```
+
+## Why two variants
+
+The package-root and the consumer template answer the same five
+questions but in different repos:
+
+- The package-root variant points at this repo's authoring layer
+  (`.agent-src.uncompressed/`) and the package's CI entry point.
+- The consumer variant tells the agent it is in a **consumer** project
+  where `.augment/` is an installed artifact and editing it is wrong.
+
+The questions stay identical so a host agent can recognise the block
+visually regardless of which repo it landed in.

package/.agent-src/contexts/execution/roadmap-process-loop.md

@@ -86,10 +86,17 @@ For each open step in the working set (scope-bound — see wrapper):
    - **Council on** → invoke per [`ai-council`](../../skills/ai-council/SKILL.md),
      integrate convergence, proceed. Token spend was opted in.
    - **Council off** → halt, surface once, wait. Resume on next turn.
-5. Mark the checkbox: `[x]` done · `[~]` partial · `[-]` skipped.
-6. Regenerate the dashboard — `./agent-config roadmap:progress` — in
-   the **same response** per [`roadmap-progress-sync`](../../rules/roadmap-progress-sync.md).
-7. Run quality pipeline if cadence is `per_step`.
+5. **Atomic flip + regen** — before moving to step N+1, in the **same
+   reply** that landed step N's work:
+   1. Flip the checkbox in `agents/roadmaps/<file>.md`: `[x]` done ·
+      `[~]` partial · `[-]` skipped.
+   2. Run `./agent-config roadmap:progress` to regenerate the
+      dashboard.
+   This pair is **non-skippable** and **non-batchable** per Iron Law 2
+   of [`roadmap-progress-sync`](../../rules/roadmap-progress-sync.md). A
+   loop iteration that lands work without flipping its box is a rule
+   violation. Do not save flips for the archive commit.
+6. Run quality pipeline if cadence is `per_step`.
 
 ### Halt conditions
 
@@ -101,6 +108,20 @@ For each open step in the working set (scope-bound — see wrapper):
 
 On halt: stop, surface state, do **not** auto-fix outside the failing step.
 
+### Non-halt — horizon markers, gating notes, "optional" tags
+
+The following are **authoring annotations**, never halt conditions. Do
+**not** stop execution when the roadmap text contains them:
+
+- `Horizon (N-week visible plate)` section headers
+- `(out-of-horizon, gated on Phase N)` phase-header suffixes
+- `(deferred)` / `(later)` / `(optional)` tags on a step
+- "Gate: Phase 1 ships and …" prose inside an out-of-horizon phase
+
+`process-step` and `process-phase` honor scope by stopping at their
+configured boundary anyway. `process-full` is **defined by** ignoring
+these markers — see [`/roadmap:process-full § Iron Law`](../../commands/roadmap/process-full.md#iron-law--full-is-full).
+
 ## 6. Final report and archival
 
 - Summary: scope-bound (steps/phases done in this run), council
@@ -118,8 +139,10 @@ On halt: stop, surface state, do **not** auto-fix outside the failing step.
 |---|---|---|
 | `process-step` | Single first open step | One iteration of § 5 |
 | `process-phase` | All open steps in first phase with `count_open > 0` | Phase boundary; per-phase quality if cadence ≠ `end_of_roadmap` |
-| `process-full` | Every open step across every phase, in order | Roadmap fully closed (or halt) |
+| `process-full` | Every open step across every phase, in order — **horizon markers do not narrow this set** | Roadmap fully closed (or halt) |
 
 `process-full` runs the per-phase quality pipeline at every phase
 boundary when cadence is `per_phase` or `per_step`; on red it halts
-before the next phase.
+before the next phase. It does **not** stop at horizon markers,
+"out-of-horizon" labels, or "gated on Phase N" notes — those are
+archival annotations, not halt conditions.

package/.agent-src/rules/analysis-skill-routing.md

@@ -1,5 +1,5 @@
 ---
-type: "auto"
+type: "manual"
 tier: "3"
 description: "When choosing an analysis skill, route to the narrowest matching skill instead of defaulting to broad analysis"
 source: package

package/.agent-src/rules/artifact-drafting-protocol.md

@@ -2,7 +2,7 @@
 type: "auto"
 tier: "2a"
 alwaysApply: false
-description: "Creating a new skill, rule, command, or guideline, or significantly rewriting one — runs a mandatory Understand → Research → Draft sequence before any artifact content is written."
+description: "Creating a new skill, rule, command, or guideline, or significantly rewriting one — runs mandatory Understand → Research → Draft before drafting"
 source: package
 triggers:
   - intent: "create new skill"

package/.agent-src/rules/artifact-engagement-recording.md

@@ -2,7 +2,7 @@
 type: "auto"
 tier: "mechanical-already"
 alwaysApply: false
-description: "After a /implement-ticket or /work phase-step (refine/memory/analyze/plan/implement/test/verify/report) or full task — emit one telemetry:record call with consulted+applied ids when enabled"
+description: "After a /implement-ticket or /work phase-step (refine/memory/analyze/plan/implement/test/verify/report) or full task — emit one telemetry:record call"
 source: package
 triggers:
   - phrase: "/implement-ticket"

package/.agent-src/rules/augment-source-of-truth.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "1"
-description: "Creating, editing, or modifying files inside .agent-src/ or .augment/ — the source of truth is .agent-src.uncompressed/, never edit the generated directories directly"
+description: "Creating, editing, or modifying files in .agent-src/ or .augment/ — source of truth is .agent-src.uncompressed/, never edit generated dirs directly"
 source: package
 load_context:
   - ../contexts/communication/rules-auto/augment-source-of-truth-mechanics.md

package/.agent-src/rules/autonomous-execution.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "3"
-description: "Deciding whether to ask the user or just act on a workflow step — trivial-vs-blocking classification, autonomy opt-in detection, commit default; defers to non-destructive-by-default for the Hard Floor"
+description: "Whether to ask or act on a workflow step — trivial-vs-blocking, autonomy opt-in, commit default; Hard Floor in non-destructive-by-default"
 alwaysApply: false
 source: package
 load_context:

package/.agent-src/rules/caveman-speak.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "1"
-description: "When caveman.speak_scope != off — compress reply prose to caveman grammar with byte-for-byte carve-outs for numbered options, Iron-Law literals, code, paths, and error markers."
+description: "When caveman.speak_scope != off — compress reply prose to caveman grammar with carve-outs for numbered options, Iron-Law, code, paths, error markers"
 source: package
 triggers:
   - intent: "any reply"

package/.agent-src/rules/cli-output-handling.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "2a"
-description: "Running CLI commands that produce verbose output — git, tests, linters, docker, build tools, artisan, npm, composer. Wrap with rtk when installed; tail/grep is fallback."
+description: "Running CLI commands that produce verbose output — git, tests, linters, docker, build tools, artisan, npm, composer. Wrap with rtk; tail/grep fallback"
 source: package
 triggers:
   - keyword: "git"

package/.agent-src/rules/command-suggestion-policy.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "mechanical-already"
-description: "User prompt without /command but matching an eligible slash command — surface matches as numbered options with as-is escape hatch; never auto-executes, user always picks"
+description: "User prompt without /command matching an eligible slash command — surface matches as numbered options with as-is escape; never auto-executes"
 source: package
 triggers:
   - phrase: "free-form prompt"

package/.agent-src/rules/docs-sync.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "2a"
-description: "Keeping .augment/ contexts, counts, and cross-references in sync when creating, renaming, or deleting skills, commands, rules, guidelines, templates, or any agent infrastructure files"
+description: "Keeping .augment/ contexts, counts, cross-references in sync when creating, renaming, or deleting skills, rules, commands, templates, agent infra"
 source: package
 triggers:
   - path_prefix: ".agent-src.uncompressed/"

package/.agent-src/rules/guidelines.md

@@ -1,5 +1,5 @@
 ---
-type: "auto"
+type: "manual"
 tier: "3"
 description: "Writing or reviewing code — check relevant guideline before writing or reviewing code"
 alwaysApply: false

package/.agent-src/rules/improve-before-implement.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "2b"
-description: "Before implementing features or architectural changes — validate the request against existing code, challenge weak requirements, and suggest improvements"
+description: "Before implementing features or architectural changes — validate the request against existing code, challenge weak requirements, suggest improvements"
 alwaysApply: false
 source: package
 council_depth: deep

package/.agent-src/rules/invite-challenge.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "2b"
-description: "Before executing a complex plan or non-trivial design — proactively ask 'am I solving the right problem?' and pause for user confirmation, even when no ambiguity is detected"
+description: "Before executing a complex plan or non-trivial design — ask 'am I solving the right problem?' and pause for user confirmation, even when no ambiguity"
 alwaysApply: false
 source: package
 council_depth: deep

package/.agent-src/rules/minimal-safe-diff.md

@@ -2,7 +2,7 @@
 type: "auto"
 tier: "2a"
 alwaysApply: false
-description: "When writing or reviewing a diff — the smallest change that solves the stated problem; no drive-by edits, no opportunistic refactors, no reformatting of untouched code"
+description: "When writing or reviewing a diff — the smallest change that solves the stated problem; no drive-by edits, opportunistic refactors, or reformatting"
 source: package
 triggers:
   - intent: "writing a diff"

package/.agent-src/rules/model-recommendation.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "2a"
-description: "Starting a new task, switching task type, or invoking a command — detect task complexity and recommend the optimal model (Opus/Sonnet/GPT) before any work"
+description: "Starting a new task, switching task type, or invoking a command — detect complexity and recommend optimal model (Opus/Sonnet/GPT) before work"
 source: package
 triggers:
   - phrase: "switch task"

package/.agent-src/rules/no-attribution-footers.md

@@ -2,7 +2,7 @@
 type: "auto"
 tier: "3"
 alwaysApply: false
-description: "Generating PR/issue/comment/commit-message bodies — forbids unsolicited 'Generated with', 'Co-authored by', or 'Pull Request opened by' attribution footers in any user-owned artifact"
+description: "Generating PR/issue/comment/commit-message bodies — forbids 'Generated with', 'Co-authored by', or 'Pull Request opened by' attribution footers"
 source: package
 triggers:
   - intent: "PR body"