Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion docs/agentic-dev-kit/workflows/session-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -167,7 +167,22 @@ something already classified 🟡 is later raised to 🔴, it gets the check the

Search them **per candidate**, by job / ticket / subject name, using **your
runtime's own file-search facility** — the subject passed as a *parameter*, the
two archives as the scope.
two archives as the scope. A parameter is never parsed as shell syntax, which is
what makes this the preferred route.

**If your runtime exposes no such tool, the deciding question is where the
subject came from**, not whether you are using a shell:

- **From your own repository or config** — a cron job name, a branch, a file
path, a scope. Operator-controlled, and an ordinary shell search is fine.
- **From your tracker or forge** — an issue title, a PR title. On any project
that accepts issues from outside, that is attacker-influenceable text, and
building a shell command around it is a problem three separate attempts here
failed to solve; see
[`#241`](https://github.com/topij/agentic-dev-kit/issues/241) before trying a
fourth. Prefer matching such a candidate by its **id** (`CUS-1107`, `#143`),
which is the part you control the shape of, and search the title only through
a parameter-passing tool.

**Skip a candidate whose subject is empty or whitespace-only** rather than
searching for it. An empty pattern matches every line of both archives, which is
Expand Down
2 changes: 1 addition & 1 deletion kit-manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@
},
"docs/agentic-dev-kit/workflows/session-start.md": {
"role": "workflow",
"sha256": "00cae6afe47b6817f92d012c6dcac4447a3e7114d403e7fae03891c35a01d3d6"
"sha256": "535a391e491d5371ba1b4930d75323a6ec9b46a636d0b89b59d239934e7aaf2c"
},
"docs/agentic-dev-kit/workflows/wrap-up.md": {
"role": "workflow",
Expand Down
Loading