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.
- package/README.md +9 -6
- package/dist/agent.js +35 -35
- package/dist/assets/plugin/plugin.json +1 -1
- package/dist/assets/plugin/skills/babysit-ci/SKILL.md +33 -0
- package/dist/assets/plugin/skills/babysit-ci/agents/openai.yaml +6 -0
- package/dist/assets/plugin/skills/commit/SKILL.md +5 -17
- package/dist/assets/plugin/skills/context7-cli/SKILL.md +8 -7
- package/dist/assets/plugin/skills/operations/SKILL.md +6 -12
- package/dist/assets/plugin/skills/plan-review/SKILL.md +3 -4
- package/dist/assets/plugin/skills/testing-quality.md +3 -4
- package/dist/assets/plugin/skills/writing-instructions/SKILL-MECHANICS.md +16 -0
- package/dist/assets/plugin/skills/writing-instructions/SKILL.md +47 -0
- package/dist/assets/plugin/skills/writing-instructions/agents/openai.yaml +6 -0
- package/dist/index.js +57 -57
- package/package.json +4 -4
- package/dist/assets/plugin/skills/writing-for-agents/SKILL-MECHANICS.md +0 -9
- package/dist/assets/plugin/skills/writing-for-agents/SKILL.md +0 -35
- package/dist/assets/plugin/skills/writing-for-agents/agents/openai.yaml +0 -6
- /package/dist/assets/plugin/skills/{writing-for-agents → writing-instructions}/LICENSE +0 -0
|
@@ -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.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: commit
|
|
3
|
-
description: Use when Root
|
|
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
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
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
|
|
3
|
+
description: Use when querying current technical documentation with Context7 CLI.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
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
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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
|
|
3
|
+
description: Use for a Worker.operations exact-ref/SHA observation Assignment.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
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.
|
|
7
|
-
|
|
8
|
-
|
|
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
|
-
|
|
15
|
-
|
|
16
|
-
|
|
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.
|