holycodex 0.16.5 → 0.16.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "holycodex",
3
- "version": "0.16.5",
3
+ "version": "0.16.6",
4
4
  "description": "Root-directed capabilities and deterministic installed assets for HolyCodex.",
5
5
  "author": {
6
6
  "name": "David Basile Filho",
@@ -0,0 +1,33 @@
1
+ ---
2
+ name: babysit-ci
3
+ description: Use when following CI or release gates through terminal completion.
4
+ ---
5
+
6
+ # Babysit CI
7
+
8
+ Discover the repository's own development and release instructions, provider,
9
+ refs, required checks, publication mechanism, and gate dependencies through
10
+ bounded specialist Assignments before operating or observing CI. Do not assume
11
+ GitHub, branch names, pull requests, a registry, or separate pipelines.
12
+
13
+ Root owns authorized Git/VCS and release actions. Worker.operations observes
14
+ only the supplied exact ref and SHA; its result identifies the gate, run,
15
+ terminal status, evidence locator, and any unavailable or ambiguous evidence.
16
+ Pending or running is never success. Observation cannot rerun, cancel, approve,
17
+ publish, or otherwise mutate external state.
18
+
19
+ After a development action, observe its exact ref/SHA to terminal state. Green
20
+ permits the next repository/user-required action. Red requires delegated
21
+ diagnosis and repair, integration, applicable frontend/security acceptance,
22
+ and the mandatory Reviewer.code fixed point before Root commits and pushes.
23
+ Observe the new exact ref/SHA and repeat until green or an irreducible blocker.
24
+
25
+ When the repository requires a development or prerelease gate before stable,
26
+ stable is forbidden until that gate is terminal green. Root then performs the
27
+ repository's actual authorized stable mechanism and delegates terminal
28
+ observation. Stable failure enters the same repair/review/VCS cycle and passes
29
+ through every required development gate before another stable attempt.
30
+
31
+ Use one gate for a combined pipeline. Do not invent a distinct release gate.
32
+ Completion requires all requested terminal-green evidence or a precise external
33
+ blocker; a successful push or started pipeline does not complete this workflow.
@@ -0,0 +1,6 @@
1
+ interface:
2
+ display_name: "Babysit CI"
3
+ short_description: "Follow repository CI and release gates to completion."
4
+ default_prompt: "Use babysit-ci for this CI or release lifecycle."
5
+ policy:
6
+ allow_implicit_invocation: true
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: commit
3
- description: Use when Root owns a local commit after exact scope and proof are settled; verify scope, create the minimal commit, and report identity.
3
+ description: Use when Root creates a local commit after scope and proof are settled.
4
4
  ---
5
5
 
6
6
  Root uses this workflow after exact scope and local proof are settled. Verify
@@ -10,22 +10,10 @@ exclusions before creating the local commit.
10
10
  Require a passing Reviewer.code fixed-point result after implementation or a
11
11
  major codebase change before this VCS exception is used.
12
12
 
13
- After integration, Root commits the exact approved ref and gives its exact ref
14
- and SHA to `Worker.operations` for terminal CI observation.
15
- Discover the repository's actual development/release topology first; never
16
- assume GitHub, branch names, or that pending is success. Delegate fixes for
17
- failures, then repeat integration, commit, push, and observation until the
18
- repository gate is terminal green. If release is authorized, Root performs the
19
- repository's own release mechanism only after the development gate is terminal
20
- green, then delegates terminal release verification. If development and release
21
- share one pipeline, or the repository has no distinct release gate, record that
22
- topology and apply the repository's one available terminal gate. Fix failures
23
- through a new bounded Assignment and repeat the same review/VCS/observation
24
- cycle.
25
-
26
- Local commits need no user approval; every exact push, tag, merge, CI trigger,
27
- publication, or other remote mutation requires fresh user approval through
28
- native `request_user_input` immediately beforehand.
13
+ After integration, Root commits the exact authorized scope. For subsequent CI
14
+ or release work, load [babysit-ci](../babysit-ci/SKILL.md), which owns that
15
+ lifecycle. Root's authority policy owns approval requirements and existing
16
+ user authorization.
29
17
 
30
18
  Completion: Root reports the commit identity and post-commit status with
31
19
  redacted evidence, or returns an exact reproducible blocker. Never print secret
@@ -1,12 +1,13 @@
1
1
  ---
2
2
  name: context7-cli
3
- description: Use when a current library, framework, SDK, or API fact needs authoritative documentation.
3
+ description: Use when querying current technical documentation with Context7 CLI.
4
4
  ---
5
5
 
6
- Use current authoritative documentation before relying on memory. Return the
7
- requested versions, behavior, dates, conflicts, and coverage limits with
8
- source locators. Do not turn an external fact into an architecture decision.
6
+ Resolve the requested library identity with the installed ctx7 CLI, then query
7
+ narrowly for the requested version and fact. Use the CLI's current help for
8
+ command syntax. Return the resolved identity, version, relevant source locator,
9
+ and the evidence state required by the canonical Librarian policy.
9
10
 
10
- Root dispatches this procedure to `Librarian.lookup` or `Librarian.research`
11
- through a bounded Assignment; Root does not perform current-source research
12
- locally.
11
+ That policy owns Context7-first enforcement, allowed fallback reasons, and
12
+ decision authority. Tool documentation supplies facts; Root owns material
13
+ product, architecture, dependency, compatibility, and implementation decisions.
@@ -1,16 +1,10 @@
1
1
  ---
2
2
  name: operations
3
- description: Use for exact-ref CI or release observation through terminal evidence.
3
+ description: Use for a Worker.operations exact-ref/SHA observation Assignment.
4
4
  ---
5
5
 
6
- Observe the exact approved ref and SHA after Root's VCS action. Discover
7
- whether the repository has separate development and release gates, one combined
8
- pipeline, or no formal separation. Report terminal green, terminal failure, or
9
- an exact unavailable or ambiguous blocker. Pending and running are not success.
10
- Do not rerun, cancel, approve, merge, push, tag, publish, deploy, or otherwise
11
- mutate external state.
12
-
13
- Root dispatches this procedure to `Worker.operations` with the exact ref and
14
- SHA. Include target-branch or pull-request mergeability evidence when the
15
- repository or provider exposes it; green CI alone does not prove mergeability.
16
- Root does not observe terminal operations locally.
6
+ Load [babysit-ci](../babysit-ci/SKILL.md) before observing the supplied exact ref
7
+ and SHA. Return the required terminal gate evidence and any unavailable or
8
+ ambiguous blocker within the Assignment's observation-only authority. Include
9
+ target-branch or pull-request mergeability evidence when the repository or
10
+ provider exposes it; green CI alone does not prove mergeability.
@@ -3,10 +3,9 @@ name: plan-review
3
3
  description: Use when a complete Plan needs adversarial feasibility, order, risk, and proof review.
4
4
  ---
5
5
 
6
- Inspect the complete Plan for feasibility, ordering, risk, and proof. Repair
7
- only reviewer-owned plan defects; return material product or architecture
8
- choices to Root. A Plan revision replaces the canonical revision through the
9
- semantic plan operation.
6
+ Inspect the complete Plan for feasibility, ordering, risk, and proof. Return
7
+ findings and proposed corrections without mutating the Plan or source. Root
8
+ owns material product or architecture choices and canonical Plan revisions.
10
9
 
11
10
  Root dispatches this procedure as a bounded Assignment to `Reviewer.plan` and
12
11
  consumes its evidence; Root does not perform plan review locally.
@@ -11,7 +11,6 @@ strategy. Prefer observable typed or public boundaries. Package-verification
11
11
  tests should consume the shipped artifact through one supported outer boundary
12
12
  with minimal realistic setup, proving behavior without duplicating the suite.
13
13
 
14
- When Root needs independent local proof, dispatch `Worker.validation` through a
15
- bounded Assignment. Its filesystem writes are limited to caches, build output,
16
- and generated test state; it cannot mutate the implementation under
17
- validation. Root does not run repository tests locally.
14
+ The canonical testing policy owns proportional proof, required gates, and when
15
+ to broaden or repeat checks. Role.task and the Assignment own the validator's
16
+ authority; this reference adds only test-quality criteria.
@@ -0,0 +1,16 @@
1
+ # Skill mechanics
2
+
3
+ Use a skill for a distinct conditional workflow or tool capability. Keep its
4
+ description short and specific enough to distinguish the invocation from nearby
5
+ skills. Avoid broad triggers that compete for ordinary work; audit implicit
6
+ invocation against the other skills the receiver can load.
7
+
8
+ Keep the main body focused on the shared outcome, boundaries, and acceptance
9
+ criteria. Link branch-specific tool knowledge or uncommon procedures from the
10
+ condition that needs them, so only the selected branch loads its detail. Do not
11
+ split a short coherent rule merely to create more files.
12
+
13
+ Keep display and invocation metadata in agents/openai.yaml and behavior in its
14
+ single authoritative source. References should supply a missing decision or
15
+ mechanic, not copies of the body or global policy. Preserve provenance and
16
+ license attribution under the original upstream names when renaming a skill.
@@ -0,0 +1,47 @@
1
+ ---
2
+ name: writing-instructions
3
+ description: Use when authoring or reviewing model-facing instructions for GPT-6.
4
+ ---
5
+
6
+ # Writing instructions
7
+
8
+ HolyCodex's canonical instruction-authoring skill has a GPT-6 → GPT-6 direction.
9
+ It covers developer_instructions, Root/session policy, specialist and Role.task
10
+ instructions, skill bodies, conditional workflows, and task-specific contracts.
11
+ Model routing identities do not change this behavioral target.
12
+
13
+ Before writing, identify the receiver's effective context: higher-priority and
14
+ user instructions, repository instructions, Role/task policy, relevant skills,
15
+ tools and capabilities, configuration, and current task context. Add only the
16
+ missing semantic delta. Resolve conflicts against the governing authority;
17
+ do not duplicate a meaning already supplied to the same receiver.
18
+
19
+ Give each meaning one authoritative owner at the narrowest scope that applies:
20
+ Root/session invariants in Root policy, repository conventions in AGENTS.md,
21
+ shared specialist boundaries in the specialist baseline, route-specific behavior
22
+ in Role.task, and genuinely conditional workflow or tool knowledge in a skill.
23
+ Generated projections derive from or validate against that owner. Invocation
24
+ metadata selects a branch; it does not become a second policy source.
25
+
26
+ Define the required outcome and completion evidence, bounded authority, relevant
27
+ constraints, material decisions or blockers that escalate, and stopping
28
+ conditions. Keep required lifecycle and safety invariants explicit. Give the
29
+ receiver room to choose routine safe, reversible, in-scope steps. A contract must
30
+ carry authorized work through its requested terminal state, including required
31
+ repair and proof; a first pass or pending gate is not completion.
32
+
33
+ Remove older-model competence scaffolding, fixed recipes without a required
34
+ ordering constraint, broad reading rituals, stale environment facts, duplicate
35
+ policy, and unnecessary questionnaires. Preserve meaningful repository checks
36
+ and review gates through their canonical owners instead of reproducing them in
37
+ every skill. Use configuration for verbosity rather than generic style padding.
38
+
39
+ When creating or changing a skill's invocation boundary or conditional branches,
40
+ read [Skill mechanics](SKILL-MECHANICS.md). Other instruction changes do not need
41
+ that reference.
42
+
43
+ An instruction change is complete when the receiver can act within its authority,
44
+ recognize completion and escalation boundaries, and return sufficient evidence;
45
+ the effective context has no contradictory or duplicate rule for that meaning.
46
+ Validate changed behavior with meaningful proof and repository-required gates,
47
+ using the canonical testing policy rather than inventing extra test rituals.
@@ -0,0 +1,6 @@
1
+ interface:
2
+ display_name: "Writing instructions"
3
+ short_description: "Author and review GPT-6 model instructions."
4
+ default_prompt: "Use writing-instructions for this instruction change."
5
+ policy:
6
+ allow_implicit_invocation: true