holycodex 0.16.4 → 0.16.5
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 +5 -0
- package/dist/agent.js +54 -38
- package/dist/assets/plugin/plugin.json +2 -2
- package/dist/assets/plugin/skills/code-review/SKILL.md +10 -23
- package/dist/assets/plugin/skills/code-review/agents/openai.yaml +2 -2
- package/dist/assets/plugin/skills/commit/SKILL.md +6 -12
- package/dist/assets/plugin/skills/commit/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/compress/SKILL.md +4 -15
- package/dist/assets/plugin/skills/compress/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/context7-cli/SKILL.md +7 -9
- package/dist/assets/plugin/skills/context7-cli/agents/openai.yaml +2 -2
- package/dist/assets/plugin/skills/debugging/SKILL.md +7 -22
- package/dist/assets/plugin/skills/debugging/agents/openai.yaml +2 -2
- package/dist/assets/plugin/skills/grill-me/SKILL.md +21 -0
- package/dist/assets/plugin/skills/grill-me/agents/openai.yaml +6 -0
- package/dist/assets/plugin/skills/handoff/SKILL.md +4 -13
- package/dist/assets/plugin/skills/handoff/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/operations/SKILL.md +11 -26
- package/dist/assets/plugin/skills/operations/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/plan/SKILL.md +9 -20
- package/dist/assets/plugin/skills/plan/agents/openai.yaml +2 -2
- package/dist/assets/plugin/skills/plan-review/SKILL.md +7 -18
- package/dist/assets/plugin/skills/plan-review/agents/openai.yaml +2 -2
- package/dist/assets/plugin/skills/programming/SKILL.md +7 -17
- package/dist/assets/plugin/skills/programming/agents/openai.yaml +2 -2
- package/dist/assets/plugin/skills/refactor/SKILL.md +4 -18
- package/dist/assets/plugin/skills/refactor/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/rules/SKILL.md +7 -14
- package/dist/assets/plugin/skills/rules/agents/openai.yaml +2 -2
- package/dist/assets/plugin/skills/stop-slop/SKILL.md +5 -42
- package/dist/assets/plugin/skills/stop-slop/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/testing-quality.md +13 -24
- package/dist/assets/plugin/skills/writing-for-agents/SKILL-MECHANICS.md +6 -16
- package/dist/assets/plugin/skills/writing-for-agents/SKILL.md +29 -55
- package/dist/assets/plugin/skills/writing-for-agents/agents/openai.yaml +1 -1
- package/dist/index.js +69 -53
- package/package.json +2 -2
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "holycodex",
|
|
3
|
-
"version": "0.16.
|
|
3
|
+
"version": "0.16.5",
|
|
4
4
|
"description": "Root-directed capabilities and deterministic installed assets for HolyCodex.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "David Basile Filho",
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"Code Intelligence"
|
|
27
27
|
],
|
|
28
28
|
"defaultPrompt": [
|
|
29
|
-
"Activate HolyCodex for this task.
|
|
29
|
+
"Activate HolyCodex capabilities for this task."
|
|
30
30
|
]
|
|
31
31
|
}
|
|
32
32
|
}
|
|
@@ -1,28 +1,15 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: code-review
|
|
3
|
-
description: Use
|
|
3
|
+
description: Use after implementation when Root needs adversarial code review and bounded repair to a fixed point.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
fixed point before Root judges readiness. Apply
|
|
11
|
-
[testing quality](../testing-quality.md) when judging new or modified tests.
|
|
6
|
+
Inspect the integrated implementation against the receiver-visible `Reviewer.code`
|
|
7
|
+
contract. Check callers, contracts, tests, and generated artifacts. Repair
|
|
8
|
+
defects inside the review surface and return the findings, repairs, checks, and
|
|
9
|
+
remaining risk.
|
|
12
10
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
repository surgical-mutation rule from `AGENTS.md` to reviewer repairs.
|
|
19
|
-
|
|
20
|
-
Inspect the assigned diff, callers, contracts, tests, compatibility, and
|
|
21
|
-
artifact. Repair defects inside the review surface, verify each repair, and
|
|
22
|
-
repeat until the review reaches a fixed point.
|
|
23
|
-
|
|
24
|
-
Return `completed`, `blocked`, `needs_root_input`, or `failed` with findings,
|
|
25
|
-
repaired paths, verification, and residual risk. Flag speculative
|
|
26
|
-
abstractions, pointless file splits, oversized changes,
|
|
27
|
-
unclear dependency direction, and tests that protect implementation detail.
|
|
28
|
-
Confirm incidental generated output is absent before stopping.
|
|
11
|
+
Root dispatches this procedure to the mandatory native `Reviewer.code` route
|
|
12
|
+
after implementation or a major code change and before completion or VCS. The
|
|
13
|
+
canonical receiver contract owns the quality and mergeability criteria; this
|
|
14
|
+
skill supplies only the review procedure. Root does not perform code review or
|
|
15
|
+
repair locally.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Code review"
|
|
3
3
|
short_description: "Review one implementation result to a fixed point."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the code review workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
|
-
allow_implicit_invocation:
|
|
6
|
+
allow_implicit_invocation: false
|
|
@@ -3,21 +3,15 @@ name: commit
|
|
|
3
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.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
before staging. Preserve unrelated work and ensure environment secrets,
|
|
10
|
-
credentials, and private release material are absent from the staged file list.
|
|
11
|
-
Do not use this exception for implementation, testing, review, or release
|
|
12
|
-
verification; delegate those as Assignments and persist their outcomes through
|
|
13
|
-
`holycodex-agent assignment result`.
|
|
6
|
+
Root uses this workflow after exact scope and local proof are settled. Verify
|
|
7
|
+
the diff, generated-artifact cleanup, ignore coverage, and staged secret
|
|
8
|
+
exclusions before creating the local commit.
|
|
14
9
|
|
|
15
10
|
Require a passing Reviewer.code fixed-point result after implementation or a
|
|
16
|
-
major codebase change before this VCS exception is used.
|
|
17
|
-
surgical-mutation rule to VCS operations and staging.
|
|
11
|
+
major codebase change before this VCS exception is used.
|
|
18
12
|
|
|
19
|
-
After integration, Root commits
|
|
20
|
-
|
|
13
|
+
After integration, Root commits the exact approved ref and gives its exact ref
|
|
14
|
+
and SHA to `Worker.operations` for terminal CI observation.
|
|
21
15
|
Discover the repository's actual development/release topology first; never
|
|
22
16
|
assume GitHub, branch names, or that pending is success. Delegate fixes for
|
|
23
17
|
failures, then repeat integration, commit, push, and observation until the
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Commit"
|
|
3
3
|
short_description: "Create one local commit with exact scope proof."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the commit workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
6
|
allow_implicit_invocation: false
|
|
@@ -1,19 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: compress
|
|
3
|
-
description: Use when
|
|
3
|
+
description: Use when assigned text must be shortened without changing its contract or voice.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
TOON files manually.
|
|
10
|
-
|
|
11
|
-
Apply the repository surgical-mutation rule from `AGENTS.md`; preserve
|
|
12
|
-
unrelated work and stop for Root input before expanding scope.
|
|
13
|
-
|
|
14
|
-
Completion: the compressed text is constraint-equivalent to the input and any
|
|
15
|
-
unresolvable ambiguity is explicit. Return one outcome from `completed`,
|
|
16
|
-
`blocked`, `needs_root_input`, or `failed` with changed paths, proof, and
|
|
17
|
-
remaining risk. Root records the result through `holycodex-agent assignment
|
|
18
|
-
result`; the Worker does not mutate global Intent lifecycle, make material
|
|
19
|
-
decisions, or perform Git/VCS.
|
|
6
|
+
Shorten only the assigned text. Preserve meaning, constraints, technical terms,
|
|
7
|
+
product voice, and required evidence. The result is complete when it is
|
|
8
|
+
constraint-equivalent and any ambiguity that cannot be preserved is explicit.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Compress"
|
|
3
3
|
short_description: "Shorten assigned text without changing its contract or voice."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the compression workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
6
|
allow_implicit_invocation: true
|
|
@@ -1,14 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: context7-cli
|
|
3
|
-
description: Use
|
|
3
|
+
description: Use when a current library, framework, SDK, or API fact needs authoritative documentation.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
Use
|
|
7
|
-
|
|
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.
|
|
8
9
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
Completion: every requested current fact has an authoritative locator or an
|
|
14
|
-
explicit coverage gap, and no unsupported external claim is used as proof.
|
|
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.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Context7 CLI"
|
|
3
3
|
short_description: "Find assigned current library and API documentation first."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the current documentation lookup workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
|
-
allow_implicit_invocation:
|
|
6
|
+
allow_implicit_invocation: false
|
|
@@ -1,27 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: debugging
|
|
3
|
-
description: Use
|
|
3
|
+
description: Use for a reproducible crash, wrong result, regression, hang, race, leak, or slowdown.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
Reproduce the defect before changing code.
|
|
7
|
-
|
|
6
|
+
Reproduce the defect before changing code. Capture the smallest failing input
|
|
7
|
+
and trace, identify the evidence-backed cause, make the narrow repair, and prove
|
|
8
|
+
the regression is gone. Escalate competing causes or a material redesign.
|
|
8
9
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
redesign. Root creates/starts the Assignment and records the result through
|
|
13
|
-
`holycodex-agent assignment result`; the Worker must not mutate Intent state or
|
|
14
|
-
edit TOON files manually.
|
|
15
|
-
|
|
16
|
-
Apply the repository surgical-mutation rule from `AGENTS.md`.
|
|
17
|
-
|
|
18
|
-
Discover and use the repository-specific formatter, linter, typecheck, and
|
|
19
|
-
validation commands before and after the repair. Start with the smallest
|
|
20
|
-
relevant local proof and expand only when the defect crosses that boundary or
|
|
21
|
-
the release gate requires it; report unavailable commands rather than
|
|
22
|
-
inventing replacements.
|
|
23
|
-
|
|
24
|
-
Return one outcome from `completed`, `blocked`, `needs_root_input`, or
|
|
25
|
-
`failed`, including reproduction, cause, repair proof, and remaining
|
|
26
|
-
uncertainty. Completion requires the failure to be reproduced, the cause to be
|
|
27
|
-
supported by repository evidence, and the fix and regression proof to pass.
|
|
10
|
+
Root dispatches this procedure to the canonical `Worker.debugging` route as a
|
|
11
|
+
bounded repair Assignment. Root does not reproduce, repair, or test the defect
|
|
12
|
+
locally; material redesign returns to Root for a new decision.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Debugging"
|
|
3
3
|
short_description: "Reproduce and repair one observable defect."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the debugging workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
|
-
allow_implicit_invocation:
|
|
6
|
+
allow_implicit_invocation: false
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: grill-me
|
|
3
|
+
description: Use when an unspecified choice has multiple reasonable outcomes that could materially change the work.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Grill me
|
|
7
|
+
|
|
8
|
+
Use this skill only for a material unresolved choice involving architecture,
|
|
9
|
+
behavior, UX, compatibility, dependencies, cost, security, external effects,
|
|
10
|
+
or another meaningful user-visible result. Infer obvious safe defaults and
|
|
11
|
+
continue without questioning routine omissions.
|
|
12
|
+
|
|
13
|
+
Before asking, finish authorized discovery and reversible preparation that can
|
|
14
|
+
narrow the choice without deciding it. Ask only for the earliest unresolved
|
|
15
|
+
choice required by the next executable phase. After the answer, continue the
|
|
16
|
+
discovery and ask the next dependent question only if it remains material.
|
|
17
|
+
Avoid questionnaires about later phases whose relevance may change.
|
|
18
|
+
|
|
19
|
+
Persist the answer through the current Intent or Plan state model. Return to
|
|
20
|
+
Root with the selected decision, its scope, and the evidence or dependency it
|
|
21
|
+
unblocked; use `needs_root_input` when the choice remains unresolved.
|
|
@@ -3,16 +3,7 @@ name: handoff
|
|
|
3
3
|
description: Use when a caller needs a redacted projection of current Intent state for resume or export.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
Owner: Root. Boundary: request a compact redacted projection containing the
|
|
11
|
-
current Intent reference, Plan revision, Assignment statuses, evidence,
|
|
12
|
-
blockers, remaining risk, and exact next action; omit secrets, raw prompts,
|
|
13
|
-
transcripts, and unchanged narration. The authoritative state remains under
|
|
14
|
-
`.holycodex/{slug}-{short-id}/` and all mutations use semantic agent CLI
|
|
15
|
-
operations.
|
|
16
|
-
|
|
17
|
-
Completion: one bounded, redacted projection is ready for the receiving owner;
|
|
18
|
-
no second source of truth exists.
|
|
6
|
+
Produce one compact projection of current Intent, Plan, and Assignment status,
|
|
7
|
+
evidence, blockers, remaining risk, and the exact next action. Omit secrets,
|
|
8
|
+
raw prompts, transcripts, and unchanged narration. Handoff is an export view;
|
|
9
|
+
the semantic state remains authoritative.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Handoff"
|
|
3
3
|
short_description: "Export a redacted projection of current Intent state."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the handoff workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
6
|
allow_implicit_invocation: false
|
|
@@ -1,31 +1,16 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: operations
|
|
3
|
-
description: Use
|
|
3
|
+
description: Use for exact-ref CI or release observation through terminal evidence.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
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.
|
|
11
12
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
terminal failure, or an exact unavailable/ambiguous blocker.
|
|
17
|
-
|
|
18
|
-
Apply the repository surgical-mutation rule from `AGENTS.md` to any local
|
|
19
|
-
write, and stop for Root input before expanding scope. Do not edit TOON files manually;
|
|
20
|
-
do not create standalone handoff, Decision, or blocker files.
|
|
21
|
-
|
|
22
|
-
Return one outcome from `completed`, `blocked`, `needs_root_input`, or
|
|
23
|
-
`failed`, with discovered topology, exact ref/SHA, check or release results,
|
|
24
|
-
source references, and remaining risk. Root records it with
|
|
25
|
-
`holycodex-agent assignment result` and decides whether to delegate a fix and
|
|
26
|
-
repeats the post-integration cycle. A terminal green development result permits
|
|
27
|
-
Root to proceed to an authorized release action; after that action, observe the
|
|
28
|
-
release against its exact ref/SHA. If the repository has no distinct release
|
|
29
|
-
gate, report that topology explicitly and never invent a second gate. A
|
|
30
|
-
terminal failure returns control to Root for a bounded fix; this Assignment
|
|
31
|
-
never repairs, retries, approves, or mutates external state.
|
|
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.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Operations"
|
|
3
3
|
short_description: "Observe exact-ref CI or release state to terminal evidence."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the terminal operations observation workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
6
|
allow_implicit_invocation: false
|
|
@@ -1,25 +1,14 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: plan
|
|
3
|
-
description: Use when
|
|
3
|
+
description: Use when unresolved architecture, scope, coordination, or material risk requires an implementation-ready Plan.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
6
|
+
Resolve the current material choices into an implementation-ready Plan with
|
|
7
|
+
scope, owners, seams, data and control flow, policy, recovery, compatibility,
|
|
8
|
+
acceptance evidence, and a bounded proof route. Keep planning proportional:
|
|
9
|
+
trivial work can proceed without a Plan. Persist the canonical revision through
|
|
10
|
+
the semantic Plan operation.
|
|
10
11
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
Use `request_user_input` before seeking workflow Plan approval and whenever
|
|
16
|
-
ambiguity or missing material input blocks safe progress; persist that condition as
|
|
17
|
-
`needs_root_input` on the Intent or Plan. Apply the repository
|
|
18
|
-
surgical-mutation rule from `AGENTS.md`.
|
|
19
|
-
|
|
20
|
-
Persist the plan operation as a compact `completed`, `blocked`,
|
|
21
|
-
`needs_root_input`, or `failed` result with proof and remaining risk.
|
|
22
|
-
|
|
23
|
-
Completion: Root has an implementation-ready plan naming scope, owners and
|
|
24
|
-
seams, data and control flow, policy, recovery, tests, compatibility, the
|
|
25
|
-
preferred shape, and a bounded proof route.
|
|
12
|
+
Root owns material choices and dispatches this procedure through the native
|
|
13
|
+
`Reviewer.plan` route when adversarial plan review is needed; the skill never
|
|
14
|
+
authorizes Root to inspect or implement the repository locally.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Plan"
|
|
3
3
|
short_description: "Resolve material scope and architecture choices before work."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the planning workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
|
-
allow_implicit_invocation:
|
|
6
|
+
allow_implicit_invocation: false
|
|
@@ -1,23 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: plan-review
|
|
3
|
-
description: Use when
|
|
3
|
+
description: Use when a complete Plan needs adversarial feasibility, order, risk, and proof review.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
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.
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
prior canonical Plan before replacement.
|
|
14
|
-
|
|
15
|
-
Apply the repository surgical-mutation rule from `AGENTS.md` to any repair. If
|
|
16
|
-
a material choice is unresolved, return `needs_root_input` rather than deciding
|
|
17
|
-
it.
|
|
18
|
-
|
|
19
|
-
Return `completed`, `blocked`, `needs_root_input`, or `failed` with findings,
|
|
20
|
-
proof, and remaining risk; Root records that outcome on the Assignment.
|
|
21
|
-
|
|
22
|
-
Completion: the plan is complete with proof, blocked with evidence, or
|
|
23
|
-
explicitly needs a Root decision.
|
|
11
|
+
Root dispatches this procedure as a bounded Assignment to `Reviewer.plan` and
|
|
12
|
+
consumes its evidence; Root does not perform plan review locally.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Plan review"
|
|
3
3
|
short_description: "Review one complete plan to a fixed point."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the plan review workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
|
-
allow_implicit_invocation:
|
|
6
|
+
allow_implicit_invocation: false
|
|
@@ -1,22 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: programming
|
|
3
|
-
description: Use when Root has decided a
|
|
3
|
+
description: Use when Root has decided a bounded implementation seam with known acceptance behavior.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
scope. Inspect the callers and tests needed to preserve behavior and typed
|
|
10
|
-
boundaries, then add focused proof at the least brittle observable boundary.
|
|
6
|
+
Implement only the decided seam. Inspect its callers and typed boundaries
|
|
7
|
+
before implementation, and add proof at the least brittle observable boundary
|
|
8
|
+
when the acceptance behavior requires it.
|
|
11
9
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
`needs_root_input`, or `failed`, with changed paths, checks and results,
|
|
16
|
-
evidence, and remaining risk. Root records it with
|
|
17
|
-
`holycodex-agent assignment result`; the Worker never changes global Intent
|
|
18
|
-
lifecycle, makes material decisions, or performs Git/VCS.
|
|
19
|
-
|
|
20
|
-
Discover and use the repository's own validation commands and run the smallest
|
|
21
|
-
relevant check first; broaden when the seam or release gate requires it.
|
|
22
|
-
Inspect changed files and remove incidental generated output before stopping.
|
|
10
|
+
Root dispatches this procedure through the native `Worker.implementation`,
|
|
11
|
+
`Worker.integration`, or `Worker.mechanical` route selected by the Assignment.
|
|
12
|
+
Root does not implement or test the seam locally.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Programming"
|
|
3
3
|
short_description: "Implement one decided seam with proportional proof."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the bounded programming workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
|
-
allow_implicit_invocation:
|
|
6
|
+
allow_implicit_invocation: false
|
|
@@ -1,22 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: refactor
|
|
3
|
-
description: Use when
|
|
3
|
+
description: Use when one decided seam needs restructuring while preserving behavior and interfaces.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
preserve public behavior and interfaces, and keep the smallest cohesive change.
|
|
10
|
-
|
|
11
|
-
Apply the repository surgical-mutation rule from `AGENTS.md`.
|
|
12
|
-
Preserve unrelated work and stop for Root input before expanding scope.
|
|
13
|
-
|
|
14
|
-
Discover the repository's own validation commands and run the smallest relevant
|
|
15
|
-
behavior-locked check first; broaden when the changed boundary or release gate
|
|
16
|
-
requires it. Inspect changed files and remove incidental generated output
|
|
17
|
-
before stopping.
|
|
18
|
-
|
|
19
|
-
Return one outcome from `completed`, `blocked`, `needs_root_input`, or `failed`,
|
|
20
|
-
with changed paths, checks and results, evidence, and remaining risk. The Worker
|
|
21
|
-
does not mutate global Intent lifecycle, make material decisions, or perform
|
|
22
|
-
Git/VCS; Root records the result through `holycodex-agent assignment result`.
|
|
6
|
+
Restructure only the decided seam. Trace callers before changing a shared root
|
|
7
|
+
cause and preserve public behavior and interfaces. Verify the behavior boundary
|
|
8
|
+
after the refactor.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Refactor"
|
|
3
3
|
short_description: "Restructure one decided seam while preserving its contract."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the bounded refactor workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
6
|
allow_implicit_invocation: true
|
|
@@ -1,19 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: rules
|
|
3
|
-
description: Use when
|
|
3
|
+
description: Use when a repository rule needs discovery, validation, or diagnosis of an application failure.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
not edit TOON files manually.
|
|
6
|
+
Trace the owning rule loader and its limits, caching, trust boundary, and
|
|
7
|
+
deduplication. State the observed failure, the owning policy, and the evidence
|
|
8
|
+
that proves the rule path or exact blocker.
|
|
10
9
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
Completion: the rule path, policy, observed failure, and verification evidence
|
|
15
|
-
are explicit, or the exact blocker is returned. Return one outcome from
|
|
16
|
-
`completed`, `blocked`, `needs_root_input`, or `failed` with changed paths,
|
|
17
|
-
proof, and remaining risk. Root records the result through
|
|
18
|
-
`holycodex-agent assignment result`; the Worker does not mutate global Intent
|
|
19
|
-
lifecycle, make material decisions, or perform Git/VCS.
|
|
10
|
+
Root dispatches repository inspection to an Explorer Assignment when this
|
|
11
|
+
procedure needs source facts; the skill never authorizes Root to inspect the
|
|
12
|
+
repository locally.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Rules"
|
|
3
3
|
short_description: "Trace one repository rule discovery or application failure."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the repository rules workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
|
-
allow_implicit_invocation:
|
|
6
|
+
allow_implicit_invocation: false
|
|
@@ -1,46 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: stop-slop
|
|
3
|
-
description: Use when
|
|
3
|
+
description: Use when assigned prose should lose predictable AI writing patterns while preserving voice.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
The prose edit is one delegated Assignment. Read its scope and constraints
|
|
11
|
-
through the semantic agent interface; do not edit TOON files manually. Apply the
|
|
12
|
-
repository surgical-mutation rule from `AGENTS.md`. Preserve unrelated work
|
|
13
|
-
and stop for Root input before expanding scope.
|
|
14
|
-
|
|
15
|
-
# Stop Slop
|
|
16
|
-
|
|
17
|
-
Remove predictable AI writing patterns from prose.
|
|
18
|
-
|
|
19
|
-
## Core rules
|
|
20
|
-
|
|
21
|
-
1. Cut filler phrases, emphasis crutches, and adverbs. See
|
|
22
|
-
[phrases](references/phrases.md).
|
|
23
|
-
2. Break formulaic structures, binary contrasts, negative listings, dramatic
|
|
24
|
-
fragments, rhetorical setups, and false agency. See
|
|
25
|
-
[structures](references/structures.md).
|
|
26
|
-
3. Use active voice and name the person doing the work.
|
|
27
|
-
4. Replace vague declarations and lazy extremes with specific facts.
|
|
28
|
-
5. Prefer "you" and concrete details over distant abstractions.
|
|
29
|
-
6. Vary sentence length and paragraph rhythm. Avoid em dashes.
|
|
30
|
-
7. State facts directly without softening or hand-holding.
|
|
31
|
-
8. Rewrite pull-quote language as plain language.
|
|
32
|
-
|
|
33
|
-
Before delivery, check for adverbs, passive voice, inanimate actors, vague
|
|
34
|
-
claims, throat-clearing, binary contrasts, meta-joiners, em dashes, and repeated
|
|
35
|
-
rhythm. Use [examples](references/examples.md) to calibrate edits.
|
|
36
|
-
|
|
37
|
-
Completion: the assigned prose is direct, specific, constraint-equivalent,
|
|
38
|
-
and reviewed against the relevant references; any deliberate voice tradeoff is
|
|
39
|
-
recorded. Return one outcome from `completed`, `blocked`, `needs_root_input`, or
|
|
40
|
-
`failed` with changed paths, proof, and remaining risk. Root records the result
|
|
41
|
-
through `holycodex-agent assignment result`; do not mutate global Intent
|
|
42
|
-
lifecycle or perform Git/VCS.
|
|
43
|
-
|
|
44
|
-
## License
|
|
45
|
-
|
|
46
|
-
MIT
|
|
6
|
+
Edit only the assigned prose. Remove filler, formulaic structure, vague claims,
|
|
7
|
+
passive voice, and repeated rhythm while preserving meaning and voice. Use the
|
|
8
|
+
linked [phrase](references/phrases.md), [structure](references/structures.md),
|
|
9
|
+
and [example](references/examples.md) references when needed.
|