Skip to content

ByteTerrace/Puck / .claude/skills/tooling-files

tooling-files

Verified

Maps shared repository tooling for files, paths, Git queries, project ownership and Markdown fences. Load before adding or changing a helper in these areas.

Repository file and document helpers

Search by capability before adding a helper (AGENTS.md). These are the shared homes; callers keep only their domain-specific decisions. Build architecture, compiler identities, candidate installation and admission route to tooling.

CapabilityHome
Lexical path containment and host path comparisonPuckPaths.IsWithin, PuckPaths.Comparison in src/Puck.Abstractions/PuckPaths.cs
Inspect path components for links, below an optional root (the root itself is the caller's choice and never inspected)CliTreeFiles.LinkedAncestor in src/Puck.Cli.Core/CliTreeFiles.cs
Decide whether a directory contains a path by file identity (a "must not contain" refusal)ConfinedDirectory.Contains in src/Puck.Confinement/ConfinedDirectory.cs; PuckPaths.IsWithin fails open for aliases
Remove an owned directory tree without following descendant linksConfinedDirectory.RemoveTree in src/Puck.Confinement/ConfinedDirectory.cs
Stage, flush, publish or discard complete replacement filesAtomicFile, including PendingWrite, in src/Puck.Confinement/AtomicFile.cs
Compare files or a file and bytes with bounded memoryFileContent in src/Puck.Confinement/FileContent.cs
Read source lines or nonempty process-output linesCliText in src/Puck.Cli.Core/CliText.cs
Query Git, resolve common directories or commits, list unignored filesCliGit in src/Puck.Cli.Core/CliGit.cs; local reports use ReadOnlyAsync
Parse NUL-delimited worktree recordsCliWorktree.Parse in src/Puck.Cli.Core/CliWorktree.cs
Find an owning project within an optional boundaryCliProjects.FindOwningProject in src/Puck.Cli.Core/CliProjects.cs
Read C# type declarations for project selectionDeclarationsCommand.ReadTypes in src/Puck.Cli.Source/Analysis/DeclarationsCommand.cs
Track Markdown code fences in link and quotation scansMarkdownFence in src/Puck.Cli.Source/Docs/MarkdownFence.cs
Collect non-XML C# comments and emit line sitesInlineComments.CollectComments and ScanSites in src/Puck.Cli.Source/Scan/
Match compiler paths against analyzer allowlist identitiesAnalyzerAllowlistPath in src/Puck.Analyzers/AnalyzerAllowlistPath.cs

Lexical containment and ancestor inspection do not establish confinement against concurrent path replacement. Deletion stays beneath the directory handle opened by ConfinedDirectory.RemoveTree; its internal traversal refuses descendant links. The caller owns the selected root, whose ancestors are resolved by the OS.

Batch writers own pending writes until each is committed or disposed. PendingWrite.Commit(overwrite: false) preserves a concurrent winner; replacing that with an existence check followed by an overwriting write does not. Run verification's focused builds and laws for the changed boundary. Deletion and persisted-data rewrites need the hazards review.

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall