# G-017 Agents locate local projects via piped `projects.work` calls, not filesystem scanning

Status: proposed
Scope: AGENTS.md (root) or a child doc it indexes (guidance content only - no code)
Goal: now that G-015 (achieved 2026-07-07 - see goals/archive/G-015-script-subcommand-piped-stdin.md) makes piped script calls reliable, repository guidance directs agents asked to locate another local project to query it via a piped `projects.work` call to a punk executable instead of grepping/globbing the wider filesystem.
Acceptance: root AGENTS.md (or a child doc indexed from it) records the exact recommended invocation - executable, subcommand, glob usage, and `-return json` as the parse target with its record fields - and states when filesystem scanning remains appropriate (projects not registered in any discovery source); the guidance is added only after G-015 is achieved (satisfied - G-015 achieved 2026-07-07; the fossil-only limitation note is still required until G-016); following the documented pattern, an agent locates a named sibling project's checkout dir with a single piped call.