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.
Files changed (37) hide show
  1. package/README.md +5 -0
  2. package/dist/agent.js +54 -38
  3. package/dist/assets/plugin/plugin.json +2 -2
  4. package/dist/assets/plugin/skills/code-review/SKILL.md +10 -23
  5. package/dist/assets/plugin/skills/code-review/agents/openai.yaml +2 -2
  6. package/dist/assets/plugin/skills/commit/SKILL.md +6 -12
  7. package/dist/assets/plugin/skills/commit/agents/openai.yaml +1 -1
  8. package/dist/assets/plugin/skills/compress/SKILL.md +4 -15
  9. package/dist/assets/plugin/skills/compress/agents/openai.yaml +1 -1
  10. package/dist/assets/plugin/skills/context7-cli/SKILL.md +7 -9
  11. package/dist/assets/plugin/skills/context7-cli/agents/openai.yaml +2 -2
  12. package/dist/assets/plugin/skills/debugging/SKILL.md +7 -22
  13. package/dist/assets/plugin/skills/debugging/agents/openai.yaml +2 -2
  14. package/dist/assets/plugin/skills/grill-me/SKILL.md +21 -0
  15. package/dist/assets/plugin/skills/grill-me/agents/openai.yaml +6 -0
  16. package/dist/assets/plugin/skills/handoff/SKILL.md +4 -13
  17. package/dist/assets/plugin/skills/handoff/agents/openai.yaml +1 -1
  18. package/dist/assets/plugin/skills/operations/SKILL.md +11 -26
  19. package/dist/assets/plugin/skills/operations/agents/openai.yaml +1 -1
  20. package/dist/assets/plugin/skills/plan/SKILL.md +9 -20
  21. package/dist/assets/plugin/skills/plan/agents/openai.yaml +2 -2
  22. package/dist/assets/plugin/skills/plan-review/SKILL.md +7 -18
  23. package/dist/assets/plugin/skills/plan-review/agents/openai.yaml +2 -2
  24. package/dist/assets/plugin/skills/programming/SKILL.md +7 -17
  25. package/dist/assets/plugin/skills/programming/agents/openai.yaml +2 -2
  26. package/dist/assets/plugin/skills/refactor/SKILL.md +4 -18
  27. package/dist/assets/plugin/skills/refactor/agents/openai.yaml +1 -1
  28. package/dist/assets/plugin/skills/rules/SKILL.md +7 -14
  29. package/dist/assets/plugin/skills/rules/agents/openai.yaml +2 -2
  30. package/dist/assets/plugin/skills/stop-slop/SKILL.md +5 -42
  31. package/dist/assets/plugin/skills/stop-slop/agents/openai.yaml +1 -1
  32. package/dist/assets/plugin/skills/testing-quality.md +13 -24
  33. package/dist/assets/plugin/skills/writing-for-agents/SKILL-MECHANICS.md +6 -16
  34. package/dist/assets/plugin/skills/writing-for-agents/SKILL.md +29 -55
  35. package/dist/assets/plugin/skills/writing-for-agents/agents/openai.yaml +1 -1
  36. package/dist/index.js +69 -53
  37. package/package.json +2 -2
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "holycodex",
3
- "version": "0.16.4",
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. Read the generated Root developer instructions and repository AGENTS.md, apply installed skills as branch procedures, and use holycodex-agent semantic operations for durable Intent, Plan, and Assignment state."
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 once after code or manifest implementation when Root needs adversarial review and bounded repair to a fixed point.
3
+ description: Use after implementation when Root needs adversarial code review and bounded repair to a fixed point.
4
4
  ---
5
5
 
6
- Owner: Reviewer within one delegated Assignment. Root must dispatch this skill
7
- after implementation or manifest work and record its structured result through
8
- `holycodex-agent assignment result`; the Reviewer never owns global lifecycle,
9
- material decisions, or Git/VCS. Inspect the actual integrated result to a
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
- 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.
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: "After implementation, inspect the delegated Assignment result once, apply the repository surgical-mutation rule, repair reviewer-owned defects to a fixed point, and return structured evidence for Root's readiness judgment."
4
+ default_prompt: "Open the code review workflow for this invocation."
5
5
  policy:
6
- allow_implicit_invocation: true
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
- Owner: Root. This is the only unconditional direct execution exception:
7
- perform all Git/VCS inspection and mutation. Verify the exact diff scope,
8
- required local proof, temporary/generated-artifact cleanup, and ignore coverage
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. Apply the repository
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/pushes the exact approved ref, then delegates
20
- terminal CI observation to `Worker.operations` with the exact ref and SHA.
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: "When Root uses the Git/VCS direct exception, apply the repository surgical-mutation rule, verify exact scope, required proof, ignore coverage, and secret exclusions, create only that commit, ask for approval before remote mutation, and delegate terminal exact-ref verification."
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 Root assigns text that must be shortened; preserve meaning, constraints, technical terms, and voice.
3
+ description: Use when assigned text must be shortened without changing its contract or voice.
4
4
  ---
5
5
 
6
- Owner: Worker within one delegated Assignment. Boundary: remove repetition
7
- without changing requirements, technical terms, product voice, or required
8
- evidence. Read the Assignment through the semantic agent interface; do not edit
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: "When Root assigns a bounded compression Assignment, apply the repository surgical-mutation rule, produce one constraint-equivalent draft, and return completed, blocked, needs_root_input, or failed evidence for holycodex-agent."
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 first when Root assigns a current library, framework, SDK, or API fact; use a network research route only for releases, dates, gaps, or corroboration.
3
+ description: Use when a current library, framework, SDK, or API fact needs authoritative documentation.
4
4
  ---
5
5
 
6
- Use the current documentation route before relying on memory, because APIs
7
- and tool behavior change and repository evidence cannot establish currency.
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
- 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.
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: "When Root assigns a current library or API fact, use the documentation route first and return sourced evidence with coverage limits."
4
+ default_prompt: "Open the current documentation lookup workflow for this invocation."
5
5
  policy:
6
- allow_implicit_invocation: true
6
+ allow_implicit_invocation: false
@@ -1,27 +1,12 @@
1
1
  ---
2
2
  name: debugging
3
- description: Use when Root assigns a reproducible crash, wrong result, regression, hang, race, leak, or slowdown; isolate and prove the narrow repair.
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. A stable red case distinguishes
7
- cause from symptom and makes the repair checkable.
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
- 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.
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: "When Root assigns a bounded defect Assignment, apply the repository surgical-mutation rule, reproduce it, isolate its cause, make the narrow repair, prove the regression is gone, and return a structured outcome for holycodex-agent."
4
+ default_prompt: "Open the debugging workflow for this invocation."
5
5
  policy:
6
- allow_implicit_invocation: true
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.
@@ -0,0 +1,6 @@
1
+ interface:
2
+ display_name: "Grill me"
3
+ short_description: "Ask only material, dependency-ordered clarification questions."
4
+ default_prompt: "Open the material-choice clarification workflow for this invocation."
5
+ policy:
6
+ allow_implicit_invocation: true
@@ -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
- Handoff is a projection/export only, not persistent workflow state. Read the
7
- current Intent, Plan, and Assignments through `holycodex-agent`; never create a
8
- handoff file or duplicate lifecycle, owner, blocker, evidence, or resume state.
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: "When Root needs a resume projection, read current Intent, Plan, and Assignments through holycodex-agent and export one redacted projection without creating duplicate state."
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 when Root assigns exact-ref CI or release observation; discover the repository topology and report terminal external evidence without mutation.
3
+ description: Use for exact-ref CI or release observation through terminal evidence.
4
4
  ---
5
5
 
6
- Owner: Worker.operations within one delegated Assignment. Boundary: observe
7
- only the exact approved ref and SHA after Root's VCS action. First discover the
8
- repository's actual topology:
9
- separate development/release gates, one combined pipeline, or no formal
10
- separation. Do not assume GitHub, a branch name, or a provider.
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
- 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.
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: "Observe the assigned exact ref and SHA, discover the repository topology, report completed terminal CI or release evidence (pending is never success), return blocked or needs_root_input when unavailable, never mutate external state, and apply the repository surgical-mutation rule to any authorized local write."
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 Root faces unresolved architecture, scope, coordination, or material risk before work begins; produce the implementation-ready decision record.
3
+ description: Use when unresolved architecture, scope, coordination, or material risk requires an implementation-ready Plan.
4
4
  ---
5
5
 
6
- Owner: Root. Boundary: identify alternatives, constraints, risks, route,
7
- acceptance evidence, exclusions, and recovery, then persist the semantic Plan
8
- through `holycodex-agent plan revise`. Specialists may supply facts but may not
9
- decide the outcome.
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
- 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.
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: "When Root faces an unresolved material choice, persist an implementation-ready Plan through holycodex-agent, covering scope, route, risk, proof, and delegated Assignments; ask for material input and apply the repository surgical-mutation rule."
4
+ default_prompt: "Open the planning workflow for this invocation."
5
5
  policy:
6
- allow_implicit_invocation: true
6
+ allow_implicit_invocation: false
@@ -1,23 +1,12 @@
1
1
  ---
2
2
  name: plan-review
3
- description: Use when Root has a complete plan that needs adversarial review; check feasibility, order, risk, and proof to a fixed point.
3
+ description: Use when a complete Plan needs adversarial feasibility, order, risk, and proof review.
4
4
  ---
5
5
 
6
- Owner: Reviewer. Boundary: inspect the complete Plan once to a fixed point;
7
- repair only reviewer-owned plan defects. Return material product or
8
- architecture choices to Root. Root must delegate this review as an Assignment
9
- and record its structured result through `holycodex-agent assignment result`.
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
- 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.
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: "When Root has a complete Plan, inspect it once, apply only surgical reviewer-owned repairs to a fixed point, and return a structured Assignment result for holycodex-agent."
4
+ default_prompt: "Open the plan review workflow for this invocation."
5
5
  policy:
6
- allow_implicit_invocation: true
6
+ allow_implicit_invocation: false
@@ -1,22 +1,12 @@
1
1
  ---
2
2
  name: programming
3
- description: Use when Root has decided a seam and assigns bounded implementation, fixes, tests, or manifests with known acceptance behavior.
3
+ description: Use when Root has decided a bounded implementation seam with known acceptance behavior.
4
4
  ---
5
5
 
6
- Owner: Worker within one delegated Assignment. Read the Assignment and current
7
- Intent through the semantic agent interface; do not edit TOON files manually.
8
- Implement the decided seam inside the assigned files, and do not expand its
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
- 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.
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: "When Root assigns a bounded Assignment, apply the repository surgical-mutation rule, implement only that seam, add focused proof, inspect changed files, and return completed, blocked, needs_root_input, or failed evidence for holycodex-agent."
4
+ default_prompt: "Open the bounded programming workflow for this invocation."
5
5
  policy:
6
- allow_implicit_invocation: true
6
+ allow_implicit_invocation: false
@@ -1,22 +1,8 @@
1
1
  ---
2
2
  name: refactor
3
- description: Use when Root has decided one seam needs restructuring; preserve behavior, ownership, and interfaces.
3
+ description: Use when one decided seam needs restructuring while preserving behavior and interfaces.
4
4
  ---
5
5
 
6
- Owner: Worker within one delegated Assignment. Read the current Assignment
7
- through the semantic agent interface; do not edit TOON files manually. Restructure
8
- only the decided seam. Trace its callers before changing a shared root cause,
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: "When Root assigns a bounded refactor Assignment, apply the repository surgical-mutation rule, preserve behavior and interfaces, inspect changed files, prove the seam, and return completed, blocked, needs_root_input, or failed evidence for holycodex-agent."
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 Root assigns a repository rule discovery, validation, or application failure; trace the owning rule path.
3
+ description: Use when a repository rule needs discovery, validation, or diagnosis of an application failure.
4
4
  ---
5
5
 
6
- Owner: Worker within one delegated Assignment. Boundary: inspect the owning
7
- rule loader and preserve deduplication, limits, caching, trust boundaries, and
8
- rule ownership. Read the Assignment through the semantic agent interface; do
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
- 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.
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: "When Root assigns a bounded rule Assignment, apply the repository surgical-mutation rule, inspect the owning seam, and return completed, blocked, needs_root_input, or failed evidence for holycodex-agent."
4
+ default_prompt: "Open the repository rules workflow for this invocation."
5
5
  policy:
6
- allow_implicit_invocation: true
6
+ allow_implicit_invocation: false
@@ -1,46 +1,9 @@
1
1
  ---
2
2
  name: stop-slop
3
- description: Use when Root assigns prose to draft, edit, or review; remove predictable AI writing patterns while preserving the requested voice.
3
+ description: Use when assigned prose should lose predictable AI writing patterns while preserving voice.
4
4
  ---
5
5
 
6
- Owner: Worker or Reviewer within the assigned prose surface. Boundary: edit
7
- only the assigned text, preserve meaning and product voice, and use the linked
8
- references for phrase, structure, and example branches when needed.
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.