@event4u/agent-config 1.22.0 → 1.24.0

package/.agent-src/skills/script-writing/SKILL.md

@@ -0,0 +1,226 @@
+---
+name: script-writing
+description: "Use when adding or editing any script under `scripts/` — `--quiet` flag, `_lib/script_output` helpers, silent Taskfile wiring, Iron-Law carve-outs — even when you just say 'add a check script for X'."
+source: package
+---
+
+<!-- cloud_safe: degrade -->
+
+# script-writing
+
+## When to use
+
+* Creating a new Python script in `scripts/{name}.py` (linters, checks, generators, measure tools)
+* Editing an existing script that prints progress or success lines
+* Wiring a script into `Taskfile.yml` or `taskfiles/*.yml`
+* Reviewing a PR that adds scripts and asking "why does this still print on minimal?"
+
+Do NOT use this skill when:
+
+* The content is a one-off / archival under `scripts/ai_council/one_off_archive/` — those carry an `_one_off_` prefix and are exempt from the verbosity convention
+* The content is a shell entrypoint with secret prompts (install-keys, release confirms) → see § 3 Iron-Law carve-outs
+* The content is a `.mjs` / Node script under `scripts/cost/` — different runtime; convention covered in `agents/contexts/cost-tracking.md`
+
+## Script vs other writers — critical test
+
+| Intent | Artifact |
+|---|---|
+| "Maintenance script the agent or CI runs" | **This skill** |
+| "User types `/foo` to invoke" | `command-writing` |
+| "Constraint the agent must always honor" | `rule-writing` |
+| "Reference knowledge agents cite" | `guideline-writing` |
+
+Scripts orchestrate file checks, generators, and validators. They are
+neither user-invoked nor agent-routed — `task` and CI call them.
+
+## Procedure
+
+### 0. Run the Drafting Protocol
+
+Creating or materially rewriting a script that joins the linter / check
+family **must** go through Understand → Research → Draft from the
+[`artifact-drafting-protocol`](../../rules/artifact-drafting-protocol.md) rule.
+
+* **Understand** — what failure does this script catch that no existing
+  check catches? Is it a one-off (then archive it) or evergreen?
+* **Research** — `ls scripts/check_*.py scripts/lint_*.py`, grep for
+  overlap, skim 1–2 peer scripts (e.g. `lint_handoffs.py`,
+  `check_md_language.py`).
+* **Draft** — propose name + one-line purpose first. Only fill the body
+  after the shape is confirmed.
+
+### 1. `--quiet` flag — argparse + sys.argv fallback
+
+Every `check_*.py` / `lint_*.py` script MUST accept `--quiet` so the
+silent Taskfile layer (§ 4) can suppress success-only output.
+
+**With argparse (preferred):**
+
+```python
+parser = argparse.ArgumentParser(...)
+parser.add_argument("--quiet", action="store_true",
+                    help="Only print on failure")
+args = parser.parse_args()
+...
+if not args.quiet:
+    print("✅ All clean")
+```
+
+**Plain script (no argparse) fallback:**
+
+```python
+import sys
+
+QUIET = "--quiet" in sys.argv
+...
+if not QUIET:
+    print("✅ All clean")
+```
+
+Failure output (`❌`, non-zero exit) is **never** gated — failures must
+always print regardless of `--quiet`.
+
+### 2. `_lib/script_output` helpers — preferred for new scripts
+
+For anything richer than a single `✅`/`❌`, import the verbosity-aware
+router instead of raw `print()`:
+
+```python
+from _lib.script_output import info, success, warn, error, flush_summary
+
+info("Loading manifest")          # drops on silent + minimal
+success("Wrote 3 files")          # collected at minimal, printed at verbose
+warn("Skipping stale entry")      # stderr unless silent
+error("Manifest missing")         # stderr always
+
+flush_summary("Done — 3 entries") # one-line summary at minimal
+```
+
+Resolution order (first wins, cached for the process):
+
+1. `AGENT_SCRIPT_VERBOSITY` env (`silent` / `minimal` / `verbose`)
+2. `SCRIPT_OUTPUT_VERBOSE=1` alias (== `verbose`)
+3. `.agent-settings.yml` → `verbosity.script_output`
+4. Default `minimal`
+
+The resolved level is exported back into `AGENT_SCRIPT_VERBOSITY` so
+child processes inherit it. Tests reset via `reset_level()` from the
+same module — see `tests/test_script_output.py`.
+
+### 3. Iron-Law carve-outs — never silenced
+
+The following surfaces **MUST** use plain `print()` and never the
+helpers, so verbosity settings cannot suppress them:
+
+* Release confirms — every task in `taskfiles/release.yml`
+* Secret prompts — `install-anthropic-key`, `install-openai-key`,
+  `setup-evals`, `install-hooks` interactive sections
+* `runtime-e2e` and `test-triggers-live`
+* CI orchestration sentinels — `_ci-start`, `_ci-end`, root `ci`
+* Any prompt that asks the user for confirmation per
+  [`non-destructive-by-default`](../../rules/non-destructive-by-default.md) — Hard Floor cannot be silenced
+
+If unsure, check `scripts/ai_council/one_off_archive/2026-05/_one_off_silent_taskfiles.py`
+`CARVE_OUTS` for the canonical list.
+
+### 4. Taskfile wiring — `silent: true` + `{{.QUIET_FLAG}}`
+
+Every Taskfile task that wraps a `--quiet`-aware script MUST set
+`silent: true` and pass `{{.QUIET_FLAG}}` to the script:
+
+```yaml
+# Per-task in taskfiles/*.yml:
+tasks:
+  lint-handoffs:
+    silent: true
+    cmd: python3 scripts/lint_handoffs.py {{.QUIET_FLAG}}
+```
+
+The `QUIET_FLAG` var is defined once at the root of `Taskfile.yml`
+and resolves to `""` only when `AGENT_SCRIPT_VERBOSITY=verbose`:
+
+```yaml
+# Root Taskfile.yml — already in place, do not duplicate:
+vars:
+  QUIET_FLAG:
+    sh: '[ "$AGENT_SCRIPT_VERBOSITY" = "verbose" ] && echo "" || echo "--quiet"'
+```
+
+Carve-out tasks (release, install secrets, CI orchestration — see § 3)
+do **not** add `silent: true` and do **not** use `{{.QUIET_FLAG}}`.
+
+### 5. Validate
+
+* Run `python3 scripts/skill_linter.py .agent-src.uncompressed/skills/script-writing/SKILL.md` → 0 FAIL
+* Run `python3 scripts/{your-script}.py --quiet` and the verbose path — exit code 0 on clean, non-zero on failure regardless of flag
+* If the script uses `_lib/script_output`, add a test under `tests/` patterned on `tests/test_script_output.py` — assert `silent` / `minimal` / `verbose` behave per § 2
+* Run the full CI pipeline locally (see `Taskfile.yml` in this repo for the script list) — must exit 0 except for tolerated warnings
+
+## Output format
+
+1. Script file at `scripts/{name}.py` with `--quiet` accepted
+2. Taskfile wiring with `silent: true` + `{{.QUIET_FLAG}}` (unless carve-out)
+3. Test under `tests/` if `_lib/script_output` is used
+4. Linter output showing 0 FAIL
+
+## Gotchas
+
+* Forgetting `--quiet` — the silent Taskfile layer wraps the script and the call fails with `unrecognized arguments: --quiet`
+* Gating `❌` failures behind `--quiet` — failures must always print
+* Using raw `print()` for progress lines — drops on `minimal`, no inheritance
+* Adding `silent: true` to a release / install-keys task — bypasses the Hard Floor confirmation
+* Editing `Taskfile.yml`'s `QUIET_FLAG` var — single source of truth, do not duplicate
+* Forgetting that `from _lib.script_output import …` requires the script's resolution to walk up to `scripts/` — copy the `Path(__file__).resolve().parent` pattern from a peer
+
+## Frugality Standards
+
+Apply the [Frugality Charter](../../contexts/contracts/frugality-charter.md)
+to every script you author. Phase 10 of the charter (settings hooks
+row — `verbosity.script_output` / `verbosity.taskfile_command_echo`)
+is what this skill exists to teach.
+
+**Examples in this artifact:**
+- Per the charter's default-terse rule, success lines are gated behind
+  `--quiet` so the only thing visible at `minimal` is the end-of-run
+  summary or a failure.
+- Per the post-action summary suppression, scripts with multi-step
+  output collect via `success()` and emit one `flush_summary()` line.
+- Per the cheap-question check, scripts never prompt unless they hit
+  a Hard Floor surface (§ 3 carve-outs).
+
+**Pre-save self-check:**
+1. Does every `print("✅ ...")` line sit behind `--quiet` / the helper?
+2. Does the script add `silent: true` + `{{.QUIET_FLAG}}` to its
+   Taskfile entry (unless a carve-out)?
+3. Are failure lines (`❌`, exit non-zero) **never** gated by quiet?
+4. Are Iron-Law surfaces using plain `print()` and not the helper?
+
+## Do NOT
+
+* Do NOT gate `❌` / failure output behind `--quiet`
+* Do NOT use `_lib/script_output` for release confirms or secret prompts
+* Do NOT add `silent: true` to carve-out tasks
+* Do NOT hardcode `print()` for progress in new scripts — use `info()`
+* Do NOT skip the Taskfile wiring — without it the verbosity gates leak
+* Do NOT edit `.agent-src/`, `.augment/`, or `.claude/` projections
+
+## Cloud Behavior
+
+On cloud surfaces (Claude.ai Web, Skills API) the package's `task`
+runner and `_lib/script_output` are not reachable. The skill still
+applies — with prose-only validation:
+
+* Emit the full script + Taskfile snippet as copyable Markdown blocks. Do not attempt to write to disk.
+* Self-check: `--quiet` accepted, failures never gated, success lines gated, helper imports look syntactically right.
+* Tell the user to save under `scripts/{name}.py`, wire the Taskfile entry, and run `task lint-skills && task ci` locally before committing.
+* Skip every reference to running the linter or `task` commands yourself — they only run on the user's machine.
+
+## Examples
+
+Good description (trigger-shaped, names domain + symptoms):
+
+> "Use when adding or editing any script under `scripts/` — `--quiet` flag, `_lib/script_output` helpers, silent Taskfile wiring, Iron-Law carve-outs — even when you just say 'add a check script for X'."
+
+Bad description (vague, no trigger):
+
+> "Script conventions"

package/.agent-src/skills/skill-writing/SKILL.md

@@ -295,6 +295,29 @@ utility libs, or simple state managers.
 * Renaming a heading to "Procedure:" without numbered steps or `###` sub-headings
 * **Always run `python3 scripts/skill_linter.py` before saving — 0 FAIL required**
 
+## Frugality Standards
+
+Apply the [Frugality Charter](../../contexts/contracts/frugality-charter.md)
+to every skill you author.
+
+**Examples in this artifact:**
+- Per the charter's default-terse rule, the SKILL.md `## Procedure`
+  opens with the action ("Run the linter"), not "Let me walk you
+  through…".
+- Per the cheap-question check, only emit numbered-options output
+  when consequences differ — never as a stylistic choice.
+- Per the post-action summary suppression, the example output ships
+  the artifact, not a wrapping `## Status` / `## Summary` block.
+
+**Pre-save self-check:**
+1. Does any procedure step open with "Let me", "Now I will", "Found
+   it", "OK", or "Alright"?
+2. Does the skill prescribe numbered-options output without a real
+   consequence trade-off?
+3. Does the example output include a post-action summary block?
+4. Does the description carry filler ("comprehensive", "advanced",
+   "powerful")?
+
 ## Do NOT
 
 * Write documentation-style, pointer-only, or too-broad skills ("Laravel skill")

package/.agent-src/skills/test-driven-development/SKILL.md

@@ -27,6 +27,30 @@ Do NOT use when:
 * Catch edge cases **before** they become production bugs.
 * Leave every change with a regression test that runs in CI.
 
+## Escalate to a SPARC-style 5-phase workflow when
+
+Plain TDD (red → green → refactor) is the right size for **most** work.
+A small subset benefits from a gated 5-phase wrapper —
+**S**pec → **P**seudocode → **A**rchitecture → **R**efine → **C**omplete —
+where each gate produces a written artifact before the next phase runs.
+
+Decision tree — escalate if **any** branch is true:
+
+* The ticket has **AC count > 5** (the spec itself is non-trivial — write
+  it down before testing it).
+* The change **modifies a contract** consumed by ≥1 other module
+  (public API signature, persisted schema, event payload, queue message).
+* The change cuts across **≥3 modules / bounded contexts** at once.
+
+When escalating: drop the `Spec` artifact in `agents/roadmaps/` (or the
+project's planning location), capture it as an ADR via [`adr-create`](../adr-create/SKILL.md)
+when the decision is load-bearing, then run plain TDD inside each
+`Refine` cycle. Do **not** skip RED→GREEN inside a SPARC phase — the
+wrapper adds gates, not exemptions.
+
+For everything else (single-AC ticket, leaf-module change, bug fix),
+stay on plain TDD — the section above.
+
 ## The core discipline
 
 ```

package/.agent-src/skills/universal-project-analysis/SKILL.md

@@ -144,6 +144,14 @@ Check:
 * `performance-analysis`
 * `security-audit`
 
+### Ingestion preprocessor
+
+* `markitdown` — when the project ships PDFs, DOCX, XLSX, PPTX, EPUB,
+  images, or audio that need to feed into any of the analysis skills
+  above. Convert first via the upstream `markitdown-mcp` server, then
+  route the resulting Markdown into the relevant deep-dive skill.
+  Never read a binary office format raw.
+
 ## When to add a new framework analysis skill
 
 A framework gets its own `project-analysis-*` skill ONLY if:

package/.agent-src/templates/agent-settings.md

@@ -311,6 +311,69 @@ commands:
 # repo (gitignored). Maintainer-targeted feature; consumers leave it
 # off. See `.augment/contexts/contracts/artifact-engagement-flow.md`
 # (once Phase 3 of road-to-artifact-engagement-telemetry lands).
+# --- Verbosity (token frugality) ---
+#
+# Five toggles controlling what the agent shows after acting.
+# Default = terse. Flip to true to restore legacy verbose output.
+# See agents/roadmaps/road-to-token-frugality.md for the full rationale
+# and the contexts/contracts/frugality-charter.md for the writer-side
+# standard.
+verbosity:
+  # Show generated commit messages, PR titles/bodies, branch names
+  # before acting. false = use generated content directly.
+  preview_artifacts: false
+
+  # Confirmation prompts for routine workflow steps when there is
+  # one obvious answer ("looks good — commit?"). Iron-Law gates
+  # (commit-policy, scope-control git-ops, non-destructive) ALWAYS
+  # ask regardless of this flag.
+  routine_confirmations: false
+
+  # Offer "run AI Council on this?" inside delivery commands
+  # (/feature-plan, /review-changes, /roadmap-create). Council
+  # commands themselves (/council, /create-pr → already excluded)
+  # are unaffected.
+  offer_council_in_delivery: false
+
+  # Multi-line status / summary blocks after a successful action.
+  # off | minimal | full — default minimal (one-line confirmation).
+  post_action_reports: minimal
+
+  # Intent announcements ("Let me check…", "Now I will…", "Found
+  # it") in skill bodies. false = act and emit the result.
+  intent_announcements: false
+
+  # Script stdout chatter from `scripts/*.py`, `scripts/*.sh`, and
+  # `.augment/scripts/`. Read by the helper module
+  # `scripts/_lib/script_output.py`.
+  #   silent  = stderr only; success = no output
+  #   minimal = one summary line per script (default)
+  #   verbose = pre-Phase-10 behaviour (per-step prints)
+  # Override per-process: AGENT_SCRIPT_VERBOSITY={silent,minimal,verbose}
+  # Iron-Law surfaces (release confirms, install secrets prompts,
+  # error markers) ignore this key and stay loud.
+  script_output: minimal
+
+  # Suppress the `task: [name] cmd...` echo line that Taskfile prints
+  # before each task body. false = keep echoes (default Taskfile
+  # behaviour). true = the Taskfile sets `silent: true` on every
+  # safe task per Phase 10.3.
+  taskfile_command_echo: false
+
+# --- Caveman speak (authoring-only) ---
+#
+# Caveman-style compression scope for newly authored prose. The
+# compile-time toggle (`caveman.speak`) is added in Phase 8.
+# `speak_scope` lands now so the charter and consumers can pin it.
+caveman:
+  # speak_scope = how widely caveman-speak grammar applies in chat
+  #   off          = no caveman grammar in output (compile-time still
+  #                  governed by caveman.speak)
+  #   prose_only   = caveman in body prose; numbered options +
+  #                  Iron-Law-literal blocks stay full prose
+  #   aggressive   = caveman everywhere except Iron-Law literals
+  speak_scope: prose_only
+
 telemetry:
   artifact_engagement:
     # Master switch. `false` (default) produces zero file IO and zero
@@ -342,6 +405,10 @@ Personal and project-level settings (initial file written by
 **Key paths use dot-notation** to denote nesting: `personal.user_name`
 lives under `personal:` in YAML.
 
+The `verbosity.*` and `caveman.speak_scope` rows are summarized below;
+the canonical narrative lives in
+[`docs/customization.md` § Verbosity](../../docs/customization.md#verbosity).
+
 | Key path | Values | Default | Description |
 |---|---|---|---|
 | `cost_profile` | `minimal`, `balanced`, `full`, `custom` | `minimal` | Selects which agent surfaces are active. See [Cost profiles](#cost-profiles). |
@@ -386,6 +453,12 @@ lives under `personal:` in YAML.
 | `commands.suggestion.max_options` | integer | `4` | Max number of command suggestions before the always-present "run as-is" option (total rendered = `max_options + 1`). |
 | `commands.suggestion.blocklist` | list of command names | `[]` | Commands that never appear as a suggestion. They still work when typed explicitly. |
 | `commands.create_pr.preview_description` | `true`, `false` | `false` | When `false`: `/create-pr` skips the title/body preview + adjust loop and uses the generated content directly. Saves agent tokens. When `true`: show title and body before creating and ask for adjustments. `/create-pr:description-only` always previews regardless of this setting. |
+| `verbosity.preview_artifacts` | `true`, `false` | `false` | Show generated commit messages, PR titles/bodies, branch names before acting. `false` = use generated content directly. See [`road-to-token-frugality`](../../../agents/roadmaps/road-to-token-frugality.md) Phase 2/3. |
+| `verbosity.routine_confirmations` | `true`, `false` | `false` | Confirmation prompts for routine workflow steps when there is one obvious answer ("looks good — commit?"). Iron-Law gates (`commit-policy`, `scope-control` git-ops, `non-destructive-by-default`) ALWAYS ask regardless. |
+| `verbosity.offer_council_in_delivery` | `true`, `false` | `false` | Offer "run AI Council on this?" inside delivery commands (`/feature-plan`, `/review-changes`, `/roadmap-create`). Council commands themselves are unaffected. |
+| `verbosity.post_action_reports` | `off`, `minimal`, `full` | `minimal` | Multi-line status / summary blocks after a successful action. `off` = no report; `minimal` = one-line confirmation; `full` = bullet list. |
+| `verbosity.intent_announcements` | `true`, `false` | `false` | Intent announcements ("Let me check…", "Now I will…", "Found it") in skill bodies. `false` = act and emit the result. |
+| `caveman.speak_scope` | `off`, `prose_only`, `aggressive` | `prose_only` | How widely caveman-speak grammar applies in chat. `off` = no caveman grammar; `prose_only` = caveman in body prose, numbered options + Iron-Law-literal blocks stay full prose; `aggressive` = caveman everywhere except Iron-Law literals. Compile-time toggle (`caveman.speak`) lands in Phase 8. |
 | `telemetry.artifact_engagement.enabled` | `true`, `false` | `false` | Master switch for the artefact engagement log. Default-off; zero file IO and zero token cost when `false`. Maintainer-targeted; consumers leave it off. |
 | `telemetry.artifact_engagement.granularity` | `task`, `phase-step`, `tool-call` | `task` | Boundary at which events are recorded. `tool-call` is expensive — opt-in only. |
 | `telemetry.artifact_engagement.record.consulted` | `true`, `false` | `true` | When `true`: record artefacts loaded into context. |

package/.agent-src/templates/command.md

@@ -67,16 +67,21 @@ suggestion:
 
 ### N. Present findings
 
-<!-- For audit/analysis commands: always present findings before applying changes.
-     For action commands: show summary of what was done. -->
-
-Ask the user:
-
-```
-> 1. {Option 1}
-> 2. {Option 2}
-> 3. Skip — report only
-```
+<!-- For audit/analysis commands: state findings, then act or hand back.
+     For action commands: state what was done.
+
+     Default-terse per the
+     [Frugality Charter](../contexts/contracts/frugality-charter.md):
+     no preview-then-confirm pair, no "Ready to proceed?" gate, no
+     numbered options unless options differ in *consequence* (per
+     `no-cheap-questions § Pre-Send Self-Check`). Routine confirmations
+     are governed by `verbosity.routine_confirmations: false` (default).
+
+     Only emit a numbered-options block when ALL of:
+       1. Two or more options carry distinct consequences (not sequencing/format),
+       2. The user has not fenced the next step (per `scope-control § fenced step`),
+       3. No option violates `commit-policy`, `scope-control § git-ops`,
+          or `non-destructive-by-default`. -->
 
 ## Rules
 

package/.agent-src/templates/rule.md

@@ -85,6 +85,12 @@ routes_to:
 
 # {Rule Title}
 
+<!-- Default-terse per the
+  [Frugality Charter](../contexts/contracts/frugality-charter.md):
+  start with the obligation. No "This rule explains…" / "The purpose of
+  this rule is…" / narrative intro before the Iron Law. Body sections
+  are pointers, not playbooks — defer detail to skills/guidelines. -->
+
 **Iron Law.** {The single non-negotiable behavior the rule enforces.}
 
 ## When this fires

package/.agent-src/templates/skill.md

@@ -136,6 +136,38 @@ Do NOT use when:
 - Do NOT {anti-pattern 2}.
 - Do NOT {anti-pattern 3}.
 
+<!-- FRUGALITY STANDARDS (writer skills only — REQUIRED for skills whose
+  name ends in `-writing`, `-authoring`, or `-create`, AND for any
+  skill on the `FRUGALITY_WRITER_SKILLS` allowlist in
+  `scripts/skill_linter.py`. Mid-/untiered non-writer skills MUST
+  remove this section entirely.
+
+  Layer-1 of the linter checks for:
+    1. The literal H2 `## Frugality Standards`,
+    2. A markdown link matching the regex
+       `\[[^\]]+\]\([^)]*frugality-charter\.md[^)]*\)`.
+
+  Body shape — single charter cite, then 3–5 decidable pre-save
+  questions framed as *applying the charter*, not parallel rules
+  (council Pass #4 finding 0.B):
+
+  ## Frugality Standards
+
+  Per the [Frugality Charter](../../contexts/contracts/frugality-charter.md),
+  this writer applies the default-terse standard: no narrative intros,
+  no preview-then-confirm gates, no numbered options without a real
+  trade-off.
+
+  Pre-save self-check:
+  1. Does every body section start with the obligation, not an intro?
+  2. Are numbered options absent unless options differ in *consequence*?
+  3. Is every cited rule linked, not restated?
+  4. {artifact-specific question — e.g., for `command-writing`:
+     "Does the command honor `verbosity.routine_confirmations: false`?"}
+  5. {artifact-specific question — e.g., for `rule-writing`:
+     "Does the rule body open with the Iron Law, no preamble?"}
+-->
+
 <!-- SENIOR-TIER STUB BLOCKS (delete entire section if not `tier: senior`):
   Senior-tier skills (frontmatter `tier: senior`) require four extra
   blocks per `.agent-src.uncompressed/rules/skill-quality.md` §

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
-    "version": "1.22.0"
+    "version": "1.24.0"
   },
   "plugins": [
     {
@@ -15,6 +15,7 @@
       "source": "./",
       "strict": false,
       "skills": [
+        "./.claude/skills/adr-create",
         "./.claude/skills/adversarial-review",
         "./.claude/skills/agent-docs-writing",
         "./.claude/skills/agent-handoff",
@@ -38,13 +39,13 @@
         "./.claude/skills/bug-analyzer",
         "./.claude/skills/bug-fix",
         "./.claude/skills/bug-investigate",
+        "./.claude/skills/challenge-me",
+        "./.claude/skills/challenge-me-vision",
+        "./.claude/skills/challenge-me-with-docs",
         "./.claude/skills/chat-history",
         "./.claude/skills/chat-history-import",
         "./.claude/skills/chat-history-learn",
         "./.claude/skills/chat-history-show",
-        "./.claude/skills/challenge-me",
-        "./.claude/skills/challenge-me-vision",
-        "./.claude/skills/challenge-me-with-docs",
         "./.claude/skills/check-current-md",
         "./.claude/skills/check-refs",
         "./.claude/skills/code-refactoring",
@@ -66,6 +67,7 @@
         "./.claude/skills/copilot-agents-optimization",
         "./.claude/skills/copilot-agents-optimize",
         "./.claude/skills/copilot-config",
+        "./.claude/skills/cost-report",
         "./.claude/skills/council",
         "./.claude/skills/council-default",
         "./.claude/skills/council-design",
@@ -140,6 +142,7 @@
         "./.claude/skills/lint-skills",
         "./.claude/skills/livewire",
         "./.claude/skills/logging-monitoring",
+        "./.claude/skills/markitdown",
         "./.claude/skills/mcp",
         "./.claude/skills/md-language-check",
         "./.claude/skills/memory",
@@ -172,6 +175,7 @@
         "./.claude/skills/package-test",
         "./.claude/skills/performance",
         "./.claude/skills/performance-analysis",
+        "./.claude/skills/persona-writing",
         "./.claude/skills/pest-testing",
         "./.claude/skills/php-coder",
         "./.claude/skills/php-debugging",
@@ -211,9 +215,11 @@
         "./.claude/skills/roadmap-process-full",
         "./.claude/skills/roadmap-process-phase",
         "./.claude/skills/roadmap-process-step",
+        "./.claude/skills/roadmap-writing",
         "./.claude/skills/rtk-output-filtering",
         "./.claude/skills/rule-compliance-audit",
         "./.claude/skills/rule-writing",
+        "./.claude/skills/script-writing",
         "./.claude/skills/security",
         "./.claude/skills/security-audit",
         "./.claude/skills/sentry-integration",

package/AGENTS.md

@@ -80,6 +80,17 @@ No application code or framework runtime (no Laravel / Symfony / Next.js /
 Express). The `composer.json` / `package.json` are thin distribution
 manifests.
 
+**Recommended ingestion path for non-text formats.** PDF, DOCX, XLSX,
+PPTX, EPUB, image, and audio inputs route through the
+[`markitdown`](.agent-src/skills/markitdown/SKILL.md) skill — a thin
+markdown-only wrapper over Microsoft's MIT-licensed `markitdown-mcp`
+server (peer-side install, zero Python in this package). The skill
+ships the four-layer security defense (skill checklist · narrow API ·
+Docker read-only · localhost binding) and a calibrated token claim
+(3-5× comprehension on text-heavy, 10-50× on image-heavy). Measure
+locally with `python3 scripts/measure_markitdown_lift.py` against
+`tests/fixtures/markitdown-corpus/`.
+
 **Cognition-only floor for Wings 2–4.** Wings 2, 3, and 4 enforce a
 no-SaaS-auth, no-vendor-SDK, no-stage-prescription floor: cognition
 artifacts (markdown tables, scoring rubrics, walkthroughs) must work
@@ -167,9 +178,9 @@ appends to `agents/.rule-budget-history.jsonl`.
 
 ```
 .agent-src.uncompressed/      ← edit here
-  skills/       (136 skills)
-  rules/        (59 rules)
-  commands/     (102 commands)
+  skills/       (141 skills)
+  rules/        (60 rules)
+  commands/     (103 commands)
   personas/     (7 personas)
   templates/    (AGENTS.md, copilot-instructions.md, skill.md, …)
   contexts/

package/CHANGELOG.md

@@ -318,6 +318,67 @@ our recommendation order, not its support status.
   users" tension without removing any path that an existing user
   might rely on.
 
+## [1.24.0](https://github.com/event4u-app/agent-config/compare/1.23.0...1.24.0) (2026-05-08)
+
+### Features
+
+* **rules:** harden roadmap-progress-sync — real-time checkbox cadence ([bdaaf0c](https://github.com/event4u-app/agent-config/commit/bdaaf0caff6d312ab87aabc8d170793cbbc6513a))
+* **measurement:** markitdown lift benchmark + corpus ([e606c7a](https://github.com/event4u-app/agent-config/commit/e606c7afae9977ab3c19f2a7f99a6ec18b31b483))
+* **skill:** add markitdown skill with four-layer defense ([21514f4](https://github.com/event4u-app/agent-config/commit/21514f4bf8b77d00480fc5dfab54a1a04e34f4f1))
+
+### Bug Fixes
+
+* drop markitdown roadmap link + trim README to 500 lines ([da8240d](https://github.com/event4u-app/agent-config/commit/da8240d6fce74555d08a8bfb4f4d15379d10de54))
+* **refs:** update markitdown roadmap path to archive/ after archival ([f7679de](https://github.com/event4u-app/agent-config/commit/f7679debb851bd721f671e26fe962186e56a1e86))
+
+### Documentation
+
+* feature markitdown in README, AGENTS, architecture ([fa1babc](https://github.com/event4u-app/agent-config/commit/fa1babcb344c5f090aa4cea0eafb58e5732cf872))
+* cross-link markitdown from analysis and learning skills ([14f9d72](https://github.com/event4u-app/agent-config/commit/14f9d7290dbcb341d2ff97280dbfb54b32e39057))
+
+### Chores
+
+* **generate-tools:** refresh .windsurfrules after roadmap-progress-sync body expansion ([3fdba11](https://github.com/event4u-app/agent-config/commit/3fdba11cd4e91425a05ef9ad82b0e7c611180668))
+* **compress:** sync .agent-src/ with hardened roadmap-progress-sync rule ([30e7d1a](https://github.com/event4u-app/agent-config/commit/30e7d1ab455da823afbe7602f01d543d3fe91c5d))
+* **roadmap:** archive markitdown-adoption + refresh progress dashboard ([5481d90](https://github.com/event4u-app/agent-config/commit/5481d9025f4c85f33e11533099cf725eeb306455))
+* add skills-provenance registry for upstream attribution ([65c2eeb](https://github.com/event4u-app/agent-config/commit/65c2eeb3d1c9d0f86957757ce22221ed0e255292))
+* **roadmap:** harden process-full to ignore horizon markers ([36d0fa6](https://github.com/event4u-app/agent-config/commit/36d0fa6c263721618999b7fa27ddb9cb336dd6c2))
+
+## [1.23.0](https://github.com/event4u-app/agent-config/compare/1.22.0...1.23.0) (2026-05-08)
+
+### Features
+
+* **skills:** add script-writing skill for scripts/ conventions ([1f8655d](https://github.com/event4u-app/agent-config/commit/1f8655d6cbf007410e3846ab502eea5745a7f66f))
+* **scripts:** Phase 10.7 --quiet flag + silent Taskfile + caveman compile-time toggle ([1d319e6](https://github.com/event4u-app/agent-config/commit/1d319e61a3c782eb5c86075f34275306a67c621c))
+* **linter:** frugality charter writer-cite validator + writer skill citations ([0e34709](https://github.com/event4u-app/agent-config/commit/0e3470965d5e2f4a8b11f27137d4ba43d2471be2))
+* **verbosity:** add verbosity toggles + gate routine outputs ([580d4cc](https://github.com/event4u-app/agent-config/commit/580d4cc2d1f4d4b091b6128f0a29d1f7e619895d))
+* **roadmap-sync:** pre-commit backstop blocks stale dashboard ([c577fc0](https://github.com/event4u-app/agent-config/commit/c577fc0aabc13faaae64c88d20d8ca66338ae5fc))
+* **create-pr:** drop council-review prompt ([e694811](https://github.com/event4u-app/agent-config/commit/e694811f7ca06b3db275cc70e83e6dbc4db72e42))
+* cite SPARC escalation thresholds in test-driven-development ([836f2ed](https://github.com/event4u-app/agent-config/commit/836f2edc2c288bcc7f878e97f42de954add8bb5b))
+* add mcp-request-signing guideline with HTTP-bridge appendix ([2ab67cd](https://github.com/event4u-app/agent-config/commit/2ab67cd401333ea61f47d43e952e7b07958feff3))
+* add cost-report command with token cost tracking ([262d865](https://github.com/event4u-app/agent-config/commit/262d865072d613647a439e89f83ded7334b60b1b))
+* add adr-create skill with index regeneration script ([7225105](https://github.com/event4u-app/agent-config/commit/7225105797d6810cad75bfa851f02b100e41ba29))
+
+### Bug Fixes
+
+* **docs:** bump command counts to 103 after cost-report addition ([2810fa5](https://github.com/event4u-app/agent-config/commit/2810fa5a54b7099123ae65e6c7c1325430bf3b77))
+
+### Documentation
+
+* sync counts (139 skills, 60 rules) + meta cleanups ([00c8b21](https://github.com/event4u-app/agent-config/commit/00c8b211edbc86cbe2f886107227e6bd46049c3b))
+* codify defer-with-trigger harvest policy ([b30dcd7](https://github.com/event4u-app/agent-config/commit/b30dcd72d0ffbd1fb2dbdd8ca28493a5b05a6bed))
+
+### Refactoring
+
+* **rules:** apply trim-frugality-canon Phase 1-3 trims ([ea1828a](https://github.com/event4u-app/agent-config/commit/ea1828af7bc69426386f6852cb69891309dce65f))
+
+### Chores
+
+* regenerate stale generated mirrors ([ea52e94](https://github.com/event4u-app/agent-config/commit/ea52e94415c4db5598e91d001e0fbeee10cae9be))
+* regenerate auto-generated artefacts ([fbe7d9e](https://github.com/event4u-app/agent-config/commit/fbe7d9ef137c9e584d7f88ce660afe29ab1a8d00))
+* bump skill/command/guideline counts and compression hashes ([18f4fad](https://github.com/event4u-app/agent-config/commit/18f4fad2372fd4347210199986909319c24ea0ec))
+* archive ruflo-adoption, move caveman-integration to skipped ([4c6c1eb](https://github.com/event4u-app/agent-config/commit/4c6c1eb1e00356421e0038704a82e1f10ac9a3e5))
+
 ## [1.22.0](https://github.com/event4u-app/agent-config/compare/1.21.0...1.22.0) (2026-05-07)
 
 ### Features