holycodex 0.16.4-dev.73.1 → 0.16.4-dev.77.1
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 +52 -38
- package/dist/assets/plugin/plugin.json +1 -1
- package/dist/assets/plugin/skills/code-review/SKILL.md +5 -24
- package/dist/assets/plugin/skills/code-review/agents/openai.yaml +1 -1
- 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 +4 -10
- package/dist/assets/plugin/skills/context7-cli/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/debugging/SKILL.md +4 -23
- package/dist/assets/plugin/skills/debugging/agents/openai.yaml +1 -1
- 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 +7 -27
- package/dist/assets/plugin/skills/operations/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/plan/SKILL.md +6 -21
- package/dist/assets/plugin/skills/plan/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/plan-review/SKILL.md +5 -19
- package/dist/assets/plugin/skills/plan-review/agents/openai.yaml +1 -1
- package/dist/assets/plugin/skills/programming/SKILL.md +4 -18
- package/dist/assets/plugin/skills/programming/agents/openai.yaml +1 -1
- 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 +4 -15
- package/dist/assets/plugin/skills/rules/agents/openai.yaml +1 -1
- 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 +10 -26
- 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
|
@@ -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,9 @@
|
|
|
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.
|
|
12
|
-
|
|
13
|
-
Read the Assignment and current Intent through the semantic agent interface;
|
|
14
|
-
do not edit TOON files manually.
|
|
15
|
-
|
|
16
|
-
This fixed-point review is mandatory after implementation or a major codebase
|
|
17
|
-
change and must pass before Intent completion or any VCS operation. Apply the
|
|
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.
|
|
6
|
+
Inspect the integrated implementation for correctness, safety, maintainability,
|
|
7
|
+
compatibility, and mergeability. Check callers, contracts, tests, and generated
|
|
8
|
+
artifacts. Repair defects inside the review surface. Flag implementation-detail
|
|
9
|
+
tests and speculative abstractions when they affect the assigned change.
|
|
@@ -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
6
|
allow_implicit_invocation: true
|
|
@@ -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,8 @@
|
|
|
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
|
-
|
|
8
|
-
|
|
9
|
-
Owner: Librarian for research; Worker may use the assigned result. Boundary:
|
|
10
|
-
gather sourced claims, versions, dates, conflicts, and coverage limits without
|
|
11
|
-
editing the repository or deciding architecture.
|
|
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.
|
|
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.
|
|
@@ -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
6
|
allow_implicit_invocation: true
|
|
@@ -1,27 +1,8 @@
|
|
|
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
|
-
|
|
8
|
-
|
|
9
|
-
Owner: Worker within one delegated Assignment. Boundary: capture the smallest
|
|
10
|
-
failing input and trace, form an evidence-backed cause, apply the narrow fix,
|
|
11
|
-
and preserve unrelated behavior. Escalate competing causes or material
|
|
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.
|
|
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.
|
|
@@ -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
6
|
allow_implicit_invocation: true
|
|
@@ -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,11 @@
|
|
|
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
|
-
|
|
11
|
-
|
|
12
|
-
The Assignment must include the exact ref, SHA, required checks, and whether
|
|
13
|
-
the observation is development CI or release verification. Do not rerun,
|
|
14
|
-
cancel, approve, merge, push, tag, publish, deploy, or otherwise mutate
|
|
15
|
-
external state. Pending or running is never success; report terminal green,
|
|
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.
|
|
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.
|
|
@@ -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,10 @@
|
|
|
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
|
-
|
|
10
|
-
|
|
11
|
-
Create or read the current Intent with `holycodex-agent intent ...`, and create
|
|
12
|
-
the bounded delegated plan/review assignments before dispatch. A plan is optional for
|
|
13
|
-
trivial work. Do not edit TOON files manually.
|
|
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.
|
|
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.
|
|
@@ -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
6
|
allow_implicit_invocation: true
|
|
@@ -1,23 +1,9 @@
|
|
|
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
|
-
|
|
10
|
-
|
|
11
|
-
Read the current Plan with `holycodex-agent plan read`; never edit TOON files
|
|
12
|
-
directly. A revision is a semantic `plan revise` operation that archives the
|
|
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.
|
|
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.
|
|
@@ -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
6
|
allow_implicit_invocation: true
|
|
@@ -1,22 +1,8 @@
|
|
|
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.
|
|
11
|
-
|
|
12
|
-
Apply the repository surgical-mutation rule from `AGENTS.md`.
|
|
13
|
-
|
|
14
|
-
Return exactly one compact specialist outcome: `completed`, `blocked`,
|
|
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.
|
|
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.
|
|
@@ -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
6
|
allow_implicit_invocation: true
|
|
@@ -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,8 @@
|
|
|
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.
|
|
10
|
-
|
|
11
|
-
Apply the repository surgical-mutation rule from `AGENTS.md` to any repair.
|
|
12
|
-
Preserve unrelated work and stop for Root input before expanding scope.
|
|
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.
|
|
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.
|
|
@@ -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
6
|
allow_implicit_invocation: true
|
|
@@ -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.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Stop Slop"
|
|
3
3
|
short_description: "Edit assigned prose to remove predictable AI patterns."
|
|
4
|
-
default_prompt: "
|
|
4
|
+
default_prompt: "Open the assigned prose editing workflow for this invocation."
|
|
5
5
|
policy:
|
|
6
6
|
allow_implicit_invocation: true
|
|
@@ -1,28 +1,12 @@
|
|
|
1
1
|
# Testing quality
|
|
2
2
|
|
|
3
|
-
Use this reference when
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
1. the stable behavior it protects;
|
|
14
|
-
2. the real regression it catches;
|
|
15
|
-
3. why a less brittle boundary cannot protect it.
|
|
16
|
-
|
|
17
|
-
Remove or rewrite tests that freeze incidental counts, inventories, internal
|
|
18
|
-
paths, prompt or skill sizes, exact non-contract wording, irrelevant call order,
|
|
19
|
-
deleted names, broad repository shape, or one implementation strategy. Avoid
|
|
20
|
-
large internal snapshots and static source inspection when a behavior check
|
|
21
|
-
exists. Package-verification tests should consume the shipped artifact through
|
|
22
|
-
one supported outer boundary with minimal realistic setup, proving a meaningful
|
|
23
|
-
artifact behavior without duplicating the suite or crawling inventories.
|
|
24
|
-
|
|
25
|
-
Use proportional proof. A test that constrains more design than meaningful regression risk should not exist.
|
|
26
|
-
|
|
27
|
-
Completion: each retained test names the stable behavior and regression it
|
|
28
|
-
protects, and the chosen boundary is no more brittle than necessary.
|
|
3
|
+
Use this reference when assessing a test for a requested change. Identify the
|
|
4
|
+
stable behavior, contract, invariant, compatibility guarantee, safety property,
|
|
5
|
+
or meaningful failure mode it protects; the regression it catches; and why a
|
|
6
|
+
less brittle boundary cannot protect it.
|
|
7
|
+
|
|
8
|
+
Do not freeze incidental counts, inventories, internal paths, prompt or skill
|
|
9
|
+
wording, irrelevant call order, broad repository shape, or one implementation
|
|
10
|
+
strategy. Prefer observable typed or public boundaries. Package-verification
|
|
11
|
+
tests should consume the shipped artifact through one supported outer boundary
|
|
12
|
+
with minimal realistic setup, proving behavior without duplicating the suite.
|