| name | cgz-workflow |
| description | Use the installed cgz CLI as a read-only development aid for code exploration, impact checks, context gathering, and affected-test selection without making moonrepo manage the codegraph repository. |
cgz Workflow
When To Use
Use this skill when a task may benefit from CodeGraph's local index:
- exploring an unfamiliar code area
- finding symbols or indexed files
- gathering compact implementation context before planning
- checking likely affected test files from changed files
- validating whether a project already has
.codegraph/
This skill treats cgz as an installed CLI. The codegraph repository is not a
moonrepo target and should not be added to repository.ini for this workflow.
Preconditions
- Run from any workspace that has access to the target project path.
cgz is installed and available on PATH.- Target projects may or may not already have
.codegraph/.
Check the command first:
command -v cgz
Read-Only Workflow
-
Check index state before relying on CodeGraph:
cgz status <path>
-
If the project is not initialized, ask before indexing or recommend the
explicit command:
cgz init -i <path>
-
Use focused read commands while planning:
cgz files --path <path>
cgz query --path <path> <symbol-or-term>
cgz context --path <path> <task>
cgz affected --path <path> <changed-files...>
-
Treat cgz output as navigation help, not final proof. Run the target
repository's normal checks and tests before claiming the task is verified.
moonrepo Helpers
moonrepo exposes thin wrappers for read-only usage:
just cgz-status <path>
just cgz-context <path> <task>
just cgz-affected <path> <files...>
These helpers never run cgz init, cgz index, or any command that creates or
updates .codegraph/.
Change Requests For cgz
Record cgz product changes in the codegraph repository's local issues/
directory. GitHub Issues are disabled for f4ah6o/codegraph, so use the local
markdown issue convention from the issues-migrate skill:
issues/YYYY-MM-DDThhmmss-spec-short-title.md
Include the reason, expected behavior, and any command examples needed to make
the request actionable.
