holycodex 0.16.8 → 0.16.9-dev.103.1

package/dist/assets/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.16.8",
+  "version": "0.16.9",
   "description": "Root-directed capabilities and deterministic installed assets for HolyCodex.",
   "author": {
     "name": "David Basile Filho",

package/dist/assets/plugin/skills/babysit-ci/SKILL.md

@@ -5,17 +5,9 @@ description: Use when following CI or release gates through terminal completion.
 
 # Babysit CI
 
-Discover the repository's own development and release instructions, provider,
-refs, required checks, review bots, publication mechanism, and gate dependencies
-through bounded specialist Assignments before operating or observing CI.
-Discover the actual topology for both pushes and pull requests; do not assume
-GitHub, branch names, a registry, or separate pipelines.
-
-Root owns authorized Git/VCS and release actions. Worker.operations observes
-only the supplied exact ref and SHA; its result identifies the gate, run,
-terminal status, evidence locator, and any unavailable or ambiguous evidence.
-Pending or running is never success. Observation cannot rerun, cancel, approve,
-publish, or otherwise mutate external state.
+Discover the repository's development and release topology for pushes and pull
+requests: refs, required checks, reviews, publication mechanism, and gate
+dependencies. Do not assume a provider, branch name, or separate pipeline.
 
 For a push, bind every observation to the exact pushed ref and SHA. For a pull
 request, bind it to the current head SHA, target branch, pull-request identity,
@@ -24,32 +16,20 @@ relevant bot reviews, inline threads, issue comments, and commit comments. A
 new push invalidates all stale CI and review evidence; rediscover the current
 head and repeat validation and review observation for that SHA.
 
-Use bounded observer waits; honor the maximum Root event wait and fork-none
-policy. Distinguish a bot that is absent or not configured from a known bot
-with no terminal signal, and distinguish both from a clean terminal
-disposition. Absence or no signal is an evidence gap, never an implicit pass.
-Do not declare completion from green checks while relevant bot reviews or
-threads remain outstanding, and do not automatically accept bot instructions
-or post comments or other spam.
+Use bounded observer waits. Distinguish a bot that is absent or not configured
+from a known bot with no terminal signal, and both from a clean terminal
+disposition. Absence or no signal is an evidence gap. Green checks do not
+resolve outstanding review findings or threads.
 
-After a development action, observe its exact ref/SHA to terminal state. Green
-permits the next repository/user-required action. Red requires delegated
-diagnosis and repair, integration, applicable frontend/security acceptance,
-and the mandatory Reviewer.code fixed point before Root commits and pushes.
-Triage actionable bot findings and route them through the same repair, review,
-and revalidation route.
-Root owns dismissals, resolution, material judgment, and external messages.
-Observe the new exact ref/SHA and repeat until green or an irreducible blocker.
+After a development action, observe its exact ref and SHA to terminal state.
+Repair failed checks and actionable review findings, then repeat validation and
+observation on the new head until green or an irreducible blocker.
 
 When the repository requires a development or prerelease gate before stable,
-stable is forbidden until that gate is terminal green. Root then performs the
-repository's actual authorized stable mechanism and delegates terminal
-observation. Stable failure enters the same repair/review/VCS cycle and passes
-through every required development gate before another stable attempt.
+wait for terminal green before stable. A stable failure enters the same repair
+and review cycle, including required development gates before another attempt.
 
 Use one gate for a combined pipeline. Do not invent a distinct release gate.
-Completion requires required checks to be terminal green and every relevant bot
-finding to have a supported terminal disposition, with an honest record of any
-bot absence or missing terminal signal. A successful push, started pipeline,
-or green checks without current review evidence does not complete this workflow;
-return a precise external blocker when the evidence cannot be obtained.
+Completion requires terminal green checks and a supported terminal disposition
+for relevant reviews on the current SHA. Return the precise external blocker
+when terminal evidence cannot be obtained.

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

@@ -6,10 +6,3 @@ description: Use after implementation when Root needs adversarial code review an
 Inspect the integrated implementation against the `Reviewer.code` contract.
 Check callers, contracts, tests, and generated artifacts. Repair defects inside
 the review surface and return findings, repairs, checks, and remaining risk.
-
-Use one batched evidence sweep, reason over it, make targeted follow-ups only,
-and batch related repairs and verification.
-
-Lead with actionable findings and check evidence. Keep the terminal report
-concise and structured, reuse stable facts, and inspect large artifacts only
-when a material decision, conflict, failure, or finding requires it.

package/dist/assets/plugin/skills/codebase-onboarding/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: codebase-onboarding
+description: Use when explaining a repository or orienting a new contributor to how it works.
+---
+
+Provide a bounded, read-only orientation to the current repository or answer a
+repository question from its evidence. Cover the purpose, key structure and
+dependencies, entry points, and important execution or data flows relevant to
+the request. Return concrete evidence and file locators; Root synthesizes the
+explanation from specialist findings. Change persistent documentation only
+when requested.

package/dist/assets/plugin/skills/codebase-onboarding/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Codebase onboarding"
+  short_description: "Explain a repository from a bounded read-only map."
+  default_prompt: "Explain how this repository works."
+policy:
+  allow_implicit_invocation: true

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

@@ -3,18 +3,8 @@ name: commit
 description: Use when Root creates a local commit after scope and proof are settled.
 ---
 
-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.
-
-Require a passing Reviewer.code fixed-point result after implementation or a
-major codebase change before this VCS exception is used.
-
-After integration, Root commits the exact authorized scope. For subsequent CI
-or release work, load [babysit-ci](../babysit-ci/SKILL.md), which owns that
-lifecycle. Root's authority policy owns approval requirements and existing
-user authorization.
-
-Completion: Root reports the commit identity and post-commit status with
-redacted evidence, or returns an exact reproducible blocker. Never print secret
-values.
+After scope and proof are settled, follow the repository's commit conventions
+and create the smallest coherent set of atomic commits, each with a separately
+meaningful purpose. Include only the authorized scope and review the staged
+diff before committing. Return commit identities and the resulting repository
+state, or the exact blocker.

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."
+  short_description: "Create coherent local commits with exact scope proof."
   default_prompt: "Open the commit workflow for this invocation."
 policy:
   allow_implicit_invocation: false

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

@@ -8,6 +8,4 @@ narrowly for the requested version and fact. Use the CLI's current help for
 command syntax. Return the resolved identity, version, relevant source locator,
 and the evidence state required by the canonical Librarian policy.
 
-That policy owns Context7-first enforcement, allowed fallback reasons, and
-decision authority. Tool documentation supplies facts; Root owns material
-product, architecture, dependency, compatibility, and implementation decisions.
+The canonical Librarian policy owns Context7-first enforcement and fallback.

package/dist/assets/plugin/skills/continue-work/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: continue-work
+description: Use when the user asks Root to continue, resume, or keep going with existing HolyCodex work.
+---
+
+Restore the current Intent, Plan if present, Assignments, accepted evidence,
+decisions, completed work, and unresolved work. Reconcile that state with the
+current repository and continue normal HolyCodex orchestration from the last
+supported point; do not restart the same work as a new Intent.
+
+Use `holycodex-agent state diagnose --intent <ref>` only when safe continuation
+cannot be established from the available state and current evidence. Resolve a
+recoverable inconsistency through its owning state operation, or return the
+exact blocker to Root. An active Assignment is not failed without evidence that
+its invocation stopped.

package/dist/assets/plugin/skills/continue-work/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Continue work"
+  short_description: "Resume the current HolyCodex work from durable state."
+  default_prompt: "Continue the current HolyCodex work."
+policy:
+  allow_implicit_invocation: true

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

@@ -1,8 +1,11 @@
 ---
 name: debugging
-description: Use for a reproducible crash, wrong result, regression, hang, race, leak, or slowdown.
+description: Use to diagnose and repair an observable defect or unexplained behavior.
 ---
 
-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 issue with the smallest useful case when practical; otherwise,
+establish its cause from strong observed evidence. Bound log review and use
+temporary instrumentation only when it resolves uncertainty; remove temporary
+instrumentation afterward. Repair only the assigned seam and prove the
+regression is gone at an appropriate behavior boundary. Escalate materially
+unresolved causes or a redesign.

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."
+  short_description: "Diagnose an observable defect through reproduction or strong evidence."
   default_prompt: "Open the debugging workflow for this invocation."
 policy:
   allow_implicit_invocation: false

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

@@ -6,6 +6,4 @@ description: Use when a caller needs a redacted projection of current Intent sta
 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. Lead with observable evidence and
-material decisions, reuse stable facts, and inspect or include large material
-only when a material decision, conflict, failure, or finding requires it.
+the semantic state remains authoritative.

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

@@ -3,6 +3,5 @@ name: programming
 description: Use when Root has decided a bounded implementation seam 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.
+Implement only the decided seam and prove its acceptance behavior at the least
+brittle observable boundary.

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

@@ -10,7 +10,3 @@ 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.
-
-The canonical testing policy owns proportional proof, required gates, and when
-to broaden or repeat checks. Role.task and the Assignment own the validator's
-authority; this reference adds only test-quality criteria.

package/dist/assets/plugin/skills/web-visualize/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: web-visualize
+description: Use when the user requests an interactive visualization or approves a proposed one.
+---
+
+Use ChatGPT Sites to create an interactive, user-facing visualization that
+turns the supplied plan, analysis, design, structured information, or other
+useful material into a clear, usable result. When the user explicitly requests
+a visualization, create it without asking again. If you believe one would
+materially improve a task but the user did not request it, ask Root to obtain
+approval before creating it.
+
+Return the visualization and enough context to verify that it answers the
+request. If the requested result cannot be completed with an authorized,
+available capability, return the specific blocker to Root. Publication,
+sharing, and other consequential external effects require their usual
+authorization.

package/dist/assets/plugin/skills/web-visualize/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Web visualize"
+  short_description: "Turn useful information into an interactive user-facing visualization."
+  default_prompt: "Create the requested interactive visualization."
+policy:
+  allow_implicit_invocation: true

package/dist/assets/plugin/skills/writing-instructions/SKILL.md

@@ -1,15 +1,14 @@
 ---
 name: writing-instructions
-description: Use when authoring or reviewing model-facing instructions for GPT-6.
+description: Use when authoring or reviewing model-facing instructions.
 ---
 
 # Writing instructions
 
-HolyCodex's canonical instruction-authoring skill has a GPT-6 → GPT-6 direction.
-It covers developer_instructions, Root/session policy, specialist and Role.task
-instructions, skill bodies, conditional workflows, and task-specific contracts.
-Keep shared behavioral policy under one owner across model routes, while
-accounting for demonstrated model-specific capability or prompting differences.
+Use this skill for model-facing instructions, including Root/session policy,
+specialist and Role.task contracts, skills, and conditional workflows. Keep
+shared behavior under one owner across model routes; account for model-specific
+differences only when supported by evidence.
 
 Before writing, identify the receiver's effective context: higher-priority and
 user instructions, repository instructions, Role/task policy, relevant skills,
@@ -37,9 +36,8 @@ policy, and unnecessary questionnaires. Preserve meaningful repository checks
 and review gates through their canonical owners instead of reproducing them in
 every skill. Use configuration for verbosity rather than generic style padding.
 
-When creating or changing a skill's invocation boundary or conditional branches,
-read [Skill mechanics](SKILL-MECHANICS.md). Other instruction changes do not need
-that reference.
+When changing a skill's invocation boundary or conditional branches, follow
+[Skill mechanics](SKILL-MECHANICS.md).
 
 An instruction change is complete when the receiver can act within its authority,
 recognize completion and escalation boundaries, and return sufficient evidence;

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

@@ -1,6 +1,6 @@
 interface:
   display_name: "Writing instructions"
-  short_description: "Author and review GPT-6 model instructions."
+  short_description: "Author and review model-facing instructions."
   default_prompt: "Use writing-instructions for this instruction change."
 policy:
   allow_implicit_invocation: true