holycodex 0.16.4-dev.78.1 → 0.16.4

package/dist/assets/plugin/plugin.json

@@ -26,7 +26,7 @@
       "Code Intelligence"
     ],
     "defaultPrompt": [
-      "Activate HolyCodex capabilities for this task."
+      "Activate HolyCodex for this task. Read the generated Root developer instructions and repository AGENTS.md, apply installed skills as branch procedures, and use holycodex-agent semantic operations for durable Intent, Plan, and Assignment state."
     ]
   }
 }

package/dist/assets/plugin/skills/code-review/SKILL.md

@@ -1,9 +1,28 @@
 ---
 name: code-review
-description: Use after implementation when Root needs adversarial code review and bounded repair to a fixed point.
+description: Use once after code or manifest implementation when Root needs adversarial review and bounded repair to a fixed point.
 ---
 
-Inspect the integrated implementation for correctness, safety, maintainability,
-compatibility, and mergeability. Check callers, contracts, tests, and generated
-artifacts. Repair defects inside the review surface. Flag implementation-detail
-tests and speculative abstractions when they affect the assigned change.
+Owner: Reviewer within one delegated Assignment. Root must dispatch this skill
+after implementation or manifest work and record its structured result through
+`holycodex-agent assignment result`; the Reviewer never owns global lifecycle,
+material decisions, or Git/VCS. Inspect the actual integrated result to a
+fixed point before Root judges readiness. Apply
+[testing quality](../testing-quality.md) when judging new or modified tests.
+
+Read the Assignment and current Intent through the semantic agent interface;
+do not edit TOON files manually.
+
+This fixed-point review is mandatory after implementation or a major codebase
+change and must pass before Intent completion or any VCS operation. Apply the
+repository surgical-mutation rule from `AGENTS.md` to reviewer repairs.
+
+Inspect the assigned diff, callers, contracts, tests, compatibility, and
+artifact. Repair defects inside the review surface, verify each repair, and
+repeat until the review reaches a fixed point.
+
+Return `completed`, `blocked`, `needs_root_input`, or `failed` with findings,
+repaired paths, verification, and residual risk. Flag speculative
+abstractions, pointless file splits, oversized changes,
+unclear dependency direction, and tests that protect implementation detail.
+Confirm incidental generated output is absent before stopping.

package/dist/assets/plugin/skills/code-review/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Code review"
   short_description: "Review one implementation result to a fixed point."
-  default_prompt: "Open the code review workflow for this invocation."
+  default_prompt: "After implementation, inspect the delegated Assignment result once, apply the repository surgical-mutation rule, repair reviewer-owned defects to a fixed point, and return structured evidence for Root's readiness judgment."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/commit/SKILL.md

@@ -3,15 +3,21 @@ name: commit
 description: Use when Root owns a local commit after exact scope and proof are settled; verify scope, create the minimal commit, and report identity.
 ---
 
-Root uses this workflow after exact scope and local proof are settled. Verify
-the diff, generated-artifact cleanup, ignore coverage, and staged secret
-exclusions before creating the local commit.
+Owner: Root. This is the only unconditional direct execution exception:
+perform all Git/VCS inspection and mutation. Verify the exact diff scope,
+required local proof, temporary/generated-artifact cleanup, and ignore coverage
+before staging. Preserve unrelated work and ensure environment secrets,
+credentials, and private release material are absent from the staged file list.
+Do not use this exception for implementation, testing, review, or release
+verification; delegate those as Assignments and persist their outcomes through
+`holycodex-agent assignment result`.
 
 Require a passing Reviewer.code fixed-point result after implementation or a
-major codebase change before this VCS exception is used.
+major codebase change before this VCS exception is used. Apply the repository
+surgical-mutation rule to VCS operations and staging.
 
-After integration, Root commits the exact approved ref and gives its exact ref
-and SHA to `Worker.operations` for terminal CI observation.
+After integration, Root commits/pushes the exact approved ref, then delegates
+terminal CI observation to `Worker.operations` with the exact ref and SHA.
 Discover the repository's actual development/release topology first; never
 assume GitHub, branch names, or that pending is success. Delegate fixes for
 failures, then repeat integration, commit, push, and observation until the

package/dist/assets/plugin/skills/commit/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Commit"
   short_description: "Create one local commit with exact scope proof."
-  default_prompt: "Open the commit workflow for this invocation."
+  default_prompt: "When Root uses the Git/VCS direct exception, apply the repository surgical-mutation rule, verify exact scope, required proof, ignore coverage, and secret exclusions, create only that commit, ask for approval before remote mutation, and delegate terminal exact-ref verification."
 policy:
   allow_implicit_invocation: false

package/dist/assets/plugin/skills/compress/SKILL.md

@@ -1,8 +1,19 @@
 ---
 name: compress
-description: Use when assigned text must be shortened without changing its contract or voice.
+description: Use when Root assigns text that must be shortened; preserve meaning, constraints, technical terms, and voice.
 ---
 
-Shorten only the assigned text. Preserve meaning, constraints, technical terms,
-product voice, and required evidence. The result is complete when it is
-constraint-equivalent and any ambiguity that cannot be preserved is explicit.
+Owner: Worker within one delegated Assignment. Boundary: remove repetition
+without changing requirements, technical terms, product voice, or required
+evidence. Read the Assignment through the semantic agent interface; do not edit
+TOON files manually.
+
+Apply the repository surgical-mutation rule from `AGENTS.md`; preserve
+unrelated work and stop for Root input before expanding scope.
+
+Completion: the compressed text is constraint-equivalent to the input and any
+unresolvable ambiguity is explicit. Return one outcome from `completed`,
+`blocked`, `needs_root_input`, or `failed` with changed paths, proof, and
+remaining risk. Root records the result through `holycodex-agent assignment
+result`; the Worker does not mutate global Intent lifecycle, make material
+decisions, or perform Git/VCS.

package/dist/assets/plugin/skills/compress/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Compress"
   short_description: "Shorten assigned text without changing its contract or voice."
-  default_prompt: "Open the compression workflow for this invocation."
+  default_prompt: "When Root assigns a bounded compression Assignment, apply the repository surgical-mutation rule, produce one constraint-equivalent draft, and return completed, blocked, needs_root_input, or failed evidence for holycodex-agent."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/context7-cli/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: context7-cli
-description: Use when a current library, framework, SDK, or API fact needs authoritative documentation.
+description: Use first when Root assigns a current library, framework, SDK, or API fact; use a network research route only for releases, dates, gaps, or corroboration.
 ---
 
-Use current authoritative documentation before relying on memory. Return the
-requested versions, behavior, dates, conflicts, and coverage limits with
-source locators. Do not turn an external fact into an architecture decision.
+Use the current documentation route before relying on memory, because APIs
+and tool behavior change and repository evidence cannot establish currency.
+
+Owner: Librarian for research; Worker may use the assigned result. Boundary:
+gather sourced claims, versions, dates, conflicts, and coverage limits without
+editing the repository or deciding architecture.
+
+Completion: every requested current fact has an authoritative locator or an
+explicit coverage gap, and no unsupported external claim is used as proof.

package/dist/assets/plugin/skills/context7-cli/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Context7 CLI"
   short_description: "Find assigned current library and API documentation first."
-  default_prompt: "Open the current documentation lookup workflow for this invocation."
+  default_prompt: "When Root assigns a current library or API fact, use the documentation route first and return sourced evidence with coverage limits."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/debugging/SKILL.md

@@ -1,8 +1,27 @@
 ---
 name: debugging
-description: Use for a reproducible crash, wrong result, regression, hang, race, leak, or slowdown.
+description: Use when Root assigns a reproducible crash, wrong result, regression, hang, race, leak, or slowdown; isolate and prove the narrow repair.
 ---
 
-Reproduce the defect before changing code. Capture the smallest failing input
-and trace, identify the evidence-backed cause, make the narrow repair, and prove
-the regression is gone. Escalate competing causes or a material redesign.
+Reproduce the defect before changing code. A stable red case distinguishes
+cause from symptom and makes the repair checkable.
+
+Owner: Worker within one delegated Assignment. Boundary: capture the smallest
+failing input and trace, form an evidence-backed cause, apply the narrow fix,
+and preserve unrelated behavior. Escalate competing causes or material
+redesign. Root creates/starts the Assignment and records the result through
+`holycodex-agent assignment result`; the Worker must not mutate Intent state or
+edit TOON files manually.
+
+Apply the repository surgical-mutation rule from `AGENTS.md`.
+
+Discover and use the repository-specific formatter, linter, typecheck, and
+validation commands before and after the repair. Start with the smallest
+relevant local proof and expand only when the defect crosses that boundary or
+the release gate requires it; report unavailable commands rather than
+inventing replacements.
+
+Return one outcome from `completed`, `blocked`, `needs_root_input`, or
+`failed`, including reproduction, cause, repair proof, and remaining
+uncertainty. Completion requires the failure to be reproduced, the cause to be
+supported by repository evidence, and the fix and regression proof to pass.

package/dist/assets/plugin/skills/debugging/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Debugging"
   short_description: "Reproduce and repair one observable defect."
-  default_prompt: "Open the debugging workflow for this invocation."
+  default_prompt: "When Root assigns a bounded defect Assignment, apply the repository surgical-mutation rule, reproduce it, isolate its cause, make the narrow repair, prove the regression is gone, and return a structured outcome for holycodex-agent."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/handoff/SKILL.md

@@ -3,7 +3,16 @@ name: handoff
 description: Use when a caller needs a redacted projection of current Intent state for resume or export.
 ---
 
-Produce one compact projection of current Intent, Plan, and Assignment status,
-evidence, blockers, remaining risk, and the exact next action. Omit secrets,
-raw prompts, transcripts, and unchanged narration. Handoff is an export view;
-the semantic state remains authoritative.
+Handoff is a projection/export only, not persistent workflow state. Read the
+current Intent, Plan, and Assignments through `holycodex-agent`; never create a
+handoff file or duplicate lifecycle, owner, blocker, evidence, or resume state.
+
+Owner: Root. Boundary: request a compact redacted projection containing the
+current Intent reference, Plan revision, Assignment statuses, evidence,
+blockers, remaining risk, and exact next action; omit secrets, raw prompts,
+transcripts, and unchanged narration. The authoritative state remains under
+`.holycodex/{slug}-{short-id}/` and all mutations use semantic agent CLI
+operations.
+
+Completion: one bounded, redacted projection is ready for the receiving owner;
+no second source of truth exists.

package/dist/assets/plugin/skills/handoff/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Handoff"
   short_description: "Export a redacted projection of current Intent state."
-  default_prompt: "Open the handoff workflow for this invocation."
+  default_prompt: "When Root needs a resume projection, read current Intent, Plan, and Assignments through holycodex-agent and export one redacted projection without creating duplicate state."
 policy:
   allow_implicit_invocation: false

package/dist/assets/plugin/skills/operations/SKILL.md

@@ -1,11 +1,31 @@
 ---
 name: operations
-description: Use for exact-ref CI or release observation through terminal evidence.
+description: Use when Root assigns exact-ref CI or release observation; discover the repository topology and report terminal external evidence without mutation.
 ---
 
-Observe the exact approved ref and SHA after Root's VCS action. Discover
-whether the repository has separate development and release gates, one combined
-pipeline, or no formal separation. Report terminal green, terminal failure, or
-an exact unavailable or ambiguous blocker. Pending and running are not success.
-Do not rerun, cancel, approve, merge, push, tag, publish, deploy, or otherwise
-mutate external state.
+Owner: Worker.operations within one delegated Assignment. Boundary: observe
+only the exact approved ref and SHA after Root's VCS action. First discover the
+repository's actual topology:
+separate development/release gates, one combined pipeline, or no formal
+separation. Do not assume GitHub, a branch name, or a provider.
+
+The Assignment must include the exact ref, SHA, required checks, and whether
+the observation is development CI or release verification. Do not rerun,
+cancel, approve, merge, push, tag, publish, deploy, or otherwise mutate
+external state. Pending or running is never success; report terminal green,
+terminal failure, or an exact unavailable/ambiguous blocker.
+
+Apply the repository surgical-mutation rule from `AGENTS.md` to any local
+write, and stop for Root input before expanding scope. Do not edit TOON files manually;
+do not create standalone handoff, Decision, or blocker files.
+
+Return one outcome from `completed`, `blocked`, `needs_root_input`, or
+`failed`, with discovered topology, exact ref/SHA, check or release results,
+source references, and remaining risk. Root records it with
+`holycodex-agent assignment result` and decides whether to delegate a fix and
+repeats the post-integration cycle. A terminal green development result permits
+Root to proceed to an authorized release action; after that action, observe the
+release against its exact ref/SHA. If the repository has no distinct release
+gate, report that topology explicitly and never invent a second gate. A
+terminal failure returns control to Root for a bounded fix; this Assignment
+never repairs, retries, approves, or mutates external state.

package/dist/assets/plugin/skills/operations/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Operations"
   short_description: "Observe exact-ref CI or release state to terminal evidence."
-  default_prompt: "Open the terminal operations observation workflow for this invocation."
+  default_prompt: "Observe the assigned exact ref and SHA, discover the repository topology, report completed terminal CI or release evidence (pending is never success), return blocked or needs_root_input when unavailable, never mutate external state, and apply the repository surgical-mutation rule to any authorized local write."
 policy:
   allow_implicit_invocation: false

package/dist/assets/plugin/skills/plan/SKILL.md

@@ -1,10 +1,25 @@
 ---
 name: plan
-description: Use when unresolved architecture, scope, coordination, or material risk requires an implementation-ready Plan.
+description: Use when Root faces unresolved architecture, scope, coordination, or material risk before work begins; produce the implementation-ready decision record.
 ---
 
-Resolve the current material choices into an implementation-ready Plan with
-scope, owners, seams, data and control flow, policy, recovery, compatibility,
-acceptance evidence, and a bounded proof route. Keep planning proportional:
-trivial work can proceed without a Plan. Persist the canonical revision through
-the semantic Plan operation.
+Owner: Root. Boundary: identify alternatives, constraints, risks, route,
+acceptance evidence, exclusions, and recovery, then persist the semantic Plan
+through `holycodex-agent plan revise`. Specialists may supply facts but may not
+decide the outcome.
+
+Create or read the current Intent with `holycodex-agent intent ...`, and create
+the bounded delegated plan/review assignments before dispatch. A plan is optional for
+trivial work. Do not edit TOON files manually.
+
+Use `request_user_input` before seeking workflow Plan approval and whenever
+ambiguity or missing material input blocks safe progress; persist that condition as
+`needs_root_input` on the Intent or Plan. Apply the repository
+surgical-mutation rule from `AGENTS.md`.
+
+Persist the plan operation as a compact `completed`, `blocked`,
+`needs_root_input`, or `failed` result with proof and remaining risk.
+
+Completion: Root has an implementation-ready plan naming scope, owners and
+seams, data and control flow, policy, recovery, tests, compatibility, the
+preferred shape, and a bounded proof route.

package/dist/assets/plugin/skills/plan/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Plan"
   short_description: "Resolve material scope and architecture choices before work."
-  default_prompt: "Open the planning workflow for this invocation."
+  default_prompt: "When Root faces an unresolved material choice, persist an implementation-ready Plan through holycodex-agent, covering scope, route, risk, proof, and delegated Assignments; ask for material input and apply the repository surgical-mutation rule."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/plan-review/SKILL.md

@@ -1,9 +1,23 @@
 ---
 name: plan-review
-description: Use when a complete Plan needs adversarial feasibility, order, risk, and proof review.
+description: Use when Root has a complete plan that needs adversarial review; check feasibility, order, risk, and proof to a fixed point.
 ---
 
-Inspect the complete Plan for feasibility, ordering, risk, and proof. Repair
-only reviewer-owned plan defects; return material product or architecture
-choices to Root. A Plan revision replaces the canonical revision through the
-semantic plan operation.
+Owner: Reviewer. Boundary: inspect the complete Plan once to a fixed point;
+repair only reviewer-owned plan defects. Return material product or
+architecture choices to Root. Root must delegate this review as an Assignment
+and record its structured result through `holycodex-agent assignment result`.
+
+Read the current Plan with `holycodex-agent plan read`; never edit TOON files
+directly. A revision is a semantic `plan revise` operation that archives the
+prior canonical Plan before replacement.
+
+Apply the repository surgical-mutation rule from `AGENTS.md` to any repair. If
+a material choice is unresolved, return `needs_root_input` rather than deciding
+it.
+
+Return `completed`, `blocked`, `needs_root_input`, or `failed` with findings,
+proof, and remaining risk; Root records that outcome on the Assignment.
+
+Completion: the plan is complete with proof, blocked with evidence, or
+explicitly needs a Root decision.

package/dist/assets/plugin/skills/plan-review/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Plan review"
   short_description: "Review one complete plan to a fixed point."
-  default_prompt: "Open the plan review workflow for this invocation."
+  default_prompt: "When Root has a complete Plan, inspect it once, apply only surgical reviewer-owned repairs to a fixed point, and return a structured Assignment result for holycodex-agent."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/programming/SKILL.md

@@ -1,8 +1,22 @@
 ---
 name: programming
-description: Use when Root has decided a bounded implementation seam with known acceptance behavior.
+description: Use when Root has decided a seam and assigns bounded implementation, fixes, tests, or manifests with known acceptance behavior.
 ---
 
-Implement only the decided seam. Inspect its callers and typed boundaries
-before implementation, and add proof at the least brittle observable boundary
-when the acceptance behavior requires it.
+Owner: Worker within one delegated Assignment. Read the Assignment and current
+Intent through the semantic agent interface; do not edit TOON files manually.
+Implement the decided seam inside the assigned files, and do not expand its
+scope. Inspect the callers and tests needed to preserve behavior and typed
+boundaries, then add focused proof at the least brittle observable boundary.
+
+Apply the repository surgical-mutation rule from `AGENTS.md`.
+
+Return exactly one compact specialist outcome: `completed`, `blocked`,
+`needs_root_input`, or `failed`, with changed paths, checks and results,
+evidence, and remaining risk. Root records it with
+`holycodex-agent assignment result`; the Worker never changes global Intent
+lifecycle, makes material decisions, or performs Git/VCS.
+
+Discover and use the repository's own validation commands and run the smallest
+relevant check first; broaden when the seam or release gate requires it.
+Inspect changed files and remove incidental generated output before stopping.

package/dist/assets/plugin/skills/programming/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Programming"
   short_description: "Implement one decided seam with proportional proof."
-  default_prompt: "Open the bounded programming workflow for this invocation."
+  default_prompt: "When Root assigns a bounded Assignment, apply the repository surgical-mutation rule, implement only that seam, add focused proof, inspect changed files, and return completed, blocked, needs_root_input, or failed evidence for holycodex-agent."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/refactor/SKILL.md

@@ -1,8 +1,22 @@
 ---
 name: refactor
-description: Use when one decided seam needs restructuring while preserving behavior and interfaces.
+description: Use when Root has decided one seam needs restructuring; preserve behavior, ownership, and interfaces.
 ---
 
-Restructure only the decided seam. Trace callers before changing a shared root
-cause and preserve public behavior and interfaces. Verify the behavior boundary
-after the refactor.
+Owner: Worker within one delegated Assignment. Read the current Assignment
+through the semantic agent interface; do not edit TOON files manually. Restructure
+only the decided seam. Trace its callers before changing a shared root cause,
+preserve public behavior and interfaces, and keep the smallest cohesive change.
+
+Apply the repository surgical-mutation rule from `AGENTS.md`.
+Preserve unrelated work and stop for Root input before expanding scope.
+
+Discover the repository's own validation commands and run the smallest relevant
+behavior-locked check first; broaden when the changed boundary or release gate
+requires it. Inspect changed files and remove incidental generated output
+before stopping.
+
+Return one outcome from `completed`, `blocked`, `needs_root_input`, or `failed`,
+with changed paths, checks and results, evidence, and remaining risk. The Worker
+does not mutate global Intent lifecycle, make material decisions, or perform
+Git/VCS; Root records the result through `holycodex-agent assignment result`.

package/dist/assets/plugin/skills/refactor/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Refactor"
   short_description: "Restructure one decided seam while preserving its contract."
-  default_prompt: "Open the bounded refactor workflow for this invocation."
+  default_prompt: "When Root assigns a bounded refactor Assignment, apply the repository surgical-mutation rule, preserve behavior and interfaces, inspect changed files, prove the seam, and return completed, blocked, needs_root_input, or failed evidence for holycodex-agent."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/rules/SKILL.md

@@ -1,8 +1,19 @@
 ---
 name: rules
-description: Use when a repository rule needs discovery, validation, or diagnosis of an application failure.
+description: Use when Root assigns a repository rule discovery, validation, or application failure; trace the owning rule path.
 ---
 
-Trace the owning rule loader and its limits, caching, trust boundary, and
-deduplication. State the observed failure, the owning policy, and the evidence
-that proves the rule path or exact blocker.
+Owner: Worker within one delegated Assignment. Boundary: inspect the owning
+rule loader and preserve deduplication, limits, caching, trust boundaries, and
+rule ownership. Read the Assignment through the semantic agent interface; do
+not edit TOON files manually.
+
+Apply the repository surgical-mutation rule from `AGENTS.md` to any repair.
+Preserve unrelated work and stop for Root input before expanding scope.
+
+Completion: the rule path, policy, observed failure, and verification evidence
+are explicit, or the exact blocker is returned. Return one outcome from
+`completed`, `blocked`, `needs_root_input`, or `failed` with changed paths,
+proof, and remaining risk. Root records the result through
+`holycodex-agent assignment result`; the Worker does not mutate global Intent
+lifecycle, make material decisions, or perform Git/VCS.

package/dist/assets/plugin/skills/rules/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Rules"
   short_description: "Trace one repository rule discovery or application failure."
-  default_prompt: "Open the repository rules workflow for this invocation."
+  default_prompt: "When Root assigns a bounded rule Assignment, apply the repository surgical-mutation rule, inspect the owning seam, and return completed, blocked, needs_root_input, or failed evidence for holycodex-agent."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/stop-slop/SKILL.md

@@ -1,9 +1,46 @@
 ---
 name: stop-slop
-description: Use when assigned prose should lose predictable AI writing patterns while preserving voice.
+description: Use when Root assigns prose to draft, edit, or review; remove predictable AI writing patterns while preserving the requested voice.
 ---
 
-Edit only the assigned prose. Remove filler, formulaic structure, vague claims,
-passive voice, and repeated rhythm while preserving meaning and voice. Use the
-linked [phrase](references/phrases.md), [structure](references/structures.md),
-and [example](references/examples.md) references when needed.
+Owner: Worker or Reviewer within the assigned prose surface. Boundary: edit
+only the assigned text, preserve meaning and product voice, and use the linked
+references for phrase, structure, and example branches when needed.
+
+The prose edit is one delegated Assignment. Read its scope and constraints
+through the semantic agent interface; do not edit TOON files manually. Apply the
+repository surgical-mutation rule from `AGENTS.md`. Preserve unrelated work
+and stop for Root input before expanding scope.
+
+# Stop Slop
+
+Remove predictable AI writing patterns from prose.
+
+## Core rules
+
+1. Cut filler phrases, emphasis crutches, and adverbs. See
+   [phrases](references/phrases.md).
+2. Break formulaic structures, binary contrasts, negative listings, dramatic
+   fragments, rhetorical setups, and false agency. See
+   [structures](references/structures.md).
+3. Use active voice and name the person doing the work.
+4. Replace vague declarations and lazy extremes with specific facts.
+5. Prefer "you" and concrete details over distant abstractions.
+6. Vary sentence length and paragraph rhythm. Avoid em dashes.
+7. State facts directly without softening or hand-holding.
+8. Rewrite pull-quote language as plain language.
+
+Before delivery, check for adverbs, passive voice, inanimate actors, vague
+claims, throat-clearing, binary contrasts, meta-joiners, em dashes, and repeated
+rhythm. Use [examples](references/examples.md) to calibrate edits.
+
+Completion: the assigned prose is direct, specific, constraint-equivalent,
+and reviewed against the relevant references; any deliberate voice tradeoff is
+recorded. Return one outcome from `completed`, `blocked`, `needs_root_input`, or
+`failed` with changed paths, proof, and remaining risk. Root records the result
+through `holycodex-agent assignment result`; do not mutate global Intent
+lifecycle or perform Git/VCS.
+
+## License
+
+MIT

package/dist/assets/plugin/skills/stop-slop/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Stop Slop"
   short_description: "Edit assigned prose to remove predictable AI patterns."
-  default_prompt: "Open the assigned prose editing workflow for this invocation."
+  default_prompt: "When Root assigns a bounded prose Assignment, apply the repository surgical-mutation rule and disclosed references, preserve meaning and voice, and return completed, blocked, needs_root_input, or failed evidence for holycodex-agent."
 policy:
   allow_implicit_invocation: true

package/dist/assets/plugin/skills/testing-quality.md

@@ -1,12 +1,28 @@
 # Testing quality
 
-Use this reference when assessing a test for a requested change. Identify the
-stable behavior, contract, invariant, compatibility guarantee, safety property,
-or meaningful failure mode it protects; the regression it catches; and why a
-less brittle boundary cannot protect it.
-
-Do not freeze incidental counts, inventories, internal paths, prompt or skill
-wording, irrelevant call order, broad repository shape, or one implementation
-strategy. Prefer observable typed or public boundaries. Package-verification
-tests should consume the shipped artifact through one supported outer boundary
-with minimal realistic setup, proving behavior without duplicating the suite.
+Use this reference when Root, Worker, or Reviewer evaluates a test for a
+requested change.
+
+Owner: Worker or Reviewer within the assigned test surface. Boundary: protect
+stable behavior, contracts, invariants, safety properties, compatibility
+guarantees, and meaningful failure modes. Prefer observable and typed or
+public boundaries while leaving implementation choices free.
+
+Before adding a regression or package-verification test, identify:
+
+1. the stable behavior it protects;
+2. the real regression it catches;
+3. why a less brittle boundary cannot protect it.
+
+Remove or rewrite tests that freeze incidental counts, inventories, internal
+paths, prompt or skill sizes, exact non-contract wording, irrelevant call order,
+deleted names, broad repository shape, or one implementation strategy. Avoid
+large internal snapshots and static source inspection when a behavior check
+exists. Package-verification tests should consume the shipped artifact through
+one supported outer boundary with minimal realistic setup, proving a meaningful
+artifact behavior without duplicating the suite or crawling inventories.
+
+Use proportional proof. A test that constrains more design than meaningful regression risk should not exist.
+
+Completion: each retained test names the stable behavior and regression it
+protects, and the chosen boundary is no more brittle than necessary.

package/dist/assets/plugin/skills/writing-for-agents/SKILL-MECHANICS.md

@@ -1,9 +1,19 @@
 # Skill mechanics
 
-Use a model-invoked skill when its description names a distinct model-facing
-branch. Keep the description trigger-first and short. Keep routing and
-invocation metadata in `agents/openai.yaml`; the body owns the behavior.
+This is the skill-specific branch of [writing-for-agents](SKILL.md): frontmatter, invocation choice, and router skills.
 
-Put uncommon mechanics in a linked reference only when a caller needs them.
-Keep each instruction in one source of truth and avoid copying body text into
-metadata or neighboring skills.
+## Invocation
+
+A **model-invoked** skill keeps a trigger-first `description` so an agent can select it and another skill can reach its shared reference. The always-loaded pointer spends context on every turn, so use one compact trigger per real branch and remove routing prose from the body.
+
+A **user-invoked** skill sets `disable-model-invocation: true`. Its description becomes a human-facing one-line summary with trigger lists removed. Use this when only a person should select the skill.
+
+Shared reference required by user-invoked skills belongs in a plain disclosed file that each can point to.
+
+## Splitting by invocation
+
+Split a model-invoked skill only when a distinct leading word should trigger it independently or another skill must reach it. The independent route must justify its permanent context pointer.
+
+## Router skills
+
+When many user-invoked skills exceed human cognitive load, add one user-invoked router that names them and their branches. A router can guide the person; it cannot autonomously invoke skills whose model invocation is disabled.