Skip to content

fix(agents): resolve lib scripts via {skill-root}/lib - #4

Merged
rawphp merged 21 commits into
mainfrom
fix/skill-root-lib-paths
Aug 1, 2026
Merged

fix(agents): resolve lib scripts via {skill-root}/lib#4
rawphp merged 21 commits into
mainfrom
fix/skill-root-lib-paths

Conversation

@rawphp

@rawphp rawphp commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Summary

  • Point agent runtime bash lib/*.sh invocations at {skill-root}/lib/ so scripts resolve from the skill install path, not the consumer project CWD.
  • Covers status, capture, retro, and upgrade; adds a skill-root note to help for optional lib helpers.
  • Found via the self-improving champion loop (holdout gate on bare lib path generalization).

Test plan

  • From a consumer project with no local lib/, run /do-work status and confirm synth-status / derive-status / coverage-rollup / deadlock-check resolve.
  • Run /do-work capture path that hits cycle-check and confirm {skill-root}/lib/cycle-check.sh is used.
  • Run /do-work retro and confirm retro-rollup path.
  • Run /do-work upgrade detectors that shell out to conformance-scan / install-hooks.
  • Bare /do-work help still caps at 4 suggestions and documents skill-root for lib helpers.

rawphp added 21 commits August 1, 2026 18:31
Consumer projects have no local lib/; bare bash lib/*.sh fails when
agents run from project CWD. Point status, capture, retro, and upgrade
invocations at {skill-root}/lib, and document the same contract in help.
Issue: ORI-238
UR: UR-003
Output: agents/config.md
Issue: ORI-239
UR: UR-003
Output: agents/run-worker.md
Issue: ORI-240
UR: UR-003
Output: agents/capture.md

Undo mechanical {skill-root} over-application: Files/footprint stay
project-relative lib/; upgrade identity prose uses lib/; missing-script
checks name resolved $SKILL_ROOT/lib/...; bash invoke keeps {skill-root}.

Co-authored-by: Tom Kaczocha <tomkaczocha@gmail.com>
Signed-off-by: Tom Kaczocha <tomkaczocha@gmail.com>
Issue: ORI-241
UR: UR-003
Output: references/run-loop.md
Issue: ORI-240
UR: UR-003
Issue: ORI-241
UR: UR-003
Issue: ORI-242
UR: UR-003
Output: lib/doc-lint.sh
Issue: ORI-237
UR: UR-003
Output: (verification-only; terminal state already on fix/skill-root-lib-paths)
Issue: ORI-244
UR: UR-004
Output: agents/config.md
Issue: ORI-245
UR: UR-004
Output: SKILL.md
Issue: ORI-246
UR: UR-004
Output: lib/doc-lint.sh

Extend bare-runtime-bash-lib path-scope to SKILL.md so entry
conformance cannot regress to bare bash lib/conformance-scan.sh.
Keep skill-dev allowlist under agents/ and references/ only.

Co-authored-by: Tom Kaczocha <tomkaczocha@gmail.com>
Signed-off-by: Tom Kaczocha <tomkaczocha@gmail.com>
Issue: ORI-246
UR: UR-004
Issue: ORI-243
UR: UR-004
Output: (none — path-unit verify-only)

Children ORI-244/245/246 already land walk-up resolve, SKILL.md
entry skill-root before conformance, and doc-lint SKILL.md guard.
Terminal state verified on fix/skill-root-lib-paths; zero diffs.

Co-authored-by: Tom Kaczocha <tomkaczocha@gmail.com>
Signed-off-by: Tom Kaczocha <tomkaczocha@gmail.com>
@rawphp
rawphp merged commit c0dffe4 into main Aug 1, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant