Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Docs: don't pass a prompt between jobs through a job output

Open Beginner friendly
#73 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
86/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github-actions, markdown
Domain
documentation

Research direction

Open CLAUDE.md and find the "Usage by Consuming Repositories" section; the whole change is a short gotcha added there. Read it alongside #70 to see how consumers pass needs.<job>.outputs into the executor, so the wording matches the existing guidance. Done when the section states both points: build the prompt in the job that calls the executor or pass it as an (encrypted) artifact, and never route untrusted multi-KB text through job outputs.

Written by the indexing model from the issue text.

Description

documentation

GitHub Actions drops any job output whose value the runner's secret masker would mask. The masker matches more than secret values: it also matches patterns such as Bearer <token-like word>. A consumer that builds prompt in an earlier job and passes it to an ai-workflows executor through needs.<job>.outputs can lose the whole prompt this way. The runner shows only a warning, the executor receives an empty string, and the run can still go green.

This is what broke dotCMS/core's autodoc. Any issue or PR text containing an example such as curl -H "Authorization: Bearer ..." tripped the masker. Job outputs are also capped at 1 MB per job.

Fix: add a short gotcha under "Usage by Consuming Repositories" in CLAUDE.md:

  • Build the prompt in the same job that calls the executor, or pass large or untrusted text as an artifact (encrypted, if the repo is public).
  • Never route untrusted, multi-KB text through job outputs.

Raised in review of #70.

Dominant language
No language data
Stars
1
Forks
0
Avg merge
16m
Merged PRs (30d)
1

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from dotCMS/ai-workflows

All issues in dotCMS/ai-workflows

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.