Goal
Make the PKGViz cyclic-dependencies audit a Devtools-managed repository standard instead of a one-off workflow owned by PKGViz.
PKGViz currently contains its own CI-only enforcement:
bun bin/pkgviz.ts --out pkgviz-audit.json --rule cyclic-dependencies=block
and a repository-local reusable .github/workflows/pkgviz-audit.yml. This duplicates repository policy that belongs in the canonical Devtools workflow synchronization.
The local PKGViz copies are being removed from artiphishle/pkgviz#225. Devtools should become the single owner before this check is rolled out again.
Requirements
- Add PKGViz cyclic-dependency auditing to the Devtools-managed
.github/workflows/ci.yml.
- Synchronize it to all applicable managed repositories, rather than adding repository-local copies.
- Run the rule in blocking mode:
cyclic-dependencies=block
- violations must fail CI.
- Produce/upload the PKGViz audit artifact when useful for diagnosis.
- Pin the PKGViz tool/version through Devtools-owned workflow policy so repositories do not need a local
pkgviz dependency merely to receive the standard check.
- Keep the implementation compatible with Devtools workflow rendering/synchronization and current Bun/Node policy.
- Determine applicability centrally. If a repository cannot meaningfully be analyzed by PKGViz, that decision must be expressed in Devtools policy rather than by hand-editing the generated workflow in that repository.
- Do not preserve PKGViz-specific workflow forks once the managed workflow is available.
- Add/extend Devtools workflow synchronization tests so the generated CI contains the audit exactly where applicable and remains deterministic.
- Update the managed-workflow ownership/documentation source as appropriate; do not hand-edit generated README artifacts.
Rollout
After release:
- Sync the managed workflow into PKGViz and the other applicable Ankhorage repositories.
- Verify that repositories no longer carry custom copies of the same PKGViz audit step/workflow.
- Fix actual dependency cycles surfaced by the centralized check in the owning repositories rather than adding suppressions.
Acceptance criteria
Skills to load
.agents/skills/ankhorage-coding-rules/SKILL.md
.agents/skills/ankhorage-project-structure/SKILL.md
.agents/skills/hexagonal-architecture/SKILL.md
Goal
Make the PKGViz
cyclic-dependenciesaudit a Devtools-managed repository standard instead of a one-off workflow owned by PKGViz.PKGViz currently contains its own CI-only enforcement:
and a repository-local reusable
.github/workflows/pkgviz-audit.yml. This duplicates repository policy that belongs in the canonical Devtools workflow synchronization.The local PKGViz copies are being removed from artiphishle/pkgviz#225. Devtools should become the single owner before this check is rolled out again.
Requirements
.github/workflows/ci.yml.cyclic-dependencies=blockpkgvizdependency merely to receive the standard check.Rollout
After release:
Acceptance criteria
cyclic-dependencies=blockin every applicable repository.Skills to load
.agents/skills/ankhorage-coding-rules/SKILL.md.agents/skills/ankhorage-project-structure/SKILL.md.agents/skills/hexagonal-architecture/SKILL.md