holycodex 0.15.2 → 0.16.0

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

@@ -1,10 +1,13 @@
 ---
 name: plan
-description: Use for unresolved architecture, scope, coordination, or material risk before work begins; Root owns the resulting decision.
+description: Use when Root faces unresolved architecture, scope, coordination, or material risk before work begins; produce the implementation-ready decision record.
 ---
 
-Use this skill when a task has a material unresolved choice, because a bounded plan keeps authority and proof visible before implementation.
+Owner: Root. Boundary: identify alternatives, constraints, risks, route,
+acceptance evidence, exclusions, and recovery without dispatching
+implementation work before the plan gate opens. Specialists may supply facts
+but may not decide the outcome.
 
-Owner: Root. Boundary: identify alternatives, constraints, risks, route, and acceptance evidence; specialists may supply facts but may not decide the outcome.
-
-Completion: Root has an implementation-ready plan with explicit scope, exclusions, owner/seam, data and control flow, policy and recovery, tests, compatibility, preferred shape, and a bounded proof route.
+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: "Create an implementation-ready plan for the unresolved architecture, scope, risk, and proof decisions."
+  default_prompt: "When Root faces an unresolved material choice, produce an implementation-ready plan covering scope, route, risk, and proof."
 policy:
   allow_implicit_invocation: true

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

@@ -1,7 +1,11 @@
 ---
 name: plan-review
-description: Use when a complete plan needs adversarial review; check feasibility, order, risk, and proof to fixed point.
+description: Use when Root has a complete plan that needs adversarial review; check feasibility, order, risk, and proof to a fixed point.
 ---
 
-Owner: Reviewer. Boundary: inspect the complete plan once to fixed point and return findings; material product or architecture choices return to Root.
-Completion: the plan is complete, blocked with evidence, or explicitly needs Root decision.
+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.
+
+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 for feasibility, order, risk, and proof."
-  default_prompt: "Inspect the complete plan, repair bounded defects, and return structured proof."
+  short_description: "Review one complete plan to a fixed point."
+  default_prompt: "When Root has a complete plan, inspect it once, repair reviewer-owned defects to a fixed point, and return structured proof."
 policy:
   allow_implicit_invocation: true

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

@@ -1,12 +1,23 @@
 ---
 name: programming
-description: Use for bounded implementation, fixes, tests, or manifests when the seam and acceptance behavior are decided.
+description: Use when Root has decided a seam and assigns bounded implementation, fixes, tests, or manifests with known acceptance behavior.
 ---
 
-Implement only the assigned seam, because repository-native ownership and a proportional proof keep a small change reviewable.
+Implement only the assigned seam. Inspect required callers and tests, preserve
+typed boundaries and portability, edit only approved files, and make one
+bounded clarity pass.
 
-When implementation changes tests, apply [testing quality](../testing-quality.md) before adding or retaining them.
+Reuse existing code, prefer standard-library or native behavior, trace every
+caller before repairing a shared root cause, and keep the diff minimal and
+bounded. Do not add speculative abstractions.
 
-Owner: Worker. Boundary: inspect required callers and tests, preserve typed boundaries and portability, edit only approved files, make one bounded clarity pass, and escalate material choices.
+When implementation changes tests, apply [testing quality](../testing-quality.md)
+before adding or retaining them. Escalate material choices.
 
-Completion: the requested behavior and focused tests are present, changed files are inspected, diagnostics and proportional checks pass, and structured evidence names residual risk or a precise blocker.
+Owner: Worker. Boundary: preserve repository-native ownership, dependency
+direction, trust checks, and acceptance behavior; do not broaden scope or
+delegate.
+
+Completion: the requested behavior and focused proof are present, changed
+files are inspected, diagnostics and proportional checks pass, and structured
+evidence names residual risk or a precise blocker.

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

@@ -1,6 +1,6 @@
 interface:
   display_name: "Programming"
-  short_description: "Implement a decided seam with proportional proof."
-  default_prompt: "Implement the assigned seam, add focused proof, inspect the changed files, and return structured evidence."
+  short_description: "Implement one decided seam with proportional proof."
+  default_prompt: "When Root assigns a decided seam, implement it, add focused proof, inspect changed files, and return structured evidence."
 policy:
   allow_implicit_invocation: true

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

@@ -1,7 +1,14 @@
 ---
 name: refactor
-description: Use when one decided seam needs restructuring; preserve behavior and interfaces.
+description: Use when Root has decided one seam needs restructuring; preserve behavior, ownership, and interfaces.
 ---
 
-Owner: Worker. Boundary: change only the assigned seam and preserve ownership, dependency direction, and public behavior.
-Completion: changed files and behavior-locked checks are clean.
+Reuse existing code and prefer standard-library or native behavior. Trace
+callers before changing a shared root cause, keep the diff minimal and
+bounded, and avoid speculative abstractions.
+
+Owner: Worker. Boundary: change only the assigned seam; preserve ownership,
+dependency direction, public behavior, and interfaces.
+
+Completion: changed files are inspected and behavior-locked checks are clean,
+with any residual risk or blocker explicit.

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 behavior and interfaces."
-  default_prompt: "Refactor the assigned seam, preserve interfaces, and return focused proof."
+  short_description: "Restructure one decided seam while preserving its contract."
+  default_prompt: "When Root assigns a seam refactor, preserve behavior and interfaces, inspect the changed files, and return focused proof."
 policy:
   allow_implicit_invocation: true

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

@@ -1,7 +1,10 @@
 ---
 name: rules
-description: Use when repository rules fail discovery, validation, or application; trace the owning rule path.
+description: Use when Root assigns a repository rule discovery, validation, or application failure; trace the owning rule path.
 ---
 
-Owner: Worker. Boundary: inspect the owning rule loader and preserve deduplication, limits, caching, and trust boundaries.
-Completion: the rule path, policy, and failure evidence are explicit.
+Owner: Worker. Boundary: inspect the owning rule loader and preserve
+deduplication, limits, caching, trust boundaries, and rule ownership.
+
+Completion: the rule path, policy, observed failure, and verification evidence
+are explicit, or the exact blocker is returned.

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

@@ -1,6 +1,6 @@
 interface:
   display_name: "Rules"
-  short_description: "Trace repository rule discovery, validation, and application failures."
-  default_prompt: "Inspect the assigned rule seam and return exact behavior, limits, and failure evidence."
+  short_description: "Trace one repository rule discovery or application failure."
+  default_prompt: "When Root assigns a rule failure, inspect the owning rule seam and return exact behavior, limits, and failure evidence."
 policy:
   allow_implicit_invocation: true

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

@@ -1,41 +1,37 @@
 ---
 name: stop-slop
-description: Use when drafting, editing, or reviewing prose; remove predictable AI writing patterns.
-metadata:
-  trigger: Writing prose, editing drafts, reviewing content for AI patterns
-  author: Hardik Pandya (https://hvpandya.com)
+description: Use when Root assigns prose to draft, edit, or review; remove predictable AI writing patterns while preserving the requested voice.
 ---
 
-# Stop Slop
-
-Eliminate predictable AI writing patterns from prose.
-
-## Core Rules
-
-1. **Cut filler phrases.** Remove throat-clearing openers, emphasis crutches, and all adverbs. See [references/phrases.md](references/phrases.md).
-2. **Break formulaic structures.** Avoid binary contrasts, negative listings, dramatic fragmentation, rhetorical setups, false agency. See [references/structures.md](references/structures.md).
-3. **Use active voice.** Every sentence needs a human subject doing something. No passive constructions. No inanimate objects performing human actions ("the complaint becomes a fix").
-4. **Be specific.** No vague declaratives ("The reasons are structural"). Name the specific thing. No lazy extremes ("every," "always," "never") doing vague work.
-5. **Put the reader in the room.** No narrator-from-a-distance voice. "You" beats "People." Specifics beat abstractions.
-6. **Vary rhythm.** Mix sentence lengths. Two items beat three. End paragraphs differently. No em dashes.
-7. **Trust readers.** State facts directly. Skip softening, justification, hand-holding.
-8. **Cut quotables.** If it sounds like a pull-quote, rewrite it.
-
-## Quick Checks
+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.
 
-Before delivering prose:
-
-- Any adverbs? Kill them.
-- Any passive voice? Find the actor, make them the subject.
-- Inanimate thing doing a human verb? Name the person.
-- Sentence starts with a Wh- word? Restructure it.
-- Any throat-clearing, binary contrast, vague declaration, meta-joiner, em dash, or repeated rhythm? Cut or rewrite it.
-
-## Scoring
-
-Rate directness, rhythm, trust, authenticity, and density from 1-10. Below 35/50: revise.
+# Stop Slop
 
-See [references/examples.md](references/examples.md) for before/after transformations.
+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.
 
 ## License
 

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

@@ -1,6 +1,6 @@
 interface:
   display_name: "Stop Slop"
-  short_description: "Remove predictable AI prose patterns"
-  default_prompt: "Edit the assigned prose using the stop-slop rules and disclosed references."
+  short_description: "Edit assigned prose to remove predictable AI patterns."
+  default_prompt: "When Root assigns prose editing, apply the concise rules and disclosed references while preserving meaning and voice."
 policy:
   allow_implicit_invocation: true

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

@@ -1,6 +1,12 @@
 # Testing quality
 
-Protect stable behavior, contracts, invariants, safety properties, compatibility guarantees, and meaningful failure modes. Prefer observable behavior and typed or public boundaries while leaving implementation choices free.
+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 smoke test, identify:
 
@@ -13,3 +19,6 @@ Remove or rewrite tests that freeze incidental counts, inventories, internal pat
 A smoke test consumes the shipped artifact through one supported outer boundary with minimal realistic setup. It answers whether the artifact can start and perform its smallest supported job. It does not duplicate the suite, reproduce packaging logic, crawl file inventories, or accumulate historical implementation assertions.
 
 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.md

@@ -1,6 +1,6 @@
 ---
 name: writing-for-agents
-description: Use when authoring or reviewing prompts, skills, profiles, delegations, handoffs, workflows, or agent-facing repository instructions; make them independently actionable with low context load.
+description: Use when authoring or reviewing prompts, skills, profiles, delegations, handoffs, or agent-facing repository instructions; make them independently actionable with low context load.
 ---
 
 # Writing for agents

package/dist/assets/plugin/skills/writing-for-agents/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Writing for agents"
-  short_description: "Design compact, actionable agent instructions."
-  default_prompt: "Write or review agent steering with clear behavior, reason, authority, evidence, escalation, and completion."
+  short_description: "Design compact, independently actionable agent instructions."
+  default_prompt: "When Root assigns agent-instruction work, write or review steering with clear behavior, reason, authority, evidence, escalation, and completion."
 policy:
   allow_implicit_invocation: true